将知识源添加到声明性智能体

提示

受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。

您可以通过添加代码解释器和图像生成器以及知识源等功能来增强和自定义代理的知识,从而增强声明式代理的用户体验。 清单引用中的功能对象和智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的“知识”部分提供了多个选项,用于为用户解锁功能。 本文介绍了可以添加到代理的知识源。

下表列出了可以使用智能 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 或 Microsoft 365 智能体工具包中的智能体生成器配置的功能和知识源,并指出用户是否需要 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证或按流量计费才能访问具有该功能或知识源的代理。

下表介绍代理生成器和工具包配置路径,而非 WIQD 功能范围。 对于建议的专业代码路由,请确认 WIQD 文档中支持的配置。

能力或知识源 代理生成器 代理工具包 需要许可证或按流量计费?
代码解释器 ✅ ✅ 否
映像生成器 ✅ ✅ 否
Copilot 连接器 ✅ ✅ 是
SharePoint ✅ ✅ 是
OneDrive ✅ ✅ 是
嵌入的文件内容 ✅ ❌ 是
Web 搜索 ✅ ✅ 否
特定范围的 Web 搜索 ✅ ✅ 否
Dataverse ✅ ✅* 支持
电子邮件 ✅ ✅* 是,仅 (许可证)
人脉 ✅ ✅ 是,仅 (许可证)
OneNote 页面 ✅ ❌ 否
Teams 消息 ✅ ✅* 是,仅 (许可证)
Teams 会议 ✅ ✅ 是,仅 (许可证)

* 提供知识范围的选项。

Copilot 连接器

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 连接器使你能够将组织数据作为基础信息添加到代理。 使用 Copilot 连接器将业务线数据引入 Microsoft Graph,以便 Copilot 可以将数据推理为响应用户提示的基础信息。 有关详细信息,请参阅 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®连接器概述。

有关如何将 Copilot 连接器作为知识添加到代理工具包中的代理清单的信息,请参阅 Copilot 连接器对象。

有关如何在代理生成器中将 Copilot 连接器添加到代理的信息,请参阅 Copilot 连接器。

SharePoint 和 OneDrive

将代理配置为使用 SharePoint 和 OneDrive 内容作为知识时,Copilot 会搜索用户有权访问的 SharePoint 和 OneDrive 文件、文件夹或网站以获取基础信息。

有关如何将 SharePoint 和 OneDrive 知识添加到 Agents Toolkit 中的智能体清单的信息,请参阅 OneDrive 和 SharePoint 对象。

有关如何在智能体生成器中将 SharePoint 和 OneDrive 知识添加到智能体,以及每个智能体限制以及如何处理权限和敏感度标签的信息,请参阅 SharePoint 和 OneDrive 内容。

注意

SharePoint 和 OneDrive 知识源要求登录用户具有有效的 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证。 如果用户没有许可证,请求将失败,并显示消息 “抱歉,我无法响应”。

客户数字体验 (CDX) 没有 Copilot 许可证的租户帐户可以发布代理,但无法执行基于 SharePoint 的检索。 使用 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 开发人员许可证在非生产环境中测试方案。

Web 搜索使代理能够使用必应中的搜索索引来响应用户提示。 如果您在代理中启用 Web 搜索,则代理可以在其响应中返回任何 Web 数据。 还可以将 Web 搜索范围限定到最多四个公共网站。

重要

组织管理员可以禁用 Copilot 及其组织内所有代理的 Web 搜索。 如果管理员禁用 Web 搜索,启用了 Web 搜索的代理不会报告错误,也不会将 Web 搜索包含在其知识中。 开发人员模式调试卡 指示如果代理启用了 Web 搜索,即使管理员禁用了该搜索,它也会启用。 有关详细信息,请参阅 Microsoft 365 管理中心中的管理 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®方案。

如果使用 Agents Toolkit 和 Visual Studio Code 创建代理,请将值添加到WebSearch清单文件中的 capabilities 属性以启用 Web 搜索。 若要将 Web 搜索范围限定为特定网站,请添加 sites 属性并指定最多四个 URL,如下例所示。

注意

若要将范围的 Web 搜索添加到代理,请使用 1.3 或更高版本 的声明式代理清单架构。

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "cnn.com"
        }
      ]
    }
  ]
}

如果使用 代理生成器 创建代理,请在 “配置 ”选项卡的“ 知识”下,列出要引用的网站 URL。

Web 搜索基础和动态内容

当声明性代理的清单将 Web 搜索范围限定到特定网站 URL 时,代理会根据必应为这些网站编制索引的内容而不是直接访问基础数据源做出响应。

