概述

SharePoint Embedded 代理使您能够通过简单的 SDK 将 AI 功能添加到应用程序中。 此聊天控件提供以下功能：

• 使用 RAG 的 SharePoint Embedded 容器中的文档的原因。
• 开发人员可以将应用程序代码配置为将搜索范围限制为文件、文件夹和容器。
• 开发人员可以自定义和配置聊天控件，包括初学者提示、建议的提示、颜色等。

观看此演示，详细了解如何配置此功能。

为何使用 SharePoint Embedded 代理

SharePoint Embedded 代理利用语义索引为 Retrieval-Augmented Generation (RAG) 提供支持，并在查询时安全地引用 Microsoft 365 边界中的数据。 这可确保准确、基础的 AI 响应，同时减少对广泛知识模型的依赖。 即用即付计费模型即将到来，使成本与实际使用情况保持一致。

如何使用 SharePoint Embedded 代理

如何生成代理

目前，可以使用以 TypeScript 编写的 React SDK 库来生成应用程序。 将宣布支持其他框架和环境的计划。 SDK 配置了 containerType 的 containerId 实例，以及通过回调提供的授权和身份验证令牌逻辑。 它将自身作为 iFrame 嵌入到主机应用程序中。 默认情况下，会为 iFrame 提供一个 frame-ancestors 属性，该属性可防止它被任何主机嵌入，直到配置。 下面提供了详细信息。

SPE TypeScript React 应用程序

按照 快速入门指南 开始使用预生成的示例应用程序。

API 文档

此处提供的 SharePoint Embedded React TypeScript NPM 包提供了用于将 SharePoint Embedded 代理集成到客户端应用程序中的 SDK。

常见问题

基于消耗的计费是否适用于 SPE 代理？

是的，从 5 月 15 日开始，需要使用标准容器类型在 SPE 应用程序中使用 SPE 代理。 SharePoint Embedded 代理交互（包括来自智能 Microsoft 365 Copilot 副驾驶®许可证用户的交互）将计费到与容器类型关联的 Azure 订阅。 详细了解 SharePoint Embedded 计费管理

试用容器类型在 30 天后过期，因此，我们建议从Standard容器类型开始。没有从试用版到Standard容器类型的升级路径。

我应该使用标准容器类型还是试用版容器类型？

启用基于使用量的计费后，我们将禁止在试用容器类型中使用此功能，并且仅在以后Standard容器类型上启用此功能。 请按照本指南开始创建Standard容器类型。

SharePoint Embedded 代理支持

“聊天控件反馈”对话框

如果聊天控件遇到任何问题，请使用大拇指向上或向下反馈按钮来报告问题。 此方法是发送反馈的首选方法，因为它为我们提供了遥测数据，帮助我们更有效地诊断和排查问题。

单击“向下大拇指”按钮时，将显示反馈对话框。 请在此对话框中包含任何相关信息。

高级Topics概述

高级主题深入探讨 SharePoint Embedded 代理如何使用语义索引来促进 Retrieval-Augmented 生成 (RAG) ，确保响应准确基于存储的内容。 你还将了解如何将代理范围限定为特定的数据源、设置各种文件格式以及配置区域设置选项来定制代理体验。 通过探索地面、语义索引和 RAG 工作流等概念，可以优化代理的有效性，并在 Microsoft 365 边界内保持安全性。