Создание подключаемых модулей API с помощью нового API для Microsoft 365 Copilot

Важно!

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

Подключаемые модули API подключают REST API к Microsoft 365 Copilot. Вы можете использовать microsoft 365 Agents Toolkit для быстрого создания подключаемого модуля и соответствующего REST API, который можно использовать в качестве отправной точки для разработки подключаемого модуля.

Создание подключаемого модуля и API

Примечание.

Снимки экрана и ссылки на пользовательский интерфейс microsoft 365 Agents Toolkit в этом документе были созданы с помощью последней версии выпуска 6.0. Предварительные версии Набора средств агентов могут отличаться от пользовательского интерфейса в этом документе.

  1. Откройте Visual Studio Code. Если набор средств агентов еще не установлен, инструкции по установке см. в разделе Установка набора средств агентов .

  2. Щелкните значок Microsoft 365 Agents Toolkit на панели действий слева.

  3. Выберите Создать агент или приложение в области задач Набор агентов.

    Снимок экрана: интерфейс набора средств агентов

  4. Выберите Декларативный агент.

  5. Выберите Добавить действие, а затем выберите Начать с нового API.

  6. Выберите OAuth в поле Тип проверки подлинности.

  7. Выберите предпочитаемый язык программирования: JavaScript или TypeScript. В этом руководстве предполагается TypeScript.

  8. Выберите расположение для проекта подключаемого модуля API.

  9. Введите Repairs Agent в качестве имени проекта подключаемого модуля.

После выполнения этих действий набор средств агентов создает необходимые файлы для подключаемого модуля и открывает новое окно Visual Studio Code с загруженным проектом подключаемого модуля. Дополнительные сведения о проекте см. в файле README.md в корневом каталоге созданного проекта.

Запуск подключаемого модуля

  1. В окне Visual Studio Code с загруженным проектом подключаемого модуля щелкните значок Microsoft 365 Agents Toolkit (Набор средств microsoft 365 Agents Toolkit) на панели действий слева.

  2. В области Учетные записи выберите Войти в Microsoft 365. (Если вы уже вошли в систему, перейдите к следующему шагу.

  3. Убедитесь, что в вашей учетной записи Microsoft 365 отображаются настраиваемые функции отправки приложений и доступ Copilot. В противном случае проверка с администратором организации. Дополнительные сведения см. в разделе Требования к параметрам расширяемости Copilot.

  4. Щелкните значок Запуск и отладка на панели действий слева.

  5. Выберите Отладка в Copilot (Edge) или Отладка в Copilot (Chrome), а затем нажмите клавишу F5 , чтобы начать отладку.

Набор средств агентов создает проект, создает пакет подключаемого модуля и загружает его для учетной записи пользователя. После этого откроется новое окно браузера для приложения Microsoft Teams.

Тестирование подключаемого модуля

  1. В Microsoft Teams в браузере выберите Copilot.

  2. Выберите Ремонт агенталок в списке Агенты справа. Если список недоступен, щелкните значок Чати Copilot и другое в правом верхнем углу.

  3. Отправьте сообщение в Copilot о ремонте. Например, попробуйте .Which repairs are assigned to Karin?

На этом этапе подключаемый модуль выполняется локально на компьютере разработки без проверки подлинности. Чтобы добавить проверку подлинности, разверните решение в Azure.

Развертывание в Azure и включение проверки подлинности

  1. Щелкните значок Microsoft 365 Agents Toolkit на панели действий слева.

  2. В области Жизненный цикл выберите Подготовка.

  3. При запросе имени группы ресурсов примите значение по умолчанию или измените его по мере необходимости и нажмите клавишу ВВОД.

  4. Выберите расположение для группы ресурсов.

  5. Просмотрите сообщение в диалоговом окне. Если все выглядит правильно, выберите Подготовка , чтобы продолжить.

  6. Дождитесь завершения действий по подготовке, а затем выберите Развернуть в области Жизненный цикл .

После выполнения этих действий подключаемый модуль развертывается как функция Azure с проверкой подлинности.

Тестирование подключаемого модуля с проверкой подлинности

  1. В Microsoft Teams в браузере выберите Copilot.

  2. Выберите Восстановить агентdev в списке Агенты справа.

  3. Отправьте сообщение в Copilot о ремонте. Например, попробуйте .Which repairs are assigned to Issac?

  • Last updated on