可以使用以前Microsoft Graph 连接器) (智能 Microsoft 365 Copilot 副驾驶®连接器将数据从外部服务引入 Microsoft Graph。 借助 Copilot 连接器 API，可以为外部数据编制索引，从而支持 Microsoft 365 中的智能体验，例如 Copilot 和 Microsoft Search。
通过 具有应用程序权限的访问令牌代表应用程序执行索引数据的请求，而无需存在已登录用户。
生成自定义 Copilot 连接器
生成自定义 Copilot 连接器涉及四个步骤：
- ) 应用注册创建以前称为 Azure Active Directory 的Entra ID (。 除了请求Microsoft Graph，还可以提交应用所需的应用注册名称和 API 权限。 Microsoft Graph 响应有关新创建的应用注册的信息。
- 创建外部连接。 每个连接都需要唯一的 ID、名称和说明。
- 创建外部连接的架构。 架构定义将通过此 Microsoft Graph 连接引入的外部内容的形状。 创建架构是一项长时间运行的作。 提交架构以创建连接后，Microsoft Graph 会使用可用于检查作状态的 URL 进行响应。 只要作状态为
inprogress，架构就进行预配。 预配完成后，作将返回状态completed。 - 引入外部内容。 对于每个外部项，请从源内容存储库中提取它，对其进行转换，使其与外部连接的架构匹配，并将其作为外部项提交到 Microsoft Graph。 与项一起，包括有关允许谁访问它的信息，也称为访问控制列表 (ACL) 。
下面是一个序列图，其中说明了生成 Copilot 连接器的四个步骤。
常见用例
下表列出了 Copilot 连接器 API 的常见用例。
| 用例 | REST 资源 | 另请参阅 |
|---|---|---|
| 配置操作 | ||
| 建立、更新或删除连接 | externalConnection | externalConnection 方法 |
| 注册外部数据的架构 | schema | schema 方法 |
| 为操作编制索引 | ||
| 在索引中添加、更新或删除自定义项 | externalItem | externalItem 方法 |
已知限制
当前已知的限制如下：
- 应用程序在连接上只能执行 25 个并发作。
-
externalItem实体的最大大小为 4 MB。
后续步骤
- 请参阅 Microsoft 搜索 API 概述。
- 向下钻取 externalConnection、schema 和externalItem 资源的方法、属性和关系。
- 查看 Microsoft Graph postman 集合 （了解更多）
- 查看 GitHub 中的示例搜索连接器。