范围的 Web 搜索依赖于必应为已配置网站编制索引的内容。 因此,依赖于客户端呈现或动态生成数据的内容可能无法在搜索结果中完全表示。 在某些情况下,相对于实时站点上显示的内容,动态加载的内容可能丢失或过期。

此行为可能会产生不一致的结果。 网站上显示的内容可能与代理可用的内容不同,并且代理可能无法从动态生成或频繁更新的列表中可靠地返回最新项。

在当前声明式代理体系结构中,会出现此行为。 声明性代理不适用于动态生成或非 OpenAPI Web 源,这些方案可能导致不完整或不一致的基础设置结果。

若要直接访问结构化且频繁更改的内容,请使用 OpenAPI 规范支持的 API 插件,而不是范围的 Web 搜索。 API 插件允许代理直接查询基础数据源,并使用 API 参数(如排序和结果限制),而不是依赖于索引的 Web 内容。 或者,将内容迁移到受支持的基于 OpenAPI 或静态知识源。 有关这些方法的指导,请参阅:

嵌入的文件内容

如果您使用 Agent Builder 构建代理,则可以直接从设备或云上传文件,以嵌入内容,供代理用作知识。 嵌入的文件内容存储在 SharePoint Embedded 中。 这些文件将计入租户中的 OneDrive 和 SharePoint 容量。

注意

  • 启用了使用情况计费或拥有智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证的用户可以使用文件上传功能。
  • Microsoft 365 政府社区云 (GCC) 环境中不支持嵌入文件内容。

有关嵌入文件的详细信息,请参阅 嵌入文件内容。

重要

Microsoft Purview 信息屏障 ( 嵌入式文件不支持 IB) 。 任何可以访问代理的用户都可以看到基于嵌入式文件内容的响应。

Dataverse

Dataverse 知识允许代理以自然语言响应用户有关其 CRM 数据或 Microsoft Dataverse 表中数据的查询。 您可以将 Dataverse 实例添加为知识源,并添加同义词和词汇表,以帮助系统更好地解释表中的自定义数据。 有关详细信息,请参阅 添加 Dataverse 知识源。

添加 Dataverse 知识

如果使用代理生成器生成代理,请在“知识”部分的“配置”选项卡上选择“Dynamics 365 和 Power Apps”。 选择 + 以找到要包含的应用并选择该应用,或保留原样以在所有应用中搜索。 你可以通过 Work IQ 中的业务应用程序访问代理生成器中的 Dataverse 知识,管理员必须首先 启用此功能。

如果使用代理工具包和 Visual Studio Code 创建代理,请将值capabilities添加到Dataverse代理清单文件中的属性以启用 Dataverse 知识,如以下示例所示。

注意

若要添加 Dataverse 知识,请使用 1.3 或更高版本 的声明式代理清单架构。

{
  "capabilities": [
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "YourOrgID.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    }
  ]
}

在添加此技能之前,请确保 skill 功能数组中的值存在于 Dataverse 环境中。 此外,请确保该 host_name 值与组织 ID 匹配。

提取预先存在的技能值或创建新技能值

若要提取或创建 Dataverse skill 值,请执行以下操作:

  1. 从 Power Apps 制作者门户>>获取组织 ID 设置开发人员资源。

  2. 获取持有者令牌以对 Dataverse 资源 进行身份验证 和创建。 若要获取持有者令牌,请在 Azure 门户中创建新的应用注册,然后运行以下 curl 请求。

    curl -X POST https://login.microsoftonline.com/<tenant_ID>/oauth2/v2.0/token \
      -H "Content-Type: application/x-www-form-urlencoded" \
      -d "client_id=<client_ID>" \
      -d "scope=https://YourOrgID.crm.dynamics.com/.default" \
      -d "client_secret=<client_secret>" \
      -d "grant_type=client_credentials"
    
  3. 使用以下 curl 请求确定值是否 skill 已存在。 如果值已存在,则 skill 响应将包含 Dataverse 环境中现有 DVTableSearch 技能的列表。

    AUTH="Bearer {TOKEN}"
    ORG="https://YourOrgID.crm.dynamics.com"
    API="$ORG/api/data/v9.1"
    
    curl -s -X GET "$API/dvtablesearchs?\$select=dvtablesearchid,name,searchtype" \
    -H "Authorization: $AUTH" \
    -H "Accept: application/json"
    

    响应

    {
     "@odata.context": "https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,se…),
     "value": [
       {
         "@odata.etag": "W/\"4277...\"",
         "dvtablesearchid": "15369...",
         "name": "User_Account_jSd6V...",
         "searchtype": 0
       }
    ]
    }
    

    如果某个值已存在,请 skill 在代理清单文件中使用该值。 如果该 skill 值不存在,则响应包含一个空数组。

    响应

    {
      "@odata.context":"https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,searchtype)",
      "value":[]
    }
    
  4. 如果不 skill 存在,请创建 DVTableSearch 技能并使用您分配给它的名称。

    请求

    AUTH="Bearer {TOKEN}"
    ORG="https://YourOrgID.crm.dynamics.com"
    API="$ORG/api/data/v9.1"
    
    curl -i -X POST "$API/dvtablesearchs" \
    -H "Authorization: $AUTH" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Account_SystemUser_Skill",
      "searchtype": 0,
      "DVTableSearch_DVTableSearch_DVTableSearch": [
        {
          "name": "Account",
          "entitylogicalname": "account"
        }
      ]
    }'
    

    响应

    该请求返回 204 无内容 ,指示 DVTableSearch 已成功创建技能。

    HTTP/1.1 204 No Content
    
  5. 再次运行步骤 3 中的 curl 请求以检查现有DVTableSearch技能。 响应包含 dvtablesearchid 新创建 skill的 . 您可以使用此值或 name 代理清单文件属性中的 skill 值。

