Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Оркестратор Microsoft 365 Copilot координирует языковую модель, доступный контекст и возможности, которые она использует для ответа на запрос пользователя. Для декларативных агентов эти возможности могут включать извлечение знаний, встроенные возможности и действия, предоставляемые плагинами MCP или API.
В этой статье основное внимание уделяется тому, как конфигурация агента влияет на выбор действия и вызов. Вы предоставляете инструкции, определения инструментов и внешних служб; Управление средой диалогового взаимодействия осуществляется корпорацией Майкрософт. Более широкое разделение обязанностей см. в статье Архитектура декларативного агента.
Оркестратор Copilot
Оркестратор использует конфигурацию агента и доступный контекст, чтобы определить, следует ли отвечать напрямую, получать сведения или вызывать инструмент. Не каждый запрос требует внешнего действия.
Например, пользователь может спросить: "Какие билеты назначены мне сейчас?" Агент с соответствующим действием по тикетам может получать текущую информацию из службы тикетов, а не полагаться на знания модели.
На следующей схеме показано взаимодействие API-действия. Это концептуальный подход, а не фиксированная последовательность выполнения или гарантия того, что каждый запрос использует Microsoft Graph или внешний API.
- Интерпретируйте запрос. Copilot использует запрос, инструкции для агента, журнал бесед и доступный контекст приложения, чтобы определить задачу пользователя. Проверки безопасности и политик платформы могут повлиять на ход выполнения запроса и на его характер.
- Выберите соответствующие возможности. Copilot определяет, могут ли помочь настроенные знания или инструменты. Для внешнего действия описания плагинов и инструментов помогают определить подходящую операцию.
- Определите входные данные и вызовите средство. Copilot сопоставляет доступную информацию с параметрами средства. Инструкции должны направлять его на запрос недостающей необходимой информации, а не на изобретение ценностей. Для внешних звонков используется настроенное поведение проверки подлинности и подтверждения.
- Интерпретируйте результат. Copilot использует возвращенные данные или ошибки для определения следующего шага. Взаимодействие может включать в себя еще один звонок, запрос на уточнение или ответ пользователю.
- Ответ пользователю. Copilot создает ответ, используя доступный контекст и результаты. Ответ должен отражать фактическое возвращение или изменения службы.
Декларативные агенты поддерживают цепочку вызовов функций, включая передачу выходных данных одного вызова API в другой и объединение действий API со знаниями SharePoint или интерпретатором кода. Проектируйте и тестируйте необходимые взаимодействия, а не предполагайте, что фиксированное количество вызовов всегда завершаются по очереди. Следуйте текущим ограничениям подключаемого модуля и ограничениям ваших внешних служб.
Защита платформы и подтверждение пользователями не заменяют авторизацию или проверки бизнес-правил во внешней службе. Если рабочий процесс требует точного порядка выполнения, транзакций или восстановления, реализуйте эти требования в службе, а не полагайтесь на инструкции модели.
Как оркестратор Copilot сопоставляет действия с запросами пользователя
Выбор плагина и вызов отдельного инструмента — это разные решения. Описание плагина помогает Copilot определить соответствующую службу или домен. Затем инструменты, доступные в этом плагине, описывают операции, которые может вызывать Copilot, и необходимые для них входные данные.
Когда при выборе плагина используется семантическое сопоставление, оно основано на описании плагина, а не на описаниях отдельных функций. Соответствующий плагин делает свои функции или инструменты доступными; Это не фиксированный короткий список из пяти функций. Текущее поведение выделения и ограничения контекста см. в разделе Ограничения подключаемого модуля MCP и API.
Предоставьте полезные описания для каждого уровня:
| Настройка | Что описать |
|---|---|
| Описание плагина | Цель службы, поддерживаемые задачи пользователя и домен. Сделайте описание достаточно конкретным, чтобы отличать его от других плагинов. |
| Определение функции или инструмента | Цель операции, время ее использования, извлечение или изменение данных. Для плагинов API сопоставьте имя функции с OpenAPI operationId. |
| Параметры | Обязательные входные данные, типы, форматы и значимые примеры. Отличайте идентификаторы от отображаемых имен и четко формулируйте поведение необязательных пользователей. |
| Результаты и ошибки | Возвращаемые данные, сведения об успешной операции и представление сбоев. Сохраняйте полезные данные, соответствующие задаче. |
Для плагинов API перейдите в раздел Создание эффективных описаний OpenAPI. Для плагинов MCP проверка, обнаруживаются ли определения инструментов динамически или закрепляются в манифесте плагина. При динамическом обнаружении изменения в определениях инструментов сервера могут повлиять на выбор без повторной публикации агента.
Улучшение и оценка выбора действия
Описания и инструкции влияют на выбор. Они не гарантируют, что конкретное средство вызывается для каждой формулировки запроса.
- Уточнение перекрывающихся операций. Если вам подходят несколько инструментов, объясните их различные цели и требуемые входные данные. Различайте операции чтения и операции, которые изменяют данные.
- Свяжите задачи с инструментами в инструкции. Объясните, когда следует использовать настроенные средства, как собирать недостающие сведения и как использовать более ранние результаты в последующих запросах. См. инструкции для агентов с плагинами API.
- Фокусируйте все доступные средства. Показать операции, необходимые для задач агента. Большее количество определений инструментов и более крупных полезных нагрузок потребляют контекст и могут снизить качество отклика.
- Проверьте фактический выбор и результаты. Включайте перефразированные запросы, неоднозначные запросы, отсутствующие входные данные, многошаговые задачи, отмененные подтверждения и сбои служб. Проверьте операции и параметры, полученные сервисом, а не только окончательную формулировку.
- Повторите тесты при изменении определений. Повторно запускайте репрезентативные случаи после изменений в описаниях плагинов, определениях инструментов, инструкциях или платформе. Включение обновлений сервера MCP при использовании динамического обнаружения.
Важно
Отсутствующий или неполный ответ в беседе не позволяет определить, была ли выполнена внешняя операция. Проверьте результаты службы перед повторной попыткой выполнения операции, изменяющей данные, и спроектируйте службу для безопасной обработки повторяющихся запросов.
Более широкие рекомендации по проектированию см. в статье Рекомендации по декларативному агенту. Повторяемые тестовые случаи и утверждения см. в статье Обзор оценки агента.