使用 Microsoft SharePoint 工具（预览版）

将代理与 Microsoft SharePoint 集成，以安全地与专用文档聊天。 可以连接到 SharePoint 站点（例如 contoso.sharepoint.com/sites/policies）以使用这些数据为代理建立基础知识。 当用户发送查询时，代理将确定是否应利用 SharePoint。 如果是这样，它将使用 SharePoint 工具发送查询，该工具检查用户是否具有 Microsoft 365 Copilot 许可证，并使用托管标识检索他们有权访问的相关文档。 检索范围包括此 SharePoint 网站中的所有受支持文档。 最后，代理将基于检索到的信息生成响应。 借助标识直通（on-Behalf-Of）授权，此集成简化了对 SharePoint 中企业数据的访问，同时保持可靠的安全性，确保适当的访问控制和企业级保护。

工作原理

借助 SharePoint 工具，可以在由 Microsoft 365 Copilot API 授权的 SharePoint 中存储的 AI 代理与业务文档之间实现无缝集成。 为了巩固 SharePoint 文档，只需输入要连接的网站或文件夹，SharePoint 工具将利用 内置索引功能 增强搜索和检索体验，包括智能索引、查询处理和内容分块。

此功能自动执行整个检索管道，而不是要求开发人员导出 SharePoint 内容、生成自定义语义索引、管理治理控件和配置刷新逻辑。 它动态索引文档、将内容分解为有意义的区块，并应用高级查询处理来显示最相关的信息。 通过使用支持智能 Microsoft 365 Copilot 副驾驶® 的相同企业级检索堆栈，确保 AI 智能体响应基于最新且上下文相关的内容。

客户依靠 SharePoint 中的数据安全性来访问、创建和共享具有灵活文档级访问控制的文档。 企业功能（如 Identity Passthrough/On-Behalf-Of（OBO）身份验证）可确保适当的访问控制，使最终用户能够接收来自他们有权限访问的 SharePoint 文档生成的响应。 通过 OBO 身份验证，Foundry 代理服务使用最终用户的身份来授权和检索相关的 SharePoint 文档，从而生成针对特定最终用户定制的响应。

使用支持

Azure AI Foundry 支持	Python SDK	C# SDK	JavaScript SDK	REST API	基本代理设置	标准代理设置
✔️	-	-	-	✔️	✔️	✔️

先决条件

• 开发人员和最终用户必须拥有 Microsoft 365 Copilot 许可证，以符合 Microsoft 365 Copilot API 的要求。
• 开发人员和最终用户至少具有 Azure AI User 这一 RBAC 角色。
• 开发人员和最终用户至少有READ访问该 SharePoint 网站的权限。

设置

注释

• 支持的文档类型：采用以下格式的文本数据：.pdf、、.docx、.ppt、 .txt.aspx
• 建议从 SharePoint 网站开始，其中包含一个简单的文件夹结构和少量的短文档。

1. 按照 快速入门中的步骤创建代理。

2. 可以使用本文顶部列出的代码示例或 Azure AI Foundry 门户以编程方式将 SharePoint 工具添加到代理。 如果要使用门户，请在代理的“创建和调试”或“代理操场”屏幕中，向下滚动右侧的“设置”窗格以转到知识。 然后选择“添加”。

   

3. 选择 SharePoint 并按照提示添加该工具。 每个代理只能添加一个。

4. 单击以添加新连接。 添加连接后，可以直接从现有列表中选择。

   1. 若要创建新连接，需要在您的 SharePoint 网站中找到 site_url。 您可以添加 SharePoint 网站或 SharePoint 文件夹。 对于 SharePoint 网站，它将如下所示 https://microsoft.sharepoint.com/teams/<site_name>。 对于 SharePoint 文件夹，它将如下所示 https://microsoft.sharepoint.com/teams/<site_name>/Shared%20documents/<folder_name>

      注释

      • 您的 site_url 需要遵循上述格式。 如果从 SharePoint 的地址栏中复制整个值，则它不起作用。

   2. 然后，可以将其添加到您的连接中。 请确保已选择 “机密 ”选项。

后续步骤

• 如何使用 SharePoint 工具
• 该工具使用的内容检索参考文章：
  • Microsoft 365 Copilot 检索 API 概述。
  • Microsoft 365 Copilot 的语义索引