Создание первого пользовательского соединителя Copilot с помощью microsoft 365 Agents Toolkit

соединители Microsoft 365 Copilot позволяют принимать бизнес-данные в Microsoft Graph, чтобы сделать их доступными для Microsoft 365 Copilot. При приеме данных Copilot может использовать их для реагирования на запросы пользователей.

Набор средств агентов Microsoft 365 содержит шаблон, который можно использовать для создания соединителей Copilot. Шаблон соединителя Copilot предназначен для быстрого создания соединителей с помощью API соединителя Copilot в Microsoft Graph. Шаблон формирует соединитель, который извлекает данные из API GitHub в Microsoft Graph. После сборки соединителя его можно запустить локально с помощью интерфейса F5 или развернуть с помощью Функции Azure.

В этой статье приведено пошаговое руководство по созданию первого соединителя Copilot с помощью microsoft 365 Agents Toolkit в Visual Studio Code.

Предварительные условия

Для выполнения действий, описанных в этой статье, необходимо выполнить следующие предварительные требования.

• Visual Studio Code

• Набор средств агентов Microsoft 365 для Visual Studio Code

• расширение Функции Azure Visual Studio Code

• Node.js, поддерживаемые версии: 18, 20, 22

• Лицензия Microsoft 365 Copilot или клиент Microsoft 365 Developer с включенной отправкой пользовательских приложений.

  Примечание.

  Чтобы протестировать соединитель в Microsoft 365 Copilot Chat, требуется лицензия на Microsoft 365 Copilot.

• У вас должна быть возможность предоставления согласия администратора в Центр администрирования Microsoft Entra. Этот шаг необходимо выполнить в качестве глобальный администратор. См . раздел Предоставление согласия администратора на уровне клиента приложению для необходимых ролей.

• Чтобы увидеть соединитель в Центр администрирования Microsoft 365, у пользователя должна быть роль "Администратор поиска", "Разработчик облачных приложений".

Создание первого настраиваемого соединителя

Чтобы создать первый соединитель, выполните следующие действия.

1. На боковой панели в Visual Studio Code выберите Microsoft 365 Agents Toolkit > Создать новый агент или приложение.

   

2. Выберите Соединитель Copilot.

   

3. Введите Github Issues в качестве имени соединителя.

4. Создайте уникальный идентификатор для соединителя на уровне клиента. Дополнительные сведения о требованиях к идентификатору соединителя см. в свойстве id ресурса externalConnection.

5. Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.

6. Настройте репозиторий, из которого требуется извлечь проблемы, с помощью CONNECTOR_REPOS поля из .env.local файла.

   

7. Нажмите клавишу F5 , чтобы запустить соединитель локально. Набор средств создает приложение Microsoft Entra для соединителя и запускает процесс подготовки.

8. Перейдите по ссылке в терминале к Центр администрирования Microsoft Entra и выберите Предоставить согласие администратора.

   Примечание.

   Для выполнения этого шага необходимо быть глобальным Администратор в своей организации.

   

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

   Примечание.

   Регистрация схемы может занять до 10 минут.

10. После завершения полного обхода в Центр администрирования Microsoft 365:

    • В левой области перейдите в раздел Параметры>Поиск &источники данных аналитики>.

    • Найдите идентификатор подключения.

    • Выберите Включить результаты соединителя.

      

      Примечание.

      Для выполнения этого шага необходимо быть Администратор поиска. Этот шаг позволяет использовать результаты соединителя Microsoft 365 Copilot Chat. Если вы собираетесь использовать этот соединитель только в качестве источника знаний для декларативного агента, этот шаг не является обязательным.

11. Чтобы убедиться, что элементы были проиндексированы, выберите соответствующее имя соединителя. Проверьте поле Индексированные элементы , чтобы узнать, сколько проблем было проиндексировано.

    

12. Откройте Microsoft 365 Copilot Chat и протестируйте пример запроса, например "Каковы две последние проблемы GitHub?". Обратите внимание на ссылки на внешние элементы в нижней части страницы. Эти ссылки являются данными из соединителя Copilot.

    

Настройка шаблона для источника данных

Чтобы настроить этот шаблон для пользовательских данных, можно обновить содержимое следующих папок:

• src/custom: содержит пользовательский код для сбора и преобразования данных для приема в Microsoft Graph. Хотя в примере используется API проблем GitHub, его можно заменить любым другим API.

• src/references: включает определение схемы соединителя. Настройте его в соответствии с данными и метаданными, которые вы хотите принять.

• src/models: содержит определение модели для внутреннего представления данных и конфигурации. Обе модели можно настроить в соответствии с вашими потребностями.

В дополнение к этим папкам можно настроить другие части кода в зависимости от сценария. Вы можете искать в коде комментарии, начиная со [Customization point] строки. Эти примечания указывают области для потенциальной настройки.

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

• API соединителей Copilot
• Обзор набора средств агентов Microsoft 365
• Создание декларативных агентов с помощью microsoft 365 Agents Toolkit
• Примеры соединителя Copilot
• Примеры сообщества