Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Когда пользователи взаимодействуют с декларативным агентом в Microsoft 365 Copilot Chat, он может подключаться к другим агентам для получения дополнительных сведений или выполнения действий. Эти связи объявляются в манифесте агента, перечисляя идентификаторы заголовков агента в свойстве worker_agents . Во время выполнения Copilot Chat выступает в качестве посредника, опосредующего взаимодействие: пользователи видят обмен между агентами, но им не нужно самостоятельно выбирать подключенных агентов.
Примечание
Подключенные агенты, объявленные манифестом, представляют собой механизм, отдельный от API Copilot Chat, который обеспечивает диалоговое взаимодействие на базе Microsoft 365 Copilot в ваших собственных приложениях.
Примечание
Пользователи должны приобрести каждого подключенного агента, прежде чем они смогут их использовать. Дополнительные сведения см. в статье Развертывание подключенных агентов для пользователей в организации.
При взаимодействии пользователя с декларативным агентом, агент может делегировать часть задачи подключенному агенту. Microsoft 365 Copilot оценивает подключенные агенты, объявленные в манифесте, и выбирает один из них на основе текущей задачи и имени, описания и примеров запросов подключенного агента. Copilot отправляет текстовый запрос выбранному подключенному агенту, получает текстовый ответ и включает этот ответ в текущее взаимодействие декларативного агента с пользователем.
Когда использовать подключенные агенты
Используйте подключенные агенты, чтобы разделить или объединить агентов разных функций или команд разработчиков.
Расширение возможностей одного агента
Большие языковые модели (LLM) имеют ограниченное полезное контекстное окно и набор возможностей. Надежность одного агента LLM начинает снижаться по мере извлечения дополнительных документов или включения инструментов. Если качество агента снизилось после добавления дополнительных знаний или возможностей, выделите некоторые из этих возможностей в другой агент и подключитесь к нему. Существующий агент отправляет только те сведения о задаче, которые необходимы подключенному агенту для выполнения своей части. Подключенный агент работает в собственном контекстном окне, без других документов или возможностей, присутствующих в диалоге с пользователем.
Интеграция с агентами, разработанными извне
Декларативные агенты могут упростить работу с другими командами разработчиков. Каждая команда разработчиков может сосредоточиться на возможностях и качестве своего агента, используя подключенные агенты для интеграции с другими агентами. Как и в случае с микросервисами, каждый агент можно разрабатывать, не влияя на другие агенты. В отличие от микрослужб, агенты могут продолжать взаимодействовать друг с другом даже при изменении их интерфейсов.
Совместное использование возможностей агента для нескольких сценариев
Агент может хорошо работать с набором документов и действий, но по-прежнему быть сложным для пользователей. Рассмотрим агента, который понимает таблицы и данные реляционной базы данных клиентов и продаж. Этот агент может быть полезен как супервайзерам магазинов для управления запасами, так и бизнес-аналитикам для создания отчетов перед руководителями. Если бы этот агент можно было подключить к агенту, предназначенному для руководителей магазинов с начальным началом разговора и инструкциями, а также к агенту, адаптированному для бизнес-аналитиков. Оба типа пользователей могут получить больше пользы от использования агентов, адаптированных к их сценарию.
Включение подключенных агентов
Необходимо зарегистрировать подключенных агентов в реестре агентов Microsoft Agent 365. Подключайтесь к другим агентам, включая идентификаторы должностей агентов в манифест существующего декларативного агента. Другой агент должен быть декларативным агентом или иметь зарегистрированную карточку агента Agent2Agent.
Сначала получите идентификатор продукта агента для подключения. Идентификатор заголовка агента — это строка из одной буквы, символа подчеркивания и идентификатора GUID. Декларативный агент находится в выходных данных команды Подготовить в наборе средств агентов Microsoft 365 или в режиме разработчика. Регистрация агента Microsoft 365 является id собственностью объекта agentRegistration.
Добавьте идентификатор заголовка в свойство worker_agents как .id Свойство worker_agents было добавлено в схему декларативного агента версии 1.6.
Проверка подлинности и авторизация
Подключение к декларативному агенту зависит от существующей проверки подлинности пользователя в Microsoft 365 Copilot, так как декларативный агент работает в Microsoft 365 Copilot Chat. Для внешних агентов, зарегистрированных в Microsoft Agent 365, регистрация агента должна указать, как Microsoft 365 Copilot проходит проверку подлинности для внешнего агента. Вместо встраивания конфигурации проверки подлинности непосредственно в регистрацию агента, регистрация ссылается на существующую регистрацию проверки подлинности через authorization объект в agentRegistration. Такое разделение позволяет управлять конфигурацией проверки подлинности независимо от определений агентов. Дизайн отражает манифесты плагинов API.
Синтаксис
{
"type": "None | OAuthPluginVault",
"referenceId": "{string}"
}
Свойство type определяет схему аутентификации, используемую внешним агентом.
OAuthPluginVaultиспользует регистрацию единого входа Microsoft Entra. Это referenceId значение, созданное Microsoft Entra SSO registration ID на портале разработки Teams. Дополнительные сведения см. в статье "Использование портала разработчика Teams ".
Возможность использования подключенного агента определяется отдельно от проверки подлинности. Пользователи должны иметь доступ к подключенному агенту, получив его самостоятельно или с помощью развертывания администратором. Администраторы должны установить внешние агенты, зарегистрированные в Microsoft Agent 365 для пользователя.
Рекомендации
Декларативные агенты выбирают, к каким агентам подключиться, на основе запросов , description, и примеров запросов nameподключенного агента. Для декларативного агента примеры подсказок — это text поле conversation_starters в манифесте. Для agentRegistration это examples свойство AgentSkill объекта в карте агента. Описание агента должно описывать как людям, так и агентам, что агент может делать. Например, рассмотрим это описание для агента, который работает со структурированными данными о продажах видеоигр.
A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.
Примеры запросов должны информировать пользователей и агентов о типах запросов, которые может обрабатывать агент. Пользователи могут использовать разные термины для одного и того же понятия, поэтому стоит рассмотреть возможность изменения формулировки вариантов начала разговора. Например, при работе с юридическими делами хорошие пользователи могут также использовать термины "дело", "дело", "клиент" и "проблема". Подключенными агентами используется только text поле начала беседы.
Ограничения
Активный агент отправляет SMS только подключенному агенту. Декларативные агенты возвращают текст или адаптивные карточки. Агенты с карточками агентов Agent2Agent возвращают текст, двоичные файлы изображений Base64 и файлы Base64.
Когда пользователю предлагается подтвердить вызовы подключаемого модуля API, подключенному агенту, все адаптивные карты отправляются активному агенту. Пользователь не видит адаптивную карту и не может использовать диалоговое окно. Однако активный агент обрабатывает содержимое данных адаптивной карты.