使用 Microsoft Graph 连接器 API

可以使用 Microsoft Graph 连接器将数据从外部服务引入 Microsoft Graph。 借助 Microsoft Graph 连接器 API，可以为外部数据编制索引，从而支持 Microsoft 365 中的智能体验，例如 Copilot 和 Microsoft 搜索。

通过 具有应用程序权限的访问令牌代表应用程序执行索引数据的请求，而无需存在已登录用户。

生成自定义 Microsoft Graph 连接器

生成自定义 Microsoft Graph 连接器涉及四个步骤：

1. 创建 Entra ID (以前称为 Azure Active Directory) 应用注册。 除了向 Microsoft Graph 发出请求，还可以提交应用所需的应用注册名称和 API 权限。 Microsoft Graph 会响应有关新创建的应用注册的信息。
2. 创建外部连接。 每个连接都需要唯一的 ID、名称和说明。
3. 创建外部连接的架构。 架构定义将通过此 Microsoft Graph 连接引入的外部内容的形状。 创建架构是一项长时间运行的操作。 提交架构以创建连接后，Microsoft Graph 会使用可用于检查操作状态的 URL 进行响应。 只要操作状态为 inprogress，架构就进行预配。 预配完成后，操作将返回状态 completed 。
4. 引入外部内容。 对于每个外部项，请从源内容存储库中提取它，对其进行转换，使其与外部连接的架构匹配，并将其作为外部项提交到 Microsoft Graph。 与项一起，包括有关允许谁访问它的信息，也称为访问控制列表 (ACL) 。

下面是演示生成 Microsoft Graph 连接器的四个步骤的序列图。

常见用例

下表列出了 Microsoft Graph 连接器 API 的常见用例。

用例	REST 资源	另请参阅
配置操作
建立、更新或删除连接	externalConnection	externalConnection 方法
注册外部数据的架构	schema	schema 方法
为操作编制索引
在索引中添加、更新或删除自定义项	externalItem	externalItem 方法

已知限制

当前已知的限制如下：

• 组织限制为最多 30 个连接。 (如果需要更多连接，请填写 “请求”表单。)
• 每秒最多可以创建 25 externalItem 个资源项。
• 应用程序在连接上只能执行 25 个并发操作。
• 连接的容量限制为 5,000,000 项，或 `350 GB 数据。
• externalItem 实体的最大大小为 4 MB。

后续步骤

• 请参阅 Microsoft 搜索 API 概述。
• 向下钻取 externalConnection、schema 和externalItem 资源的方法、属性和关系。
• 查看 Microsoft Graph postman 集合 （了解更多）
• 查看 GitHub 中的示例搜索连接器。