Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Важно
Плагины MCP и API обеспечивают действия внутри декларативных агентов. Они не являются отдельными устанавливаемыми пакетами плагинов: только агент, содержащий их, может получить доступ к их функциям и инструментам. Сведения об отношении манифеста пакета и действия см. в разделе Подключаемые модули и декларативные действия агента.
Совет
Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.
Подключаемые модули API позволяют декларативному агенту вызывать REST API. Используйте набор средств агентов Microsoft 365 для создания проекта агента, манифеста подключаемого модуля API и реализации REST API в качестве отправной точки.
- Требования, указанные в разделе Требования к параметрам расширяемости Copilot
- Visual Studio Code
- Набор средств для агентов Microsoft 365
-
Node.js 20.x или 22.x. Чтобы проверить установленную версию, запустите
node --version.
Создание агента и API
Примечание
Снимки экрана и ссылки на пользовательский интерфейс в этой статье используют версию выпуска набора средств агентов Microsoft 365. Предварительные версии могут отличаться от пользовательского интерфейса.
Откройте Visual Studio Code. Если набор средств агентов еще не установлен, инструкции по установке см. в разделе Установка набора средств агентов .
Выберите значок набора средств агентов Microsoft 365 на панели действий слева.
Выберите Создать агент или приложение в области задач Agents Toolkit.
Выберите декларативный агент.
Выберите "Добавить действие", а затем выберите "Начать с нового API".
Выберите OAuth в качестве типа проверки подлинности.
Выберите предпочитаемый язык программирования: JavaScript или TypeScript. В этом руководстве предполагается использовать TypeScript.
Выберите расположение для проекта агента.
Введите
Repairs Agentв качестве имени для проекта агента.
После выполнения этих шагов Agents Toolkit создает файлы проекта агента и API, включая манифест подключаемого модуля API, и открывает проект в новом окне Visual Studio Code. Подробности см. в файле README.md в корневом каталоге сгенерированного проекта.
Запустите API и загрузите агент без публикации.
В окне Visual Studio Code с загруженным проектом агента выберите значок набора средств агентов Microsoft 365 на панели действий слева.
В области "Учетные записи " выберите "Войти в Microsoft 365". (Если вы уже вошли в систему, перейдите к следующему шагу.)
Убедитесь, что в учетной записи Microsoft 365 отображаются параметры "Отправка пользовательских приложений" и "Доступ Copilot включен". Если это не так, проведите проверку у администратора организации. Подробные сведения см. в разделе Требования к параметрам расширяемости Copilot.
Выберите значок "Выполнить и отладить " на панели действий слева.
Выберите "Отладка в Copilot (Edge) " или "Отладка в Copilot (Chrome)", а затем нажмите клавишу F5 , чтобы начать отладку.
Agents Toolkit собирает проект, создает пакет приложения, содержащий агент и конфигурацию подключаемого модуля API, и загружает агент для вашей учетной записи пользователя. Он также запускает API локально. В новом окне браузера откроется приложение Microsoft Teams.
Тестирование действия API агента
В Microsoft Teams в браузере выберите Copilot.
Выберите Repairs Agentlocal в списке агентов справа. Если список недоступен, выберите значок "Чаты и прочее Copilot " в правом верхнем углу.
Отправьте Copilot сообщение о ремонте. Например, попробуйте
Which repairs are assigned to Karin?.
На этом этапе REST API выполняется локально на компьютере разработки без проверки подлинности. Чтобы добавить проверку подлинности, разверните API в Azure.
Развертывание в Azure и включение проверки подлинности
Выберите значок набора средств агентов Microsoft 365 на панели действий слева.
На панели "Жизненный цикл " выберите "Подготовка".
Когда появится запрос на имя группы ресурсов, примите значение по умолчанию или измените его по желанию и нажмите клавишу ВВОД.
Выберите расположение для группы ресурсов.
Просмотрите сообщение в диалоговом окне. Если все выглядит правильно, выберите "Подготовить ", чтобы продолжить.
Дождитесь завершения подготовительных действий, а затем выберите "Развернуть " в области "Жизненный цикл ".
После выполнения этих действий REST API развертывается как функция Azure с проверкой подлинности. Агент вызывает этот размещенный API через конфигурацию подключаемого модуля API.
Тестирование агента с помощью аутентифицированного API
В Microsoft Teams в браузере выберите Copilot.
Выберите Repairs Agentdev в списке Агенты справа.
Отправьте Copilot сообщение о ремонте. Например, попробуйте
Which repairs are assigned to Issac?.