将知识源添加到使用 Microsoft 365 Agents Toolkit 创建的声明式代理

提示

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

可以控制代理可用的知识,以便使用 Web 和 Microsoft 365 组织数据中的知识源生成响应。 有关可用知识源的完整列表,请参阅 将知识源添加到声明式代理。

重要

本指南假定你已完成使用 Microsoft 365 代理工具包和 JSON 创建声明性代理 教程。

向代理添加 Web 搜索

向代理添加 Web 搜索允许其搜索 Web 以生成答案。 可以选择将知识范围限定到特定网站。

  1. 打开该 appPackage/declarativeAgent.json 文件并添加 capabilities 包含以下内容的数组。

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

    有关详细信息,请参阅 Web 搜索对象。

  2. 在 Microsoft 365 代理工具包的生命周期窗格中选择“预配”。

声明性代理有权访问 Web 内容,以便在您重新加载页面后生成其答案。

显示来自包含 Web 内容的声明性代理的响应的屏幕截图

将 SharePoint 网站添加到代理

可以将 OneDrive 中的文件或 SharePoint 网站的内容添加为知识源。

  1. 打开该 appPackage/declarativeAgent.json 文件,将以下值添加到数组中 capabilities ,替换 https://contoso.sharepoint.com/sites/ProductSupport 为 Microsoft 365 组织中的 SharePoint 网站 URL。

    {
      "name": "OneDriveAndSharePoint",
      "items_by_url": [
        {
          "url": "https://contoso.sharepoint.com/sites/ProductSupport"
        }
      ]
    }
    

    有关详细信息,请参阅 OneDrive 和 SharePoint 对象。

    注意

    • URL 应该是网站、文档库、文件夹或文件) (SharePoint 项目的完整路径。 你可以使用 SharePoint 中的“复制直接链接”选项获取完整路径或文件和文件夹。 右键单击文件或文件夹 ,然后选择详细信息。 导航到 “路径” 并选择“复制”图标。
    • 如果未指定 items_by_url 数组 (或备用 items_by_sharepoint_ids 数组) ,则 Microsoft 365 组织中可供登录用户使用的所有 OneDrive 和 SharePoint 内容可供代理使用。
  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

声明性代理有权访问 OneDrive 和 SharePoint 内容,以便在你重新加载页面后生成其答案。

显示包含 SharePoint 和 OneDrive 内容的声明性代理的响应的屏幕截图

将 Teams 消息添加到代理

  1. 打开该 appPackage/declarativeAgent.json 文件,将以下值添加到数组中 capabilities ,替换 https://teams.microsoft.com/l/team/... 为组织中的 Teams 频道或团队 URL。

    {
      "name": "TeamsMessages",
      "urls": [
        {
          "url": "https://teams.microsoft.com/l/team/..."
        }
      ]
    }
    

    有关详细信息,请参阅 Microsoft Teams 消息对象。

    注意

    • 属性中的 url URL 必须是指向 Teams 聊天、团队或会议聊天的格式正确的链接。
    • 如果未指定数组, urls 则 Microsoft 365 组织中可供登录用户使用的所有 Teams 频道、团队、会议、一对一聊天和群组聊天可供代理使用。
  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

声明性代理有权访问 Teams 数据,以便在你重新加载页面后生成其答案。

显示来自包含 Teams 内容的声明式代理的响应的屏幕截图

向代理添加人员知识

人员知识源允许您将代理范围限定为回答有关组织中个人的问题。

  1. 打开文件 appPackage/declarativeAgent.json 并将条 People 目添加到数组中 capabilities 。

    {
      "name": "People"
    }
    

    有关详细信息,请参阅 People 对象。

  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

声明式代理可以在重新加载页面后访问人员知识。

显示来自包含人员知识的声明性代理的响应的屏幕截图

将电子邮件添加到代理

通过电子邮件知识源,可以将代理范围限定为使用来自用户邮箱或共享邮箱的电子邮件来回答查询。

  1. 打开文件 appPackage/declarativeAgent.json 并将条 Email 目添加到数组中 capabilities 。

    {
      "name": "Email",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
    

    有关详细信息,请参阅 Email 对象。

    注意

    • 此示例访问代理邮箱的用户。 若要改为访问共享邮箱,请将可选 shared_mailbox 属性集添加到共享邮箱的电子邮件地址。
    • 数组限制 folders 对特定文件夹的邮箱访问权限。 要访问整个邮箱,请省略 folders 数组。
  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

声明性代理有权在您重新加载页面后访问电子邮件知识。

显示来自包含电子邮件知识的声明性代理的响应的屏幕截图

将 Copilot 连接器添加到代理

添加 Copilot 连接器 可使代理可将该连接器引入的项用作知识源。

  1. 打开该 appPackage/declarativeAgent.json 文件并将以下值添加到数组中 capabilities ,替换 policieslocal 为 Microsoft 365 组织中的有效 Copilot 连接器 ID。 有关如何查找 Copilot 连接器 ID 的详细信息,请参阅 检索声明性代理清单的功能 ID。

    {
      "name": "GraphConnectors",
      "connections": [
        {
          "connection_id": "policieslocal"
        }
      ]
    }
    

    有关详细信息,请参阅 Copilot 连接器对象。

    注意

    • 未指定 connections 数组会导致 Microsoft 365 组织中可供登录用户使用的所有 Copilot 连接器内容可供代理使用。
  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

声明性代理有权访问 Copilot 连接器内容,以便在重新加载页面后生成其答案。

屏幕截图显示了包含 Copilot 连接器内容的声明性代理的响应

后续步骤