Agent Builder 为您提供了一个简单的界面来集成知识源,使您的声明式智能体更加智能和上下文感知。 这些知识来源使您的代理了解企业数据、公共内容和用户特定信息,使其能够提供更准确、更相关和个性化的响应。
智能体生成器支持公共网站、SharePoint 和 OneDrive 内容、Teams 聊天和会议、Outlook 电子邮件、嵌入式文件和 智能 Microsoft 365 Copilot 副驾驶® 连接器。 限制因源类型而异。
| 知识源 | 每个代理的限制 |
|---|---|
| 公共网站 URL | 四个 URL |
| SharePoint 文件、文件夹或网站 | 100 个文件 |
| SharePoint 列表 | 一个列表 |
| OneDrive 文件 | 50 个文件 |
| Teams 聊天和会议 | 五次聊天和五次会议 |
| 从设备上传的嵌入式文件 | 20 个文件 |
| 智能 Microsoft 365 Copilot 副驾驶® 连接器 | 无记录的数值限制。 组织的管理员必须启用连接器。 |
| Dynamics 365 和 Power Apps 数据 | 无记录的数值限制。 您组织的管理员必须 在 Work IQ 中启用业务应用程序。 |
本文介绍受支持的知识源及其配置步骤。 有关生成代理的常规信息,请参阅 在代理生成器中生成代理。
有关受支持的知识源的更广泛列表,请参阅将 知识源添加到声明式智能体。 知识来源和功能因许可证而异;有关详细信息,请参阅 智能 Microsoft 365 Copilot 副驾驶® 许可 和代理 功能和许可模型。
添加知识源
如果您使用自然语言创建代理,代理生成器会根据您的描述为您添加知识源。 还可以从 “描述 ”选项卡上的聊天框添加知识源:
在 智能 Microsoft 365 Copilot 副驾驶® 中,选择左窗格中的“ 新建代理 ”,然后在 “描述” 选项卡上为代理提供自然语言描述。
在聊天框中选择加号图标 (+) 。 使用以下方法之一添加知识源:
- 添加工作内容 - 选择、搜索或上传文件。
- 上传图像和文件 - 直接从设备上传。
- 附加云文件 - 附加你有权访问的云文件。
如果要手动配置代理,若要向代理添加知识源,请执行以下操作:
在 智能 Microsoft 365 Copilot 副驾驶® 中,从左侧窗格中选择 “新建代理 ”,然后选择 “跳过”进行配置。
在 “知识 ”部分,使用以下方法之一添加知识源:
- 搜索 - 键入关键字以搜索项目。 使用此选项可添加电子邮件和 Teams 消息等来源。
-
输入 URL - 添加公共网站、包含网站路径的 SharePoint 链接 (例如,
.../sites/<site-name>/...) 但不包含查询参数,或 OneDrive 共享链接。 - 浏览 - 使用 附加云文件 选取器浏览和选择 SharePoint 或 OneDrive 文件、文件夹或列表。
- 上传 - 直接从设备上传文件。
验证知识源
添加知识源后,请验证它们是否显示在“配置”选项卡的“知识”部分中。然后,在 Try it 选项卡上,提出一个答案在其中一个来源中可用的问题,并确认响应使用了预期的信息。
新上传的 SharePoint 和 OneDrive 内容可能会显示 “正在准备” 状态。 可以在源准备时测试代理,但在源准备就绪之前,代理不会在其响应中使用该源。
公共网站
将特定的公共网站添加为代理知识源,以使您的代理了解上下文。 将网站作为知识源引用时,具有以下限制:
- 公共网站 URL 只能是两个级别。 例如,是无效 URL,
https://example.org/a/b/c因为它超过两个级别。 - URL 不能包含查询参数。 例如,
https://example.org?test=1无效。 - 最多可以添加四个 URL。
若要将代理配置为使用任何 Web 数据作为知识,请执行以下操作:
- 使用自然语言要求 Agent Builder 确定知识来源的优先级。
- 在 “配置 ”选项卡的 “知识”下,选择 “搜索所有网站”旁边的开关。
SharePoint 和 OneDrive 内容
将特定文件、文件夹、列表和站点作为代理知识源进行引用。 从 SharePoint 或 OneDrive 引用源时,请考虑以下限制:
| 限制或行为 | 主体 |
|---|---|
| SharePoint 文件 | 为每个代理选择最多 100 个 SharePoint 文件。 |
| SharePoint 列表 | 为每个代理选择最多 1 个 SharePoint 列表。 |
| OneDrive 文件 | 为每个代理选择最多 50 个 OneDrive 文件。 |
| 权限和敏感度标签 | 代理遵守已上传到 SharePoint 或 OneDrive 的文件的现有权限和 敏感度标签 。 |
| 文件大小 | 尽管您选择的知识文件没有直接的文件大小限制,但代理只能对特定的 文件类型进行推理。 |
引用 SharePoint 列表时,以下限制适用:
- 一个列表最多可包含 20,000 个项目 (行) 以及 50 MB 的原始文本。 如果您的列表超过任一限制,代理将截断它并在其响应中记录截断。
- “ 附件” 列 (列出未编制索引或未用于基础设置的附件) ;座席不会根据附件内容进行回答。
- 选择 SharePoint 网站不包括其列表。 若要将列表用作知识,请选择特定列表。
注意
- 如果启用 了受限 SharePoint 搜索 ,则无法将 SharePoint 用作知识源。
- 当数据位于工作簿中的一个工作表中时,代理对基于 Excel 中数据的查询的响应效果最佳。
- 若要针对 Copilot 进行优化,请保持所提供文件的内容简洁。 有关详细信息,请参阅 提供给 Copilot 的文档长度。
输入文件、文件夹、列表或网站的 URL
输入 SharePoint 网站、文件夹或文件的 URL,例如 contoso.sharepoint.com/sites/policies。 代理搜索 URL 和子路径。 例如,URL (如) 还 contoso.sharepoint.com/sites 包括子路径(如 contoso.sharepoint.com/sites/policies)。 代理使用相关信息提供有针对性的响应。
还可以按 URL 添加 SharePoint 列表。 在列表中,选择 “共享” 或 “复制链接 ”以获取链接,然后粘贴列表 URL (,不带查询参数) 。 使用指向特定列表的直接链接,而不是筛选或分组视图。 SharePoint 网站 URL 不包括该网站中的列表,因此请输入列表自己的 URL。
对于 OneDrive,请输入指向文件或文件夹的可共享链接 (例如,从浏览器或共享选项) 复制的 URL,而不是本地或相对路径 (C:\Users\YourName\Documents\File.xlsx 例如) 。
提供 URL 后,按 Enter 将其添加为知识源。
浏览以选择文件、文件夹、列表或网站
选择“知识”部分中的附加云文件云图标以打开文件选取器。 选取器显示最近访问的 SharePoint 和 OneDrive 网站。 若要查看更多 SharePoint 网站,请选择左窗格底部的 “更多位置 ”。 如果你最近创建了一个网站,它将在几分钟后显示。
若要浏览 SharePoint 列表,请在选取器的左窗格中选择“ 最近使用的列表 ”,然后选择要添加的列表。
注意
SharePoint 选取器可能不会显示你有权访问的所有 通信网站 。 通信网站仅显示在 SharePoint 选取器的“ 快速访问 ”和 “最近” 部分。
文件准备情况
将新文件上传到 SharePoint 或 OneDrive 时,代理可能需要几分钟时间才能将它们包含在其响应中。 如果源尚未准备好,您仍然可以在 “试用 ”选项卡上测试您的代理。 但是,在新上传文件准备就绪之前,响应不会包含其中的信息。
您可以在“配置”选项卡的“知识”部分检查文件准备情况;该文件旁边有“准备”一词。 重命名或删除上传到 SharePoint 或 OneDrive 的基础文件时,代理会获取更改。 还可以选择“ 知识 ”部分顶部的“刷新”按钮来手动重新加载状态。
OneNote 页面
可以从文件选取器中选择特定的 OneNote 页面以作为知识上传。 只能选择单个 OneNote 页面;选择整个 OneNote 笔记本的选项不可用。 选择 “我的 SharePoint 文件、文件夹和网站”时,将包括 OneNote 页面。
使用文件选取器添加 OneNote 页面。 代理生成器不支持输入 OneNote 页面 URL。
Microsoft Teams 数据
你可以使用 Microsoft Teams 数据(包括 Teams 聊天消息和会议信息)来管理代理。 若要将你有权访问的所有聊天消息、会议脚本和日历用作知识,请选择“ 我的 Teams 聊天和会议”。
您还可以将代理范围限定到特定聊天,包括团队频道、群组聊天和会议聊天。 将知识范围限定到特定聊天可提高代理响应的准确性和相关性。 若要将 Teams 知识范围限定到特定聊天,请在 “配置 ”选项卡上的 “知识 ”部分中,选择搜索栏。 在打开的窗口中,选择 “聊天 ”选项卡,然后选择要添加的特定聊天。 最多可以添加五个聊天。
还可以将代理范围限定为特定会议。 将知识范围限定到特定会议可以提高代理响应的准确性和相关性。 若要将 Teams 知识范围限定到特定会议,请在 “配置 ”选项卡上的“ 知识 ”部分选择搜索栏。 在打开的窗口中,选择“ 会议” 选项卡,然后选择要添加的特定会议。
重要
- Teams 知识可用性取决于你的许可证。 有关详细信息,请参阅 智能 Microsoft 365 Copilot 副驾驶® 许可。
- 选择 “我的 Teams 聊天和会议”时,代理会搜索所有会议脚本和整个日历。 若要限制范围,请改为添加特定会议。
- 根据过去脚本的大小,代理可能无法访问所有会议脚本。
Outlook 电子邮件
可以在 Outlook 电子邮件中对代理进行基础设置。 若要将电子邮件添加为知识源,请在 “配置 ”选项卡上的 “知识 ”部分中,选择搜索栏,然后选择 “我的电子邮件”。
注意
不能限定电子邮件知识的范围。 添加电子邮件时,代理会将邮箱中的所有电子邮件用作知识。 您与之共享代理的用户无权访问您的电子邮件作为知识。 此功能的可用性取决于你的许可证。 有关详细信息,请参阅 智能 Microsoft 365 Copilot 副驾驶® 许可。
嵌入的文件内容
您可以直接从设备上传文件,供代理从 “描述 ”或“ 配置 ”选项卡中用作知识。上传的文件将成为代理中的嵌入内容。 要上传文件,请将它们从设备拖放到任一选项卡中。还可以选择“ 配置 ”选项卡上的箭头图标以从设备上传文件。 可以从设备上传单个文件,但不能从文件夹。
最多可以添加 20 个文件作为知识源。
嵌入的文件存储在租户的默认地理位置中,而不是存储在用户首选的数据位置 (PDL) 。
注意
Microsoft 365 政府社区云 (GCC) 环境中不支持嵌入文件内容。
“ 配置” 选项卡显示 “已上传文件”下的嵌入文件。 文件可能需要几分钟才能上传,并且在完全上传前显示为灰色。 上传时间可能因文件大小和互联网速度而异。 有关嵌入式文件的大小限制的信息,请参阅 文件大小限制。
重要
Microsoft Purview 信息屏障 ( 嵌入式文件不支持 IB) 。 任何可以访问代理的用户都可以看到基于嵌入式文件内容的响应。
要删除您上传的文件,请选择文件旁边的 X,然后选择“ 删除”。
不支持具有以下任何特征的文件:
- 双密钥加密。
- 具有用户定义权限的敏感度标签。 如果上传具有用户定义权限的文件,代理创建失败。
- 已禁用提取权限权限的敏感度标签。 如果上传这些文件,代理创建失败。 如果代理用户没有对嵌入文件的提取权限,则无法访问代理。
- 来自已启用加密的其他租户的文件。
- 密码保护。
有关详细信息,请参阅不 支持的敏感度标签方案。
警告
当您将文件作为代理的知识源上传时,有权访问代理的任何用户也有权访问文件中的信息。 如果用户没有对文件上的任何敏感度标签的提取权限访问权限,则对代理的访问将受到限制。
有关嵌入文件内容索引和检索的信息,请参阅 优化内容检索。
代理嵌入内容的敏感度标签
如果上传任何带有敏感度标签的文件,或者租户具有默认 的敏感度标签 策略,请将敏感度标签应用于代理嵌入内容。 通过将敏感度标签应用于代理嵌入内容,可确保代理符合组织的 Microsoft Purview 策略。
应用于嵌入式内容的敏感度标签是以下标签中的较高优先级:
- 应用于任何嵌入文件的最高优先级敏感度标签。
- 组织应用的 默认敏感度标签策略 。
例如,如果在代理中嵌入带有“常规”标签的文件和带有“机密”标签的文件,则“机密敏感度”标签将应用于嵌入的内容。
注意
敏感度标签仅应用于嵌入式内容;它不适用于代理引用的其他知识源,例如 SharePoint 文件或 Copilot 连接器内容。
只有对应用于嵌入式内容的敏感度标签具有提取权限的用户可以访问和使用代理。 标签不会显示在代理 Microsoft Store 一览上。 没有嵌入式内容的提取权限的用户可以查看代理和代理说明,但无法添加或使用代理。
敏感度标签也应用于代理响应。 此标签在以下标签中优先级较高:
- 嵌入内容的敏感度标签
- 任何其他代理知识源的敏感度标签,例如 SharePoint 和 OneDrive 文件。
目前,不能对代理设置敏感度标签。
不支持的敏感度标签方案
下表列出了当前不支持的敏感度标签方案,描述了生成器将文件上传到代理时的行为,并为生成器提供了建议的操作。
| 方案 | 行为 | 采取行动的 |
|---|---|---|
| 启用了 Microsoft Purview 双密钥加密的敏感度标签 | 该文件已嵌入,但不用作知识。 生成器在上传文件时不会看到错误消息。 | 避免使用 DKE 上传文件,因为它们不能用作知识。 |
| 启用了用户定义权限的敏感度标签 | 文件已上传,但代理创建失败,并且没有错误消息。 | 删除任何具有用户定义权限的上传文件。 |
| 为用户禁用了提取权限的敏感度标签 | 文件已上传,但代理创建失败,并且没有错误消息。 | 删除任何已禁用提取权限的上传文件。 |
| 具有敏感度标签的文件来自另一个启用了加密的租户 | 该文件嵌入在代理中,但不用作知识。 | 避免从启用了加密的租户上传带有敏感度标签的文件,因为它们不能用作知识。 |
| 带有密码保护的文件 | 文件已上传,生成器会在上传的文件旁边看到错误消息。 | 使用密码保护删除任何上传的文件。 |
将代理与嵌入文件共享
当您将代理与嵌入文件共享时,您将在用户获取代理时与用户共享文件。 用户获取代理后,可以根据这些知识源从 Copilot 获取响应。 有关可用的共享选项,请参阅 共享和管理 Agent Builder 中内置的代理。
共享代理时,如果在嵌入式内容上设置了敏感度标签,则“共享”屏幕会显示敏感度标签。
文件类型和大小限制
下表列出了可以作为知识添加到代理的文件类型,以及每种文件类型的嵌入式文件大小限制。
| 文件类型 | 嵌入文件限制 |
|---|---|
| .doc | 512 MB |
| .docx | 512 MB |
| .html* | NA |
| 512 MB | |
| .ppt | 512 MB |
| .pptx | 512 MB |
| .txt | 512 MB |
| .xls | 30 MB |
| .xlsx | 30 MB |
* 仅支持 Microsoft 365 中的 SharePoint。
人脉数据
如果您以人员数据为基础,它可以提供更加个性化和上下文感知的响应。 人员数据提供有关个人的公共信息,例如姓名、职位、技能和组织关系。 此信息允许代理查找用户和同事资料,包括报告结构和联系方式。
对于拥有 智能 Microsoft 365 Copilot 副驾驶® 许可证的用户创建的代理,默认情况下会启用人脉数据。 可以在代理配置 UI 中禁用或重新启用此功能。 禁用或启用人员数据:
- 在 Agent Builder 的 “配置 ”选项卡上,选择 “引用组织中的人员” 旁边的开关以关闭或打开人员数据。
此功能的可用性取决于你的许可证。 有关详细信息,请参阅 智能 Microsoft 365 Copilot 副驾驶® 许可。
注意
人员数据充当个性化层,使用 Microsoft 365 中的上下文丰富代理响应。 它不会引入新的隐私风险,但为用户和管理员提供了透明度和控制。
Copilot 连接器
借助 Copilot 连接器,代理能够访问和应用外部系统(如客户帐户、事件票证、代码存储库和知识文章)中的知识。 使用 Copilot 连接器将企业数据集成到代理中,并为他们提供特定领域的知识。
注意
管理员必须在 Microsoft 365 管理中心启用和配置 Copilot 连接器。
有关 Copilot 连接器的详细信息,请参阅 智能 Microsoft 365 Copilot 副驾驶® 连接器概述。
范围 Copilot 连接器数据源
为了提高代理响应的准确性和相关性,地面代理不仅在广泛的组织数据中,而且在特定的范围数据中。 若要将代理中的连接器数据范围限定为特定属性,请执行以下操作:
在 “配置 ”选项卡的 “选择其他数据源”下,选择数据源的连接器。
在该连接器的卡上,添加与方案相关的连接。
选择箭头返回到 “知识 ”部分。
展开添加的连接器,然后选择要将知识范围限定到 (的属性(例如,项目、空间、文件夹) ),然后搜索或键入属性名称。
注意
如果该属性未显示在搜索结果中,可能是因为:
- 管理员未配置作用域内的内容。
- 你没有访问内容所需的权限。
- 范围对所选连接器无效。
从列表中选择要添加的属性。
代理的知识现在被限定为与作用域属性关联的数据。
例如,使用 Azure DevOps 工作项 连接器时,可以将代理范围限定到特定区域路径,以确保代理仅关注最相关的工作项。
若要确定 Azure DevOps 工作项 区域路径范围,请执行以下操作:
- 在 “选择其他数据源”下,选择 “Azure DevOps 工作项”。
- 选择与任务相关的连接旁边的 “添加 ”。
- 选择箭头以返回到 “知识 ”部分。
- 选择 选择区域路径 并搜索或键入区域路径名称。
- 选择要添加它的区域路径。
下表列出了支持范围设置的 Copilot 连接器以及可用于确定数据范围的属性。
| 连接器 | 范围属性 |
|---|---|
| Azure DevOps 工作项 | 区域路径 |
| Azure DevOps Wiki | Project |
| Confluence | 空格 |
| Google Drive | 文件夹 |
| GitHub 云拉取请求 | 存储库 |
| GitHub 云问题 | 存储库 |
| GitHub 云知识 | 存储库 |
| Jira | Project |
| ServiceNow 知识 | 知识库 |
| ServiceNow 目录 | 目录 |
| ServiceNow 票证 | 实体类型 (Sys_class_name/类别/子类别) |
有关可用 Copilot 连接器的详细信息,请参阅 预建连接器库。
Dynamics 365 和 Power Apps 数据
Business Applications in Work IQ 可帮助代理了解和使用来自 Dynamics 365 和 Power Platform 的业务数据和流程。 连接您的业务应用程序,为代理提供回答问题、遵循业务流程以及在现有权限和控制范围内采取行动所需的上下文。
注意
管理员必须首先在 Microsoft 365 管理中心的 Work IQ 中启用业务应用程序 ,并为每个 Power Platform 环境启用 Work IQ。 有关详细信息,请参阅 在 Work IQ 中设置业务应用程序。
将 Dataverse 添加为知识源可提供对内容的读取访问权限,并且不允许创建、更新或删除记录。
使用代理生成器,您可以确定将哪些应用程序作为数据源包含在内,以及对应用程序、表和数据的访问权限。 但是,Dataverse 安全设置管理所有数据。 对于尚无权访问指定应用或数据的用户,不会提供任何响应。
如果未选择特定应用,则查询将在你有权访问的所有应用中运行。 有关详细信息,请参阅 知识源。
将知识源优先于一般知识
您可以将代理配置为在响应需要基于知识搜索的查询时优先考虑您提供的知识源(例如 SharePoint 内容或嵌入式文件)。 基于知识的搜索是用户查找特定信息的请求;例如:
- 谁是现任公司首席执行官?
- 下一次商务会议是什么时候?
- 与功能相关的最新更新是什么?
某些用户请求不需要基于知识的搜索;代理可以根据一般 AI 知识进行响应。 例如:
- 将这句话翻译成西班牙语:“你好,你好吗?
- 什么是 1+1?
启用此功能后,代理将使用其常识回答不需要搜索的简单问题,并且仅使用您的知识源来回答基于搜索的问题。 如果代理在您提供的知识源中找不到相关信息,它会以回退消息做出响应,指出找不到该信息。 使用 仅使用指定的源 设置可让代理确定您指定的源的优先级。 此设置将优先考虑来源,而不是阻止常规 AI 知识。
若要将代理配置为确定知识源的优先级,请在 “配置 ”选项卡上,选择 “仅使用指定源”旁边的开关。
注意
智能体生成器不支持阻止客服人员回复中的一般 AI 知识。 若要更严格地控制知识源,请使用 Copilot Studio。 有关更多信息,请参阅 使用生成式 AI 协调代理行为。