使用 Microsoft Graph 连接器 API
可以使用 Microsoft Graph 连接器将数据从外部服务引入 Microsoft Graph。 借助 Microsoft Graph 连接器 API，可以为外部数据编制索引，从而支持 Microsoft 365 中的智能体验，例如 Copilot 和 Microsoft 搜索。
通过 具有应用程序权限的访问令牌代表应用程序执行索引数据的请求，而无需存在已登录用户。
生成自定义 Microsoft Graph 连接器
生成自定义 Microsoft Graph 连接器涉及四个步骤：
- 创建 Entra ID (以前称为 Azure Active Directory) 应用注册。 除了向 Microsoft Graph 发出请求，还可以提交应用所需的应用注册名称和 API 权限。 Microsoft Graph 会响应有关新创建的应用注册的信息。
- 创建外部连接。 每个连接都需要唯一的 ID、名称和说明。
- 创建外部连接的架构。 架构定义将通过此 Microsoft Graph 连接引入的外部内容的形状。 创建架构是一项长时间运行的操作。 提交架构以创建连接后，Microsoft Graph 会使用可用于检查操作状态的 URL 进行响应。 只要操作状态为
inprogress，架构就进行预配。 预配完成后，操作将返回状态completed。 - 引入外部内容。 对于每个外部项，请从源内容存储库中提取它，对其进行转换，使其与外部连接的架构匹配，并将其作为外部项提交到 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 中的示例搜索连接器。