Добавляйте инструменты в пользовательские агенты

Инструменты — это строительные блоки, позволяющие агенту взаимодействовать с внешними системами. Инструменты расширяют возможности вашего агента, позволяя выполнять различные действия в ответ на запросы пользователя или автономные триггеры. Каждый инструмент представляет собой конкретную возможность, которую ваш агент может реализовать. Например, вы можете оснастить агента инструментами, которые выполняют такие задачи, как:

Отправляйте письма через Office 365 Outlook коннектор
Проверьте текущие погодные условия и прогнозы
Читайте и записывайте данные из Dataverse
Читайте и публикуйте сообщения в Teams

Механизмы добавления инструментов в агенты

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

С помощью генеративной оркестрации (активной по умолчанию) ваш агент может автоматически выбрать наиболее подходящий инструмент или тему, либо искать информацию по знаниям, чтобы ответить пользователю. Этот режим оркестрации создаёт более динамичный и интеллектуальный опыт общения.

В классическом режиме (генеративная оркестрация отключена) агент может использовать только темы для ответа пользователю. Однако вы всё равно можете спроектировать агента так, чтобы инструменты вызывали явно внутри тем.

Существует несколько доступных механизмов для добавления инструментов к вашему агенту:

Connector: Подключайтесь к проприетарным API и сервисам с помощью Power Platform Connectors для получения данных или выполнения действий.
- Готовый коннектор: выберите из выбора заданных соединений к тысячам популярных API как от Microsoft, так и от не-Microsoft services.
- Пользовательский разъём: Определите соединение с пользовательским сервисом или системой для включения опций пользовательских инструментов с помощью разъёмов Power Platform. Для использования разъёма соединителю необходимо права на просмотр и совместное использование для организации.
Поток агентов: определите поток агентов, включая одно или несколько действий для выполнения.
Подсказка: Подсказка на основе одноходной модели, которая может ссылаться на предоставленные вами знания и генерировать код для анализа данных.
REST API: Определите соединение с REST API и выберите одну или несколько конечных точек и методов API для добавления в качестве инструментов.
Протокол контекста модели: подключитесь к MCP-серверу для доступа к инструментам и ресурсам.
Использование на компьютере: позволяет агенту взаимодействовать с любой системой с графическим интерфейсом — для сайтов и десктопных приложений, выбирая кнопки, меню и вводя текст в поля на экране.

Есть ещё два механизма для добавления инструментоподобного поведения к вашему агенту:

Навыки: Контейнер для набора связанных инструментов.
Инструмент клиента: отправьте событие клиенту, чтобы тот выполнил действие и вернул ответ.

Для получения дополнительной информации о навыках и клиентских инструментах смотрите ссылки в разделе «Связанный контент ».

Создайте и добавьте новый инструмент на уровне агента

Создание новых инструментов непосредственно внутри Copilot Studio упрощает процесс разработки и обеспечивает правильную интеграцию с вашим агентом. Инструменты, добавленные агенту, доступны для автоматической координации всех разговоров вашего агента.

Откройте своего агента, выбрав «Агенты » в левой панели навигации и выбрав своего агента из списка.
Перейдите на страницу Tools для агента.
Выберите "Добавить инструмент".
В панели «Добавить » выберите « Новый инструмент».
Выберите тип инструмента, который хотите добавить, из появления списка:
- Prompt
- Поток агента
- Использование компьютера
- Настраиваемый соединитель
- Протокол контекста модели
- REST API
Выполните шаги настройки, соответствующие выбранному инструменту. Например, если вы выберете Prompt, необходимо выполнить следующие шаги:
- Определите шаблон запроса и инструкции
- Задайте входные параметры
- Настройка источников знаний
- Формат отклика и ограничения
Выберите Сохранить или Опубликовать (по мере необходимости) для создания нового инструмента.
Выберите Добавить и настроить. Инструмент добавляется в ваш агент. Появляется страница настройки вашего инструмента. Вы можете просматривать и вносить изменения в конфигурацию инструмента здесь.

Новый инструмент можно увидеть на странице «Инструменты » для агента.

Просмотр и внесение изменений в конфигурацию инструмента

Вы можете просматривать и редактировать конфигурацию вашего инструмента в любое время: перейдите на страницу «Инструменты » вашего агента и выберите инструмент из списка инструментов.

Открывается страница настройки вашего инструмента. Детали представлены в трёх разделах:

Сведения
Входные данные
Completion

Для MCP-серверов, подключённых как агентные инструменты, страница конфигурации отличается от других типов инструментов. Раздел «Детали» похож, но вместо «Входные данные» и «Завершение» есть разделы «Инструменты и ресурсы» с информацией о доступных инструментах и ресурсах для сервера MCP. Для получения дополнительной информации см. раздел «Просмотр инструментов и ресурсов в существующем сервере MCP».

