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

2025-06-15

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

重要

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

向代理添加 Web 搜索

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

打开文件并 appPackage/declarativeAgent.json 添加 capabilities 包含以下内容的数组。
```
"capabilities": [
  {
    "name": "WebSearch"
  }
]
```
有关详细信息，请参阅 Web 搜索对象。
在 Teams 工具包的“生命周期”窗格中选择“预配”。

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

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

将 SharePoint 网站添加到代理

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

打开文件并将 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 内容可供代理使用。
在 Teams 工具包的“生命周期”窗格中选择“预配”。

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

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

将 Teams 消息添加到代理

打开文件并将 appPackage/declarativeAgent.json 以下值添加到数组， capabilities 将 https://teams.microsoft.com/l/team/... 替换为组织的 Teams 频道或团队 URL。
```
{
  "name": "TeamsMessages",
  "urls": [
    {
      "url": "https://teams.microsoft.com/l/team/..."
    }
  ]
}
```
有关详细信息，请参阅 Teams 消息对象。
注意
- url 对象中的 URL 必须是指向 Teams 聊天、团队或会议聊天的链接。
- 如果不指定 urls 数组，则会导致 Microsoft 365 组织中可供登录用户使用的所有 Teams 频道、团队、会议、1：1 聊天和群组聊天可供代理使用。
在 Teams 工具包的“生命周期”窗格中选择“预配”。

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

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

将人员知识添加到代理

借助人员知识源，你可以将代理的范围限定为回答有关组织中个人的问题。

打开文件，appPackage/declarativeAgent.json并将 People 条目添加到数组。capabilities
```
{
  "name": "People"
}
```
有关详细信息，请参阅人员对象。
在 Teams 工具包的“生命周期”窗格中选择“预配”。

重新加载页面后，声明性代理将有权访问人员知识。

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

向代理添加电子邮件

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

打开文件，appPackage/declarativeAgent.json并将 Email 条目添加到数组。capabilities
```
{
  "name": "Email",
  "folders": [
    {
      "folder_id": "inbox"
    }
  ]
}
```
有关详细信息，请参阅 Email 对象。
注意
- 此示例访问代理邮箱的用户。若要改为访问共享邮箱，请将可选 shared_mailbox 属性设置为共享邮箱的电子邮件地址。
- 数组 folders 限制邮箱对特定文件夹的访问。若要访问整个邮箱，请省略 folders 数组。
在 Teams 工具包的“生命周期”窗格中选择“预配”。

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

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

将智能 Microsoft 365 Copilot 副驾驶®连接器添加到代理

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

appPackage/declarativeAgent.json打开文件并将以下值添加到capabilities数组，并将 policieslocal 替换为 Microsoft 365 组织中的有效 Copilot 连接器 ID。有关如何查找 Copilot 连接器 ID 的详细信息，请参阅检索声明性代理清单的功能 ID。
```
{
  "name": "GraphConnectors",
  "connections": [
    {
      "connection_id": "policieslocal"
    }
  ]
}
```
有关详细信息，请参阅 Copilot 连接器对象。
注意
- 不指定 connections 数组会导致 Microsoft 365 组织中可供登录用户使用的所有 Copilot 连接器内容可供代理使用。
在代理工具包的“生命周期”窗格中选择“预配”。

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

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

后续步骤