Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Важно
Плагины MCP и API обеспечивают действия внутри декларативных агентов. Они не являются отдельными устанавливаемыми пакетами плагинов: только агент, содержащий их, может получить доступ к их функциям и инструментам. Сведения об отношении манифеста пакета и действия см. в разделе Подключаемые модули и декларативные действия агента.
Совет
Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.
Подключаемые модули API позволяют декларативному агенту вызывать существующий REST API. Используйте набор средств агентов Microsoft 365 для создания проекта агента с интеграцией действий API на основе спецификации OpenAPI вашего API.
Необходимые условия
- Требования, указанные в разделе Требования к параметрам расширяемости Copilot
- Существующий REST API со спецификацией OpenAPI (в этом пошаговом руководстве используется пример API средства отслеживания бюджета)
- Visual Studio Code
- Набор средств для агентов Microsoft 365
Совет
Для достижения наилучших результатов убедитесь, что спецификация OpenAPI соответствует рекомендациям, подробно описанным в статье "Как сделать документ OpenAPI эффективным при расширении Copilot".
Чтобы следовать этому руководству, скачайте пример API средства отслеживания бюджета и настройте его для запуска на локальном компьютере разработки. Создайте пример по крайней мере один раз, чтобы создать файл BudgetTracker.json для API.
Создайте агент и плагин API
Примечание
Снимки экрана и ссылки на пользовательский интерфейс в этой статье используют версию выпуска набора средств агентов Microsoft 365. Предварительные версии могут отличаться от пользовательского интерфейса.
Конфигурация плагина API включает в себя:
- Спецификация OpenAPI для REST API.
- Манифест подключаемого модуля, который ссылается на включенную спецификацию OpenAPI и описывает доступные операции, метод проверки подлинности и форматы ответов.
Включите эти файлы в содержащий агент пакет приложения вместе с манифестом приложения, определением агента и значками. Манифест подключаемого модуля API сам по себе не является пакетом, который можно установить.
Откройте Visual Studio Code. Если набор средств агентов еще не установлен, инструкции по установке см. в разделе Установка набора средств агентов .
Выберите значок набора средств агентов Microsoft 365 на панели действий слева.
Выберите Создать агент или приложение в области задач Agents Toolkit.
Выберите декларативный агент.
Выберите "Добавить действие", а затем выберите "Начать с документа с описанием OpenAPI".
Выберите "Обзор" и перейдите к расположению спецификации OpenAPI в примере средства отслеживания бюджета, расположенном по адресу ./openapi/BudgetTracker.json.
Выберите все операции, которые нужно включить для подключаемого модуля.
Выберите расположение для проекта агента.
Введите
Budget Trackerимя для проекта агента.
После выполнения этих действий Agents Toolkit создает проект агента и его конфигурацию подключаемого модуля API, а затем открывает проект в новом окне Visual Studio Code.
Примечание
Ключ подтверждения для обмена кодом (PKCE) включен по умолчанию. Если ваш сервер удостоверений не поддерживает PKCE, отключите его, добавив следующую строку в m365agents.yml в проекте агента.
isPKCEEnabled: false
Подготовка и загрузка неопубликованного агента
Загрузка неопубликованных приложений делает содержащий агент и его действие API доступными для тестирования при разработке. Он не устанавливает подключаемый модуль API как независимую возможность. Эта процедура не является общим методом распространения для составленного пакета подключаемого модуля. Способы совместного использования и публикации см. в разделе Выбор способа публикации и распространения подключаемого модуля.
Откройте проект агента в Visual Studio Code.
Выберите значок набора средств агентов Microsoft 365 на панели действий слева.
В области "Учетные записи " выберите "Войти в Microsoft 365". (Если вы уже вошли в систему, перейдите к следующему шагу.)
Убедитесь, что в учетной записи Microsoft 365 отображаются параметры "Отправка пользовательских приложений" и "Доступ Copilot включен". Если это не так, проведите проверку у администратора организации. Подробные сведения см. в разделе Требования к параметрам расширяемости Copilot.
На панели "Жизненный цикл " выберите "Подготовка".
Когда будет предложено ввести идентификатор клиента для регистрации OAuth..., введите идентификатор клиента плагина.
Когда будет предложено ввести секрет клиента для регистрации OAuth..., введите секрет клиента плагина.
Прочтите сообщение в диалоговом окне и выберите «Подтвердить », чтобы продолжить.
Подождите, пока набор средств сообщит о завершении подготовки.
Теперь агент доступен для тестирования с вашей учетной записью пользователя в Microsoft 365 Copilot в Microsoft Teams.
Тестирование действия API агента
Откройте Teams в браузере и войдите с помощью учетной записи Microsoft 365, которую вы использовали для загрузки агента.
На панели действий слева выберите пункт Chat.
Выберите Copilot на панели Chat.
Выберите средство отслеживания бюджета в списке агентов справа. Если список недоступен, выберите значок "Чаты и прочее Copilot " в правом верхнем углу.
Задайте вопрос о бюджете. Например, попробуйте
How much is left in the Fourth Coffee lobby renovation budget?. При появлении запроса выберите "Всегда разрешать " или "Разрешать" один раз , чтобы продолжить.Когда вам будет предложено войти, выберите "Войти в средство отслеживания бюджета".