电子邮件

Email knowledge 允许您将代理范围限定为个人或共享邮箱,以及可选的特定邮箱文件夹。

添加电子邮件知识源

如果使用代理生成器创建代理,请在“知识”部分的“配置”选项卡上,选择“我的电子邮件”。

注意

使用代理生成器时,当前无法将电子邮件范围限定到特定文件夹或共享邮箱。

如果使用代理工具包和 Visual Studio Code 创建代理,若要添加电子邮件知识,请将值Email添加到代理清单文件中的功能属性,如以下示例所示。 可以引用多个邮箱文件夹和一个共享文件夹。

注意

必须使用 1.3 或更高版本 的声明式代理清单架构来添加 Email 知识。

{
  "capabilities": [
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
  ]
}

在 “folder_id ”字段中,可以引用熟知的文件夹名称或文件夹 ID。 有关已知文件夹名称的列表,请参阅 mailFolder 资源类型。 若要获取文件夹 ID 列表,请在 Graph 浏览器中使用以下查询:

https://graph.microsoft.com/v1.0/me/mailFolders

在“ shared_mailbox ”字段中,使用共享邮箱的 SMTP 地址。

在 group_mailboxes 字段中,指定最多 array 25 个) (字符串,其中包含希望代理限定到的共享邮箱或 Microsoft 365 组的 SMTP 地址。

如果同时引用共享邮箱和文件夹,代理会将响应范围限定到共享邮箱中的文件夹。 如果仅引用文件夹,代理会将响应范围限定到个人邮箱中文件夹的内容。

如果不引用共享邮箱或文件夹,则代理搜索不会局限于任何文件夹或邮箱,并且会根据用户的查询返回所有电子邮件内容的结果。

人脉

让您的代理了解 People 数据,以提供更加个性化和上下文感知的响应。 People Data 将有关个人的公共信息(例如姓名、职位、技能和组织关系)与用户连接、协作者和相关见解的个人视图相结合。 此知识源使代理能够:

  • 查找用户和同事的资料,包括报告结构和联系方式。
  • 确定组织内的领域专家和关键合作者。
  • 根据用户的关系、过去的互动和偏好个性化响应。
  • 提供针对特定团队或个人的建议和沟通技巧。

添加人员知识源

如果使用 Copilot Studio 创建代理,则默认情况下会为拥有 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证的用户启用 People 知识源。

如果使用代理工具包和 Visual Studio Code 创建代理,请将值添加到People代理清单文件中的功能属性以启用人员知识,如以下示例所示。 仅声明基本People功能允许代理仅根据基本组织数据(例如个人资料卡中可用的数据)进行推理。 若要包括代理用户与组织中被引用人员之间的相关团队消息、电子邮件和文件等内容,请参阅版本 1.6 以使用该 include_related_content 属性。

注意

若要添加知识源 (People 而不) 相关内容,请使用 1.3 或更高版本 的声明式代理清单架构。 若要使用该 include_related_content 属性,请使用 1.6 或更高版本 。

{
  "capabilities": [
    {
      "name":"People"
    }
  ]
}

如果您的代理需要对代理用户和引用的人员) 之间的相关内容 ((例如相关 Teams 消息、电子邮件和文件)进行推理,请利用该 include_related_content 属性。 默认值为 false。

{
  "capabilities": [
    {
      "name":"People",
      "include_related_content": true
    }
  ]
}

OneNote 页面

使用 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 生成代理时,可以从文件选取器中选择特定的 OneNote 页面以作为知识上传。 只能选择单个 OneNote 页面。 选择整个 OneNote 笔记本的选项不可用。

使用文件选取器添加 OneNote 页面。 代理生成器不支持输入 OneNote 页面 URL。

Teams 消息

可以将代理配置为使用 Teams 频道、会议聊天、群组聊天和 1:1 聊天作为知识源。 可以选择指定最多五个指向频道、群组、一对一或会议聊天的链接,以限定 Copilot 搜索范围,也可以允许代理使用用户的 Teams 内容(包括频道、会议以及个人和群组聊天)作为知识源。

代理可以返回指向在 Teams 消息中共享的文件的链接,但无法返回指向存储在 Teams 频道中的文件的链接,除非代理也 OneDriveAndSharePoint 已启用。 有关如何优化 Copilot 的 SharePoint 内容的信息,请参阅 优化内容检索。

添加 Teams 消息知识源

如果使用 智能体生成器 创建智能体,请在 “配置 ”选项卡的 “知识 ”部分中,选择搜索栏,然后选择“ 我的 Teams 聊天和会议”。 要将代理范围限定为特定频道、会议或群组聊天,请在 聊天 选项卡上,选择要添加为知识的聊天。

如果使用代理工具包和 Visual Studio Code 创建代理,若要启用 Teams 消息知识,请将值TeamsMessage添加到清单引用中的功能属性。 如果你想要将 Teams 知识范围扩大到最多五个 Teams 资源,请添加指向 urls 属性的链接,如以下示例所示。

注意

必须使用 版本 1.3 或更高版本的声明式代理清单架构来添加 TeamsMessage 知识源。

{
  "capabilities": [
    {
      "name": "TeamsMessages",
      "urls": []
    }
  ]
}

获取频道或会议的 URL

若要获取 Teams 频道的 URL,请选择频道名称旁边的三个点 (...) ,然后选择“ 获取频道链接”。

若要获取 Teams 会议的 URL,请打开会议,选择“ 加入”旁边的箭头,然后选择“ 复制加入链接”。

获取群组或一对一聊天的 URL

若要获取群组聊天或一对一聊天的 URL,需要包含 chatId 的深层链接。 深层链接具有以下格式: https://teams.microsoft.com/l/chat/<chatId>/conversations。 每个聊天的 chatId 值不同。

若要获取群组或一对一聊天的 chatId 值:

  1. 在 Microsoft Teams 中,转到聊天中的任何消息。
  2. 将鼠标悬停在邮件上,然后选择三个点 (...) 。
  3. 选择 “复制链接”。
  4. 将链接粘贴到记事本或类似应用程序中。 该链接类似于以下 URL: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D。
  5. 复制介于 URL chat/ 和下一个 /. 该片段通常以 19:开头。 这是 chatId。 在前面的示例中, chatId 是 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces。
  6. 将 chatId 添加到深层链接。 例如: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations。

有关详细信息,请参阅 Teams 聊天的深层链接。

Teams 会议

通过使用 Teams 会议知识,可以将代理范围限定为回答有关会议的问题,包括单个会议或会议系列。 例如,代理可以响应诸如“回顾昨天的会议并列出拟办事项”或“我的会议中关于项目 X 的言论?”之类的查询。 可以选择将此知识源的范围限定到最多五个特定会议。 此知识源使代理能够访问主题、组织者、与会者和标题) 、脚本内容和会议聊天 (会议元数据。

注意

引用会议系列仅限于该系列的最后四个实例。

添加会议知识源

如果使用 智能体生成器 创建智能体,请在 “配置 ”选项卡的 “知识 ”部分中,选择搜索栏,然后选择“ 我的 Teams 聊天和会议”。 智能体生成器即将推出将范围限定到会议的功能。

如果使用代理工具包和 Visual Studio Code 创建代理,若要启用会议知识,请将值Meetings添加到代理清单文件中的功能属性,如以下示例所示。 如果要将代理范围限定为特定会议,请将会议的 UID 添加到 items_by_id 属性。 有关查找会议 ID 的说明,请参阅 获取会议 ID。

注意

必须使用 版本 1.6 或更高版本的声明式代理清单架构来添加 Meetings 知识源。

{
  "capabilities": [
    {
      "name":"Meetings",
      "items_by_id": [
        {
          "id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
          "is_series": true
        }
      ]
    }
  ]
}