Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Подключаемые модули MCP и API — это настраиваемые действия, позволяющие декларативным агентам в Microsoft 365 Copilot взаимодействовать с серверами протокола контекста модели (MCP) или REST API с описанием OpenAPI. Используя один из этих плагинов, пользователи могут запросить у декларативного агента запрос к серверу MCP или REST API и, если эта функция поддерживается, создавать, обновлять и удалять данные и объекты с помощью запросов на естественном языке.
В этой статье используется плагин для технического пользовательского действия MCP или API, используемого декларативным агентом. Сведения о клиентском подключаемом модуле, пакете, реестре и жизненном цикле см. в статье Подключаемые модули для Microsoft 365 Copilot.
Во время создания или повторного использования используйте эту статью, чтобы выбрать действие MCP или API и понять, как оркестратор вызывает его. Вы заканчиваете с моделью технического действия и процедурой продукта для ее реализации. Результирующее действие является зависимостью агента, а не отдельным обещанием общедоступного распределения.
Важно
Плагины MCP и API обеспечивают действия внутри декларативных агентов. Они не являются отдельными устанавливаемыми пакетами плагинов: только агент, содержащий их, может получить доступ к их функциям и инструментам. Сведения об отношении манифеста пакета и действия см. в разделе Подключаемые модули и декларативные действия агента.
Подключаемый модуль API или MCP использует манифест подключаемого модуля, который Copilot считывает, чтобы узнать о доступном агенту сервере API или MCP. Затем Copilot может решить, когда агенту следует использовать эту интеграцию для ответа на запрос. Дополнительные сведения об этом манифесте см. в статье Схема манифеста подключаемого модуля API и MCP. Устанавливаемый пакет использует отдельный манифест приложения Microsoft 365.
Как Copilot обнаруживает инструменты сервера MCP
Для плагинов на основе MCP-сервера Copilot по умолчанию динамически разрешает инструменты плагина во время выполнения непосредственно с сервера MCP. Динамическое обнаружение средств означает, что вы получаете новейшие инструменты, предоставляемые сервером MCP, не дожидаясь переупаковки и повторной публикации агента. При создании агента разработчик может при желании закрепить фиксированный набор инструментов в манифесте плагина. Подключаемые модули REST API всегда используют инструменты, определенные в манифесте подключаемого модуля. Дополнительные сведения см. в статьях "Создание подключаемых модулей с сервера MCP для Microsoft 365 Copilot" и "Динамическое обнаружение инструментов для подключаемых модулей MCP" в Microsoft 365 Copilot.
Это значение по умолчанию применяется к подключаемым модулям MCP, используемым в качестве действий декларативного агента. Для подключаемого модуля, который ссылается на удаленный сервер MCP в agentConnectors манифесте приложения Microsoft 365, для динамического обнаружения инструментов требуется манифест приложения версии 1.29 или более поздней и узел, который это разрешает. Дополнительные сведения см. в статье Настройка удаленных серверов MCP для подключаемых модулей Microsoft 365 Copilot.
Пример подключаемого модуля
Рассмотрите возможность использования сервера бюджетов MCP, который позволяет запрашивать и создавать бюджеты, выставлять счета за расходы или добавлять средства к существующим бюджетам. Запрос "Сколько осталось в бюджете на поездки Contoso" может вызвать плагин бюджета, вызвав средство get-budgets .
POST /mcp
Content-Type: application/json
{
"method": "tools/call",
"params": {
"name": "get-budgets",
"arguments": {
"budgetName": "contoso travel"
}
}
}
Copilot использует ответ из результата средства для создания своего ответа: "В бюджете на поездки Contoso в настоящее время предусмотрено 5 000 долларов США свободных средств. Если вам нужно распределить средства по определенным категориям или отслеживать расходы, я также могу помочь вам с этим. Просто дайте мне знать, чем я могу помочь!»
Запрос "Снять 500 долларов с бюджета поездки Contoso за авиабилет Меган" можно перевести в следующий вызов средства MCP.
POST /mcp
Content-Type: application/json
{
"method": "tools/call",
"params": {
"name": "charge-budget",
"arguments": {
"budgetName": "contoso travel",
"amount": 500,
"description": "Megan's airline ticket"
}
}
}
Copilot отвечает пользователю, используя возвращенную информацию: «Платеж в размере 500 долларов за авиабилет Меган успешно обработан. В бюджете на поездки Contoso теперь осталось 4500 долларов США. Если вам нужно совершить еще какие-либо транзакции или вам нужна дополнительная помощь с вашим бюджетом, пожалуйста, дайте мне знать!»
Как работают подключаемые модули
Пользователь спрашивает агента: «Сколько осталось в бюджете на ремонт вестибюля Fourth Coffee?».
Для плагина MCP, использующего динамическое обнаружение инструментов, агент получает текущие определения инструментов с сервера MCP плагина во время выполнения и проверяет любые новые или измененные инструменты перед их использованием. Для подключаемого модуля с закрепленным набором инструментов или для подключаемого модуля REST API агент использует инструменты, определенные в манифесте подключаемого модуля.
Агент определяет плагин, связанный с бюджетом, из доступных плагинов, который имеет MCP-сервер, инструмент или API
GetBudgetдля получения сведений о бюджете. Он сопоставляет части вопроса пользователя с параметрами функции:budgetName="".Агент просит пользователя разрешить отправку в
Fourth Coffee lobby renovationплагин.Пользователь разрешает однократный обмен данными с подключаемым модулем или всегда разрешает отправку данных для этой функции.
Если MCP-сервер или API плагина требует аутентификации, плагин запрашивает токен или ключ API из хранилища токенов.
Хранилище маркеров возвращает маркер или ключ. При необходимости хранилище маркеров заставляет агент предлагать пользователю войти в систему.
Агент отправляет запрос на MCP-сервер или API-интерфейс подключаемого модуля, размещенный за пределами Microsoft 365.
MCP-сервер или API возвращает ответ.
{ "name": "Fourth Coffee lobby renovation", "availableFunds": 5000.00 }Агент формирует ответ на основе ответа MCP-сервера или API.
Агент отправляет ответ: «Свободные средства, оставшиеся в бюджете на ремонт вестибюля Fourth Coffee, составляют 5 000 долларов».
Подтверждение действий
Copilot запрашивает пользователя перед первой отправкой любых данных в плагин.
После того как пользователь подтвердит подключение, средства и API сервера MCP, которые только извлекают данные, не требуют подтверждения, в то время как инструменты и API, которые изменяют данные, требуют подтверждения. Разработчики плагинов могут переопределять эти значения по умолчанию. Дополнительные сведения см. в разделе "Запросы на подтверждение для MCP и плагинов API для Microsoft 365 Copilot".
Настройка презентации ответа
Copilot создает ответы в ходе беседы, используя данные сервера MCP или ответы API. Подключаемые модули могут настраивать способ представления этих данных, и механизм зависит от типа подключаемого модуля.
Подключаемые модули MCP могут предоставлять насыщенные интерактивные ответы с помощью приложений MCP — мини-приложений пользовательского интерфейса, которые сервер MCP возвращает вместе с результатом средства во время выполнения. Поскольку мини-приложение доставляется вместе с ответом инструмента, а не определяется в манифесте, приложения MCP работают независимо от того, использует ли подключаемый модуль закрепленный набор инструментов или динамическое обнаружение средств.
Подключаемые модули API могут предоставлять шаблоныадаптивных карточек в манифесте подключаемого модуля для отображения данных в структурированном виде. Поскольку шаблоны определяются для операций, объявленных в манифесте, этот подход применим к подключаемым модулям API и MCP-плагинам, использующим закрепленный набор инструментов.
Для ссылок, связанных с источниками, для любого типа плагина Copilot использует семантику ответа и может автоматически выводить метаданные цитирования из инструмента или ответа API. Автоматический вывод особенно полезен для подключаемых модулей MCP, использующих динамическое обнаружение инструментов, где инструменты разрешаются во время выполнения и не требуют настройки определения инструмента манифеста. Дополнительные сведения см. в статье Отображение ссылок с семантикой ответа.
Обработка URL-адресов в ответах на действия
Чат Microsoft 365 Copilot может отображать URL-адреса, возвращаемые в составе ответов на действия, будь то из плагинов MCP, плагинов API, соединителей или потоков, в виде интерактивных ссылок. Среда выполнения Copilot управляет этим поведением и не оценивает его на каких-либо доменах, объявленных подключаемым модулем (например, servers в разделе описания OpenAPI плагина API).
Правила безопасности, доверия и политики платформы определяют поведение при отображении URL-адресов для ответов на действия и могут со временем изменяться. Не полагайтесь на интерактивные URL-адреса в ответах на действия в критически важных для рабочей среды сценариях.
Помощь оркестратору Copilot в выборе действий агента
Точно опишите интеграцию API или MCP, ее функции или инструменты и их входные данные, чтобы оркестратор мог выбрать правильное действие для запроса пользователя. Эти описания относятся к действиям агента, а не к имени или описанию хранилища внешнего пакета плагина.
| Интеграция действий | Где описывать | Подробнее |
|---|---|---|
| Плагин API | Манифест подключаемого модуля и описания операций и параметров OpenAPI | Создавайте эффективные описания OpenAPI |
| Подключаемый модуль MCP | Манифест плагинов и описания инструментов MCP; Определения инструментов берутся с сервера во время выполнения или закреплены в манифесте | Динамическое обнаружение и закрепленные инструменты |
Функции и инструменты MCP отличаются от многократно используемых файлов инструкций, описанных в разделе Навыки как возможности плагинов.
Создание декларативного агента с действиями API или MCP
Для профессионального развития начните со средств разработчика Work IQ. Сначала выберите документированную среду, а затем добавьте инструмент в следующем списке, если вам нужны его возможности создания проекта или интеграции:
-
Рекомендуется использовать средства разработчика Work IQ Dev . Используется
wiqd agent add actionдля добавления поддерживаемого OpenAPI или удаленного действия MCP в проект декларативного агента. - Существующие пошаговые инструкции на основе набора средств остаются доступными для сервера MCP, описания OpenAPI или нового REST API. Следуйте этим процедурам при работе с проектом набора средств.
- Kiota может сгенерировать манифест плагина API из существующего описания OpenAPI.
Манифест подключаемого модуля API или MCP настраивает интеграцию действий агента. Упакуйте и распространите содержащий агент через поддерживаемый маршрут пакет приложений; Манифест действия не является независимым пакетом подключаемого модуля.
Совет
Средства разработчика Work IQ доступны для всех.
wiqd agent add action Добавляет действие в проект декларативного агента и wiqd agent validate --mode source запускает автономные проверки для сохраненного источника агента. Прохождение проверки источника не устанавливает время выполнения или конечную точку OpenAPI, правильность проверки подлинности или принятие окончательного пакета. Если значение опущено --mode, по умолчанию проверяется значение package, при котором загружается копия существующего ZIP-архива и может потребоваться выполнить вход. Информацию о режимах валидации и охвате см. в справочнике по командам WIQD и Validation and MVL.
Ограничения
Эти ограничения относятся к подключаемым модулям API и MCP, используемым в качестве действий декларативного агента, а не к количеству навыков, агентов или соединителей в устанавливаемом пакете подключаемого модуля.
Если декларативный агент включает до пяти плагинов, определенных в манифесте декларативного агента, агент всегда внедряет плагины в запрос. Когда агент включает более пяти плагинов, он использует семантическое сопоставление. Семантическое сопоставление основано на описании плагина, а не на каких-либо отдельных функциях или инструментах внутри самого плагина.
Плагин может включать в себя неограниченное количество функций или инструментов MCP. Возвращаются все функции или инструменты соответствующего подключаемого модуля, даже если сопоставлена только одна. Для подключаемого модуля MCP, использующего динамическое обнаружение инструментов, средства, разрешенные сервером MCP во время выполнения, учитываются в этом общем количестве. Из-за ограничений окна маркера качество ответов может ухудшиться, если включено более 10 функций или средств.
Окно маркера для входных и выходных данных плагина отсекает большой объем содержимого. Функциональный предел может изменяться по мере совершенствования моделей и в зависимости от любых системных издержек. Оптимизируйте маркеры небольшой длины или выберите параметры расширяемости, позволяющие при необходимости выполнять потоковую передачу большого объема содержимого.
Следующий этап
Реализация выбранного действия MCP или действия API. После того, как компоненты работают по отдельности, войдите в пакет & протестируйтес помощью интеграции и протестируйте свои компоненты.
См. также:
- Создавайте подключаемые модули на основе сервера MCP для Microsoft 365 Copilot
- Добавление приложений MCP к декларативным агентам в Microsoft 365 Copilot
- Динамическое обнаружение инструментов для подключаемых модулей MCP в Microsoft 365 Copilot
- Создание подключаемых модулей API из существующего API для Microsoft 365 Copilot
- Создание подключаемых модулей API с помощью нового API для Microsoft 365 Copilot
- Схема манифеста подключаемого модуля API и MCP для Microsoft 365 Copilot
- Написание эффективных инструкций для декларативных агентов с помощью API-плагинов