Архитектура декларативного агента

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

Агент может использовать источники знаний Microsoft 365, встроенные возможности, такие как интерпретатор кода, пользовательские навыки (предварительная версия) и действия, предоставляемые серверами MCP или REST API. Он также может делегировать задачи подключенным агентам. Доступность зависит от средства разработки, версии манифеста, целевого интерфейса, лицензирования и политик организации.

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

Компоненты архитектуры

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

Схема архитектуры декларативного агента.

Компонент Управляемая платформа Обязанности разработчика
Клиент Проводит беседы в поддерживаемых интерфейсах Microsoft 365. Выберите целевые взаимодействия и протестируйте поддерживаемые взаимодействия, контекст документа и форматы ответов.
Инфраструктура Содержит оркестрацию Copilot и среду выполнения модели. Настройте агент и разместите все внешние API, серверы MCP или другие службы, которые он использует.
Каталог и распространение Предоставляет поддерживаемые возможности приобретения, публикации и администрирования. Выберите поддерживаемый пакет и маршрут распространения, сохраняйте версии и работайте с администраторами над доступом и развертыванием.
Безопасность и соответствие требованиям Применяет средства защиты удостоверений, доступа к данным и платформы Microsoft 365. Настраивайте разрешения и проверку подлинности, оценивайте потоки данных и применяйте авторизацию и защиту данных во внешних службах.
Оркестратор и языковая модель Выбирает и вызывает возможности, а также генерирует ответы. Напишите инструкции и описания инструментов, настройте поддерживаемые параметры поведения и оцените результирующее поведение. Вы не замените управляемый оркестратор пользовательским кодом среды выполнения.
Знания и возможности Извлекает поддерживаемые знания и запускает встроенные возможности. Выберите соответствующие источники и возможности, подтвердите доступ пользователей и проверьте качество извлечения.
Вызов инструментов Вызывает настроенные действия MCP или API через поддерживаемую интеграцию. Определите входные и выходные данные инструмента, настройте проверку подлинности и подтверждения, а также реализуйте надежное поведение службы.

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

Примечание

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

Поток данных декларативного агента

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

  1. Получите запрос. Пользователь отправляет запрос в поддерживаемом интерфейсе. Журнал бесед и доступный контекст приложения могут влиять на запрос.
  2. Выберите соответствующий контекст и возможности. Copilot использует инструкции агента, конфигурацию знаний и описания инструментов, чтобы определить, как удовлетворить запрос.
  3. Получение информации или вызов действий. Copilot извлекает доступные сведения или вызывает включенную возможность. Внешние действия используют настроенное поведение проверки подлинности и подтверждения. Внешние службы применяют собственные правила авторизации и бизнес-политики.
  4. Сгенерируйте ответ. Copilot использует доступный контекст и результаты возможности для ответа. В зависимости от задачи взаимодействие может включать дальнейшие вызовы, запросы на ввод данных пользователем или делегирование подключенному агенту.

Декларативные агенты могут связывать вызовы API, использовать выходные данные одного вызова в качестве входных данных другого вызова и объединять знания SharePoint или интерпретатор кода с действиями API. Поддерживаемые шаблоны и примеры см. в разделе Chaining function calls in API plugins.

Руководство по инструкциям поведения модели; Они не заменяют логику приложения, которая должна обеспечивать транзакцию, точный порядок выполнения или процедуру восстановления. Реализуйте эти требования в API или сервисе рабочих процессов либо оцените архитектуру пользовательского движка, когда вам нужно владеть оркестрацией.

Проектирование с учетом ограничений для конкретных возможностей

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

Область Продуманный дизайн Рекомендация
Конфигурация агента Используйте свойства и возможности, поддерживаемые выбранной версией схемы и средством разработки. Ссылка на манифест декларативного агента
Получение знаний Выбирайте релевантные источники и следуйте требованиям к файлам, области, доступу и индексированию для конкретного источника. Ответ не обязательно включает все элементы источника. Источники знаний и оптимизация получения контента
Определения инструментов и полезные данные Сфокусируйтесь на инструментах, а входные и выходные данные — релевантными. Большие входы и выходы плагинов могут быть усечены, а эффективные ограничения контекста могут меняться в зависимости от моделей и системных издержек. Ограничения подключаемого модуля MCP и API
Контекст документа Следуйте поддерживаемым интерфейсам с документами и форматам содержимого основного приложения, а не предполагайте, что все содержимое документа представлено одинаково. Взаимодействие с документами
Поведение и задержка службы Проверьте время отклика, сбои проверки подлинности, ошибки служб и ограничения внешних API или серверов MCP. Интеграция и тестирование компонентов

Для больших наборов данных разрабатывайте API, чтобы фильтровать, агрегировать или возвращать соответствующее подмножество, а не отправлять все записи в диалог. Если сценарию требуется содержимое документа, протестируйте поддерживаемое взаимодействие с узлом: декларативные агенты могут получить доступ ко всему открытому документу в Word и PowerPoint с учетом формата документа.

Преимущества и ограничения

Основные преимущества и основные ограничения декларативных агентов позволяют определить, когда эта архитектура подходит для конкретных случаев использования.

Ключевые преимущества

Декларативные агенты предоставляют значительные преимущества организациям, которые хотят внедрить решения ИИ в существующих средах Microsoft 365:

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

Основные ограничения

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

  • Управляемая оркестрация: вы влияете на поведение с помощью поддерживаемой конфигурации, а не контролируете каждое решение среды выполнения. оценивать репрезентативные задачи, а не рассматривать инструкции как детерминированный механизм рабочего процесса;
  • Зависимости от платформы и узла: возможности, представление ответов, лицензирование и администрирование зависят от выбранного интерфейса Microsoft 365. Подтвердите поддержку в каждом целевом узле.
  • Ограничения контекста и извлечения: Результаты поиска знаний и инструментов должны соответствовать доступному контексту. Крупные источники или полезная нагрузка не гарантируют полного охвата в ответе.
  • Рекомендации по динамическому веб-контенту: Ограниченный веб-поиск использует содержимое, индексированное Bing, а не прямой запрос к базовому источнику данных. Динамически создаваемый контент может быть неполным или устаревшим. Используйте поддерживаемую интеграцию API, когда задача требует прямого доступа к актуальным структурированным данным. См. раздел "Граундинг веб-поиска" и динамическое содержимое.
  • Постоянная оценка: обновления платформы и модели могут изменить поведение. Инструкции тестирования, извлечение и использование средства по мере развития агента и его зависимостей.

Выравнивание вариантов использования

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

Оптимальные сценарии

Декларативные агенты оптимальны для:

  • Получение информации: агенты, которым в основном нужно искать и обобщать информацию из Microsoft 365 или внешних источников.
  • Вспомогательные действия: агенты, объединяющие знания и поддерживаемые действия API или MCP, чтобы помочь пользователям выполнить задачу.
  • Помощь с документооборотом и анализ: агенты, работающие с поддерживаемым контекстом документа или использующие такие возможности, как интерпретатор кода.
  • Повышение производительности: задачи, которые выигрывают от управляемого диалога в Microsoft 365.

Неподходящие сценарии

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

  • Настраиваемое управление средой выполнения: вы должны реализовать собственную оркестрацию, размещение модели или пользовательский интерфейс, а не использовать управляемую среду выполнения Copilot.
  • Устойчивые бизнес-процессы: система должна обеспечивать точный порядок выполнения, границы транзакций, повторные попытки или восстановление независимо от беседы.
  • Крупномасштабная обработка данных: Задача требует исчерпывающей обработки набора данных, а не извлечения или анализа соответствующего контекста разговора. Выполните эту обработку в службе и предоставьте агенту соответствующий результат.
  • Прямой доступ к динамическим источникам: Для выполнения задачи требуются текущие упорядоченные результаты из источника, который недостаточно представлен в веб-поиске. Предоставьте поддерживаемую интеграцию API или MCP вместо того, чтобы полагаться только на ограниченный веб-поиск.

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