提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
可以控制代理可用的知识,以便使用 Web 和 Microsoft 365 组织数据中的知识源生成响应。 有关可用知识源的完整列表,请参阅 将知识源添加到声明式代理。
重要
本指南假定你已完成使用 Microsoft 365 代理工具包和 JSON 创建声明性代理 教程。
向代理添加 Web 搜索
向代理添加 Web 搜索允许其搜索 Web 以生成答案。 可以选择将知识范围限定到特定网站。
打开该
appPackage/declarativeAgent.json文件并添加capabilities包含以下内容的数组。"capabilities": [ { "name": "WebSearch" } ]有关详细信息,请参阅 Web 搜索对象。
在 Microsoft 365 代理工具包的生命周期窗格中选择“预配”。
声明性代理有权访问 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 内容可供代理使用。
在 Agents Toolkit 的生命周期窗格中选择预配。
声明性代理有权访问 OneDrive 和 SharePoint 内容,以便在你重新加载页面后生成其答案。
将 Teams 消息添加到代理
打开该
appPackage/declarativeAgent.json文件,将以下值添加到数组中capabilities,替换https://teams.microsoft.com/l/team/...为组织中的 Teams 频道或团队 URL。{ "name": "TeamsMessages", "urls": [ { "url": "https://teams.microsoft.com/l/team/..." } ] }有关详细信息,请参阅 Microsoft Teams 消息对象。
注意
- 属性中的
urlURL 必须是指向 Teams 聊天、团队或会议聊天的格式正确的链接。 - 如果未指定数组,
urls则 Microsoft 365 组织中可供登录用户使用的所有 Teams 频道、团队、会议、一对一聊天和群组聊天可供代理使用。
- 属性中的
在 Agents Toolkit 的生命周期窗格中选择预配。
声明性代理有权访问 Teams 数据,以便在你重新加载页面后生成其答案。
向代理添加人员知识
人员知识源允许您将代理范围限定为回答有关组织中个人的问题。
打开文件
appPackage/declarativeAgent.json并将条People目添加到数组中capabilities。{ "name": "People" }有关详细信息,请参阅 People 对象。
在 Agents Toolkit 的生命周期窗格中选择预配。
声明式代理可以在重新加载页面后访问人员知识。
将电子邮件添加到代理
通过电子邮件知识源,可以将代理范围限定为使用来自用户邮箱或共享邮箱的电子邮件来回答查询。
打开文件
appPackage/declarativeAgent.json并将条Email目添加到数组中capabilities。{ "name": "Email", "folders": [ { "folder_id": "inbox" } ] }有关详细信息,请参阅 Email 对象。
注意
- 此示例访问代理邮箱的用户。 若要改为访问共享邮箱,请将可选
shared_mailbox属性集添加到共享邮箱的电子邮件地址。 - 数组限制
folders对特定文件夹的邮箱访问权限。 要访问整个邮箱,请省略folders数组。
- 此示例访问代理邮箱的用户。 若要改为访问共享邮箱,请将可选
在 Agents Toolkit 的生命周期窗格中选择预配。
声明性代理有权在您重新加载页面后访问电子邮件知识。
将 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 连接器内容可供代理使用。
- 未指定
在 Agents Toolkit 的生命周期窗格中选择预配。
声明性代理有权访问 Copilot 连接器内容,以便在重新加载页面后生成其答案。