将 SharePoint Embedded 设置为 Foundry 知识源

适用于: 开发人员版

如果你的应用需要对存储在 SharePoint Embedded 容器中的文件提供固定的代理体验,请将 Microsoft Foundry 智能体服务与 SharePoint 知识源结合使用。

对于 SharePoint Embedded 容器类型,知识源通过正式发布的智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®检索 API 为答案奠定基础。 Foundry 作为代理的一部分运行检索调用,因此相同的先决条件、索引行为和计费适用。 sharePointEmbedded Foundry 使用的数据源处于预览阶段。 若要改为运行自己的基础步骤,请直接调用检索 API,如 使用检索 API 中所述。

注意

SharePoint Embedded 的 SharePoint 知识源以预览版提供。

先决条件

开始之前,请确认你有:

  • 至少具有一个容器的 SharePoint Embedded 应用。
  • SharePoint Embedded 应用的容器类型 ID。
  • 一个 Microsoft Foundry 代理服务项目。
  • 为容器类型配置的即用即付计费。
  • 租户中至少有一个用户拥有智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证,因此语义索引将初始化。 有关详细信息,请参阅 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的语义索引
  • 在代理必须访问内容的每个使用租户中更新容器类型注册的权限。

查询代理的用户不需要智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证。 使用情况在 Copilot Studio 消息计量上计费,费用遵循为容器类型配置的计费模型。 有关详细信息,请参阅 计费指示器

配置 SharePoint 知识源

配置 Foundry SharePoint 知识源,并 remoteSharePointParameters.containerTypeId 设置为 SharePoint Embedded 容器类型 ID。

有关特定于源的配置详细信息,请参阅 SharePoint 知识源属性

向铸造厂授予对容器类型的访问权限

授予 Microsoft Foundry 对每个使用租户中的容器类型的读取访问权限。 Foundry 应用程序 ID 为 880da380-985e-4198-81b9-e05b1cc53158

容器类型的拥有应用程序必须调用使用租户中的注册 API。

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
Content-Type: application/json
{
  "delegatedPermissions": ["readContent"],
  "applicationPermissions": ["none"]
}

替换 {fileStorageContainerTypeId} 为容器类型 ID。

还可以使用 Create container type registration endpoint 在初始容器类型注册期间授予此权限。

验证检索

  1. 将支持的文件上传到 SharePoint Embedded 容器。
  2. 等待索引完成。
  3. 以有权访问容器内容的用户身份登录。
  4. 向代理询问上传的文件可以回答的问题。
  5. 确认答案是基于预期的 SharePoint Embedded 内容。

如果答案省略了预期的文件,请检查:

  • 在使用租户中注册容器类型。
  • 铸造厂应用程序权限授予。
  • 租户中的语义索引初始化。
  • 对容器和文件的用户访问权限。
  • 支持的文件格式。
  • 内容可发现性设置。
  • 索引延迟。

后续步骤