Microsoft Graph 连接器 SDK 概述

Microsoft Graph 连接器 SDK 简化了为没有预生成连接器但想要索引到 Microsoft Graph 的数据源生成高质量、高效且可复原的连接器的过程。

SDK 包括框架和协定组件,可帮助你编写代码以及测试代码的工具。

使用连接器 SDK,可以直接在 Visual Studio 集成开发环境中创建自定义 Microsoft Graph 连接器, (IDE) 。 它提供生成、调试和部署自定义连接器所需的一切。

通过使用 SDK 生成的连接引入的项使用项配额。 若要详细了解如何确定有多少项配额以及如何购买更多配额,请参阅 许可要求和定价

组件

连接器 SDK 包括以下组件:

  • 自定义连接器模板:如果要 在 C# 中开发自定义连接器,可以从 Visual Studio 市场下载模板并快速入门。 还可以选择使用此 列表中的任一语言开发自定义连接器。

  • 协定:协定是 gRPC 协议缓冲区文件,其中包含 Microsoft 平台 (Microsoft Graph 连接器代理) 与自定义连接器代码之间的交互协定。

  • Microsoft Graph 连接器代理:一种轻型软件组件,用于管理连接器功能和Microsoft 365 管理中心与自定义连接器代码之间的协调。

    下载最新版本的连接器代理并运行安装配置助手。 有关详细信息,请参阅 Microsoft Graph 连接器代理

  • 连接器 SDK 测试实用工具:包括预生成的测试方案,可用于测试自定义连接器代码并与连接器代理平台通信。

Microsoft Graph 连接器代理功能

连接器代理构建在用于运行 Microsoft 内置连接器的同一可靠的 连接器平台上。

它包括以下功能:

  • 从连接器获取数据:代理可以连接到自定义连接器,以使用连接器实现的逻辑从源获取数据。

  • Microsoft 365 管理中心集成:使用代理可以通过Microsoft 365 管理中心配置、管理和监视自定义连接器。

  • 爬网计划和管理:代理能够通过完全爬网和增量爬网对数据源进行爬网。 完全爬网 (基于列表或基于 Microsoft Graph 的) 按你定义的时间间隔定期浏览整个数据。 增量爬网更频繁,并且按你定义的间隔从以前的时间戳/检查点对数据源进行爬网。

  • 删除、差异和周期检测:代理能够根据连接器在定期完全爬网期间发送的项目来检测从数据源中删除的项目。 然后,代理也会负责从 Microsoft 索引中删除项。

    该代理还通过计算项的哈希并将其与之前看到的项的哈希进行比较来检测自上次爬网以来更改的项。 为了加快爬网速度,代理仅在项更改时发送要编制索引的数据。

    代理还会检测数据源中出现的重复项,这些数据源具有链接项 ((如网站) )并跳过对这些项进行爬网。

  • 标识映射:连接器代理允许对数据) 访问控制 Lists (ACL 进行标记,以启用安全修整。 可以根据数据源中的Microsoft Entra ID或 ACL 启用安全修整。

  • Microsoft Graph 引入:代理在从自定义连接器接收数据后将数据引入 Microsoft Graph。

注意

以下功能当前不可用:

  • 爬网期间基于图形的数据源遍历;例如,遍历文件夹结构。
  • 能够基于数据源的访问控制来管理搜索权限。

可以使用 GitHub 中的 Microsoft Graph 连接器 SDK 页中的合同,使用示例连接器或其他受支持的语言开始使用 C#。

后续步骤