Поделиться через

Обзор пакета SDK для соединителей Microsoft Graph

  • Статья

Пакет SDK соединителей Microsoft Graph упрощает процесс создания высококачественных, эффективных и устойчивых соединителей для источника данных, который не имеет предварительно созданного соединителя, но который требуется индексировать в Microsoft Graph.

Пакет SDK включает компоненты платформы и контракта, которые помогут вам написать код и средства для тестирования кода.

Пакет SDK соединителей позволяет создавать настраиваемые соединители Microsoft Graph непосредственно в интегрированной среде разработки Visual Studio. Он предоставляет все необходимое для сборки, отладки и развертывания пользовательского соединителя.

Элементы, которые поглощаются через подключения, созданные с помощью пакета SDK, потребляют квоту элементов. Дополнительные сведения о том, как определить, сколько у вас есть квоты на элементы и как приобрести дополнительную квоту, см. в разделе Требования к лицензированию и цены.

Компоненты

Пакет SDK для соединителей включает следующие компоненты:

  • Пользовательский шаблон соединителя. Если вы хотите разработать пользовательский соединитель на C#, вы можете скачать шаблон из Visual Studio Marketplace и быстро приступить к работе. Вы также можете разработать пользовательский соединитель на любом из языков в этом списке.

  • Контракты. Контракты — это файлы буфера протокола gRPC , содержащие контракты для взаимодействия между платформой Майкрософт (агентом соединителя Microsoft Graph) и пользовательским кодом соединителя.

  • Агент соединителя Microsoft Graph. Упрощенный программный компонент, который управляет возможностями соединителя и координирует работу между Центр администрирования Microsoft 365 и пользовательским кодом соединителя.

    Скачайте последнюю версию агента соединителя и запустите помощник конфигурации установки. Дополнительные сведения см. в статье Агент соединителя Microsoft Graph.

  • Служебная программа тестирования пакета SDK для соединителей. Включает предварительно созданные тестовые сценарии, которые можно использовать для тестирования пользовательского кода соединителя и взаимодействия с платформой агента соединителя.

Возможности агента соединителя Microsoft Graph

Агент соединителя создан на той же надежной платформе соединителя, которая используется для запуска встроенных соединителей Майкрософт.

Она включает в себя следующие возможности:

  • Получение данных из соединителя. Агент может подключиться к пользовательскому соединителю, чтобы получить данные из источника с помощью логики, реализованной соединителем.

  • интеграция Центр администрирования Microsoft 365. Агент позволяет настраивать настраиваемые соединители, управлять ими и отслеживать их с помощью Центр администрирования Microsoft 365.

  • Планирование обхода контента и управление ими. Агент может обхода данных с помощью полного и добавочного обхода контента. Полные обходы (на основе списка или Microsoft Graph) периодически проходят через все данные с определенным интервалом. Добавочные обходы выполняются чаще, и они сканируют источник данных из предыдущей метки времени или контрольной точки через определенный вами интервал.

  • Удаление, обнаружение различий и циклов. Агент может обнаруживать элементы, удаленные из источника данных, на основе элементов, отправленных соединителем во время периодического полного обхода контента. Затем агент также выполняет удаление элемента из индекса Майкрософт.

    Агент также обнаруживает элементы, которые изменились с момента последнего обхода контента, вычисляя хэш элемента и сравнивая его с хэшем элемента, просмотренным ранее. Чтобы ускорить обход контента, агент отправляет данные для индексирования только при изменении элемента.

    Агент также обнаруживает повторяющиеся элементы, возникающие из источников данных со связанными элементами (например, веб-сайты), и пропускает обход этих элементов.

  • Сопоставление удостоверений. Агент соединителя включает метку контроль доступа Списки (ACL) в данных, чтобы включить обрезку безопасности. Вы можете включить обрезку безопасности на основе Microsoft Entra ID или списков ACL из источника данных.

  • Прием Microsoft Graph. Агент принимает данные в Microsoft Graph после их получения из пользовательского соединителя.

Примечание.

В настоящее время недоступны следующие возможности:

  • Обход источника данных на основе графа во время обхода контента; например, путем обхода структур папок.
  • Возможность управления разрешениями поиска на основе управления доступом из источника данных.

Вы можете приступить к работе на C# с нашими примерами соединителей или на других поддерживаемых языках, используя контракты на странице пакета SDK соединителей Microsoft Graph в GitHub.

Дальнейшие действия