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

Использование API соединителей Copilot

Для переноса данных из внешних служб в Microsoft Graph можно использовать соединители Microsoft 365 Copilot (ранее — соединители Microsoft Graph). API соединителей Copilot позволяет индексировать внешние данные, чтобы обеспечить интеллектуальные возможности Microsoft 365, такие как Copilot и Поиск (Майкрософт).

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

Создание пользовательского соединителя Copilot

Создание пользовательского соединителя Copilot состоит из четырех этапов:

  1. Создайте Entra ID регистрации приложения (ранее — Azure Active Directory). Вместе с запросом в Microsoft Graph вы отправляете имя регистрации приложения и разрешения API, необходимые приложению. Microsoft Graph отправляет сведения о регистрации созданного приложения.
  2. Создайте внешнее подключение. Для каждого подключения требуется уникальный идентификатор, имя и описание.
  3. Создайте схему для внешнего подключения. Схема определяет форму внешнего содержимого, которое вы будете принимать через это подключение Microsoft Graph. Создание схемы — это длительная операция. После отправки схемы для создания подключения Microsoft Graph возвращает URL-адрес, который можно использовать для проверка состояния операции. Схема подготавливается при условии, что состояние операции — inprogress. После завершения подготовки операция вернет completed состояние.
  4. Прием внешнего содержимого. Для каждого внешнего элемента извлеките его из исходного репозитория содержимого, преобразуйте его так, чтобы он соответствовал схеме для внешнего подключения, и отправьте его в Microsoft Graph в качестве внешнего элемента. Наряду с элементом, включите сведения о том, кому разрешен доступ к нему, также известный как список управления доступом (ACL).

Ниже приведена схема последовательностей, на которую иллюстрируются четыре этапа создания соединителя Copilot.

Схема, на которую показаны четыре этапа создания соединителя Copilot

Основные варианты использования

В следующей таблице перечислены распространенные варианты использования API соединителей Copilot.

Варианты использования Ресурсы REST См. также
Действия для настройки
Создание, обновление или удаление подключения externalConnection Методы externalConnection
Регистрация схемы для внешних данных schema Методы schema
Действия для индексирования
Добавление, обновление или удаление пользовательского элемента индекса externalItem Методы externalItem

Известные ограничения

Далее представлены текущие известные ограничения:

  • Приложение ограничено 25 одновременными операциями при подключении.
  • Максимальный размер объекта externalItem составляет 4 МБ.

Связанные материалы

  • Last updated on