Сведения

Раздел «Детали» позволяет настроить базовые детали вашего инструмента.

Здесь вы можете посмотреть и обновить:

Название: Название инструмента. Это имя появляется в списке инструментов для вашего агента. Выберите имя, которое чётко указывает на функцию инструмента.
Описание: Описание инструмента. Генеративная оркестрация опирается на это описание, чтобы определить, когда агент должен использовать инструмент. Напишите чёткие, конкретные описания, включая то, что делает инструмент и когда им следует пользоваться.
Дополнительные сведения.
- Позвольте агенту динамически решать, когда использовать инструмент: Когда выбрана эта опция, агент может использовать генеративную оркестрацию для определения времени использования инструмента. Если эта опция не выбрана, агент использует инструмент только тогда, когда он явно вызывается из темы. (По умолчанию эта опция выбирается при включённой генеративной оркестрации.)
- Спросите у конечного пользователя перед запуском: в общем чате с конечной пользовательской аудиторией перед запуском инструмента попросите агента подтвердить. Эта опция по умолчанию установлена как «Нет ».
- Аутентификация: Выберите использовать ли для инструмента учетные данные пользователя (конечный пользователь) или создателя (предоставленные Maker). По умолчанию применяется аутентификация пользователя.
- Описание: По желанию вы можете добавить описание инструмента, который агент показывает пользователю, когда хочет запустить инструмент. Это описание сообщает пользователю, что от него требуется аутентифицировать.

Входные данные

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

По умолчанию значение Fill с использованием столбца для каждого входа устанавливается на Динамически заполнять с помощью AI. Агент пытается извлечь значение из доступного контекста — например, из сообщения пользователя. Если не найдено соответствующее значение, возникает вопрос, который нужно задать пользователю. Выберите «Настраивать », чтобы получить более тонкие настройки для сбора и заполнения вводных данных:

Отображаемое имя и описание: Как ввод воспринимается пользователем.
Идентифицировать как: Как интерпретируется ответ пользователя, например, как строка текста или сопоставлена с заранее определённой сущностью.
Повторить логику: если агент не идентифицирует сущность в пользовательском операторе, он может задать вопрос снова.
Проверка ввода: Настройте дополнительное поведение валидации на ввод пользователя, выходящее за рамки стандартного типа сущности.

Вы также можете переопределить вход с явным значением вместо того, чтобы агент его извлекал. Чтобы задать перезачёт, уведите Fill с пользовательским значением, введите значение, выберите переменную или используйте формулу Power Fx. Если вход переопределён, агент не запрашивает пользователя о значении.

Completion

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

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

В качестве альтернативы вы можете написать конкретный, отформатированный ответ, чтобы ваш инструмент вернулся. Вы можете вставлять ссылки на выходные переменные из инструмента с помощью переменного picker. Вы также можете использовать формулы Power Fx для форматирования ответа.

В разделе « После запуска» выберите один из нескольких вариантов того, как инструмент должен реагировать на пользователя после запуска:

Не отвечать (по умолчанию): агент включает выходные данные инструмента в свой ответ
Пишите ответ с помощью генеративного ИИ: Пусть ИИ создаёт контекстуальный ответ, используя выходные данные инструмента
Отправьте конкретный ответ: Создайте шаблонный ответ с вставкой переменных
Отправьте адаптивную открытку: создайте насыщенные, интерактивные ответы с помощью кнопок и действий

Вы также можете настроить, какие выходные переменные будут доступны агенту и другим инструментам.

Выбор инструментов и сбор входных данных

Когда вы определяете инструмент в Copilot Studio, вы также предоставляете информацию, описывающую его назначение. Эта информация позволяет агенту определить, когда использовать инструмент. Описание инструмента также помогает оркестратору использовать генеративный ИИ для генерации вопросов по мере необходимости, чтобы собрать входные данные. Ваш агент может использовать вопросы для сбора информации и выполнения необходимых для использования инструмента. В результате вам не нужно вручную создавать узлы вопроса, чтобы собрать все необходимые входные данные, например, входные данные в потоке. Orchestrator агентов занимается сбором входных данных во время выполнения.

Агент учитывает несколько факторов для определения выбора инструмента:

Название и описание инструмента
Текущий контекст разговора
Пользовательское намерение, вытекающее из их сообщения
Доступные входы и выходы
Предыдущее использование инструмента в разговоре

При использовании генеративного режима по умолчанию инструменты возвращают свою информацию агенту. С помощью ответа инструмента агент может генерировать контекстный ответ на запрос пользователя. В качестве альтернативы вы можете инструктировать инструмент всегда отвечать сразу — либо генерируя сообщение, либо создавая явное сообщение.

Tip

При использовании сгенерированных вопросов из инструмента сообщайте пользователям, что часть диалога сгенерировал ИИ.

Например, добавьте дополнительное сообщение в тему системы «Начало разговора ». Эта тема определяет сообщение, которое показывают пользователям при начале нового разговора.

Вызовите существующий инструмент внутри темы

Вы можете явно вызвать инструмент внутри темы. В зависимости от вашего сценария, вы можете использовать инструмент как часть более широкой темы, которая использует несколько узлов. Или, как в следующем примере, добавление одного узла действия (инструмента) в тему может быть всем, что вам нужно.

Чтобы вызвать инструмент внутри темы:

В Copilot Studio перейдите на страницу Topics для агента, которого хотите отредактировать.
Создайте новую тему и дайте ей имя, например, «Узнать погоду».
Добавьте соответствующие триггерные фразы. Продолжая пример с погодой из предыдущего шага, триггерные фразы могут включать:
- Пойдёт ли дождь
- Сегодняшний прогноз
- Узнать погоду
- Какая погода
Выберите «Добавить узел (+), затем выбрать «Добавить инструмент».
Выберите инструмент из доступных инструментов. Есть три вкладки, показывающие разные типы инструментов:
- Базовые средства
- Connector
- инструмент
Ваш узел Action теперь добавлен в вашу тему.
Нажмите Сохранить.

Информация о разъёмах MCP

Для разъёма MCP вы можете просмотреть названия и описания инструментов и ресурсов MCP, предоставляемых этим разъёмом. Информация о инструментах и ресурсах отображается в таблице, по одной строке для каждого инструмента.

Вопросы аутентификации для инструментов

Некоторые инструменты требуют аутентификации для корректной работы, например, Dynamic Prompt или другие, вызывающие API Dataverse. Правильная конфигурация аутентификации обеспечивает безопасность при сохранении плавного пользовательского опыта.

Инструменты всегда запускаются в условиях выполнения агента в пользовательском контексте и не могут быть запущены без включения аутентификации. Поддерживаются два типа методов аутентификации:

Учетные данные конечного пользователя: агент использует учетные данные пользователя для аутентификации с сервисом. Этот метод гарантирует, что пользователи получают доступ только к тем данным, которые им разрешено видеть.
Учетные данные, предоставленные создателем: агент использует учетные данные автора для аутентификации в сервисе. Используйте этот режим аутентификации для общих ресурсов или когда пользователям не нужен индивидуальный доступ.

Протестируйте свой инструмент

При генеративной оркестрации оркестратор выбирает ваш инструмент, когда считает его релевантным к пользовательскому запросу.

В качестве альтернативы можно вызвать существующий инструмент внутри темы.

Включите или выключите инструмент в вашем агенте

Вы можете включить или выключить инструмент для вашего агента на странице настройки инструмента. Отключение инструмента блокирует использование агента, но инструмент всё равно подключён к агенту и может быть включен позже. Когда вы добавляете инструмент к агенту, инструмент по умолчанию включён.

Чтобы отключить инструмент в агенте:

Перейдите к своему агенту и выберите страницу «Инструменты » для вашего агента.
Выберите инструмент, чтобы перейти на страницу настройки инструмента.
В верхней части страницы настройки отключите инструмент с помощью переключателя «Включено ».
Нажмите кнопку Сохранить , чтобы применить изменение.

Инструмент всё ещё отображается в списке инструментов агентов, но больше не включён.

Удалите инструмент из вашего агента

Отключение инструмента блокирует его использование, но также даёт вам гибкость для включения его позже. Вы также можете навсегда удалить инструмент у вашего агента. Чтобы удалить инструмент из вашего агента:

Перейдите к своему агенту и выберите страницу «Инструменты » для вашего агента.
Найдите инструмент в списке инструментов и наведите курсор на имя инструмента. Выберите три точки (...).
Нажмите кнопку "Удалить". Откроется окно подтверждения.
Выберите Удалить, чтобы удалить инструмент.

Инструмент исчезает из списка инструментов агентов.

Note

Вы можете удалить инструменты только со страницы инструментов агентов. Вы не можете удалить инструменты с основной страницы Copilot Studio Tools.

Ограничения на инструменты в агентах

При использовании генеративной оркестрации оркестратор может работать максимум с 128 инструментами на один агент. Однако для наилучшей производительности и результатов мы рекомендуем ограничить количество инструментов в вашем агенте не более чем 25-30.
При использовании многоагентной оркестрации с дочерними агентами дочерние агенты имеют собственную оркестрацию и могут управлять набором до 128 инструментов.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-04-22