Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Декларативные агенты работают в инфраструктуре управляемой оркестрации и языковой модели Microsoft 365 Copilot. Вы настраиваете инструкции, источники знаний и поддерживаемые возможности агента, а не внедряете и размещаете собственную среду выполнения бесед.
Агент может использовать источники знаний Microsoft 365, встроенные возможности, такие как интерпретатор кода, пользовательские навыки (предварительная версия) и действия, предоставляемые серверами MCP или REST API. Он также может делегировать задачи подключенным агентам. Доступность зависит от средства разработки, версии манифеста, целевого интерфейса, лицензирования и политик организации.
Эта статья поможет понять границу между управляемой платформой и компонентами, которые вы настраиваете или используете. Сравнение с архитектурой, которая обеспечивает управление оркестрацией и размещением моделей, см. в статье Сравнение декларативных и пользовательских агентов подсистемы.
Компоненты архитектуры
Microsoft 365 Copilot предоставляет среду выполнения, которая интерпретирует запросы пользователей, извлекает соответствующий контекст, выбирает возможности и генерирует ответы. Конфигурация и внешние службы определяют, что агент может использовать для выполнения задачи.
| Компонент | Управляемая платформа | Обязанности разработчика |
|---|---|---|
| Клиент | Проводит беседы в поддерживаемых интерфейсах Microsoft 365. | Выберите целевые взаимодействия и протестируйте поддерживаемые взаимодействия, контекст документа и форматы ответов. |
| Инфраструктура | Содержит оркестрацию Copilot и среду выполнения модели. | Настройте агент и разместите все внешние API, серверы MCP или другие службы, которые он использует. |
| Каталог и распространение | Предоставляет поддерживаемые возможности приобретения, публикации и администрирования. | Выберите поддерживаемый пакет и маршрут распространения, сохраняйте версии и работайте с администраторами над доступом и развертыванием. |
| Безопасность и соответствие требованиям | Применяет средства защиты удостоверений, доступа к данным и платформы Microsoft 365. | Настраивайте разрешения и проверку подлинности, оценивайте потоки данных и применяйте авторизацию и защиту данных во внешних службах. |
| Оркестратор и языковая модель | Выбирает и вызывает возможности, а также генерирует ответы. | Напишите инструкции и описания инструментов, настройте поддерживаемые параметры поведения и оцените результирующее поведение. Вы не замените управляемый оркестратор пользовательским кодом среды выполнения. |
| Знания и возможности | Извлекает поддерживаемые знания и запускает встроенные возможности. | Выберите соответствующие источники и возможности, подтвердите доступ пользователей и проверьте качество извлечения. |
| Вызов инструментов | Вызывает настроенные действия MCP или API через поддерживаемую интеграцию. | Определите входные и выходные данные инструмента, настройте проверку подлинности и подтверждения, а также реализуйте надежное поведение службы. |
Поддерживаемые параметры конфигурации влияют на управляемую среду выполнения; они не дают вам полного контроля над его реализацией. Например, манифест поддерживает режим ответа по умолчанию, который пользователи могут переопределить. Следуйте выбранной схеме манифеста и инструменту разработки для доступных параметров.
Примечание
Полученное содержимое и ответы средств могут содержать ненадежные инструкции. Средства защиты платформы не заменяют проверки авторизации в ваших службах или оценку поведения агента. Спланируйте применимые требования к данным, конфиденциальности и безопасности.
Поток данных декларативного агента
Следующая схема описывает, как агент использует свою конфигурацию и возможности. Это не фиксированная последовательность выполнения и не гарантия количества извлечений или вызовов средств.
- Получите запрос. Пользователь отправляет запрос в поддерживаемом интерфейсе. Журнал бесед и доступный контекст приложения могут влиять на запрос.
- Выберите соответствующий контекст и возможности. Copilot использует инструкции агента, конфигурацию знаний и описания инструментов, чтобы определить, как удовлетворить запрос.
- Получение информации или вызов действий. Copilot извлекает доступные сведения или вызывает включенную возможность. Внешние действия используют настроенное поведение проверки подлинности и подтверждения. Внешние службы применяют собственные правила авторизации и бизнес-политики.
- Сгенерируйте ответ. 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 вместо того, чтобы полагаться только на ограниченный веб-поиск.
Эти требования не всегда исключают декларативный агент в качестве диалогового интерфейса. Служба может владеть бизнес-процессом, пока агент собирает входные данные, вызывает поддерживаемое действие и представляет результат.