Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Совет
Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.
Декларативные агенты в Microsoft 365 Copilot подключаются к внутренним службам через плагины API или MCP. Эти интеграции действий подключают агент к серверу протокола контекста модели (MCP) или к API, описанному в документе OpenAPI. Настройте проверку подлинности, чтобы Microsoft 365 Copilot мог получать и отправлять правильные учетные данные от имени вошедшего в систему пользователя.
Примечание
В этой статье настраивается проверка подлинности в манифесте подключаемого модуля API или MCP для декларативного агента. При этом не настраивается внешний устанавливаемый пакет. См. раздел Подключаемые модули и декларативные действия агентов для связи манифеста.
В пошаговых инструкциях проверки подлинности в качестве примера по умолчанию используется подключаемый модуль MCP. Подключаемый модуль MCP — это интеграция агента с удаленным сервером, а не сам сервер. Те же шаги настройки применяются к плагинам API, созданным из документа OpenAPI, если не указано в каждой статье.
Поддерживаемые схемы аутентификации
Выберите схему аутентификации, которая соответствует тому, как ваш MCP-сервер или API защищает свои конечные точки:
| Схема проверки подлинности | Подключаемые модули MCP | Подключаемые модули API | Статья |
|---|---|---|---|
| Единый вход (SSO) в Microsoft Entra | Поддерживается | Поддерживается | Настройка проверки подлинности единого входа Microsoft Entra |
| Динамическая регистрация клиентов (DCR) | Поддерживается | Не поддерживается | Настройка динамической регистрации клиентов |
| Поток кода авторизации OAuth 2.0 | Поддерживается | Поддерживается | Настройка проверки подлинности OAuth 2.0 |
| Ключ API | Не поддерживается | Поддерживается | Настройка аутентификации с помощью ключа API |
| Нет проверки подлинности (анонимность) | Поддерживается | Поддерживается | Настройка без проверки подлинности (анонимная) |
Примечание
В этой таблице рассматриваются подключаемые модули MCP и API, используемые в качестве действий декларативного агента. Подключаемый модуль, который ссылается на удаленный сервер agentConnectors MCP в манифесте приложения Microsoft 365, использует другую конфигурацию авторизации. Эта схема включает ApiKeyPluginVault, в то время как подключаемые модули MCP, используемые в качестве действий декларативного агента, не поддерживают ключи API. Требования к конфигурации и узлу см. в статье Настройка удаленных серверов MCP для подключаемых модулей Microsoft 365 Copilot.
Как работает проверка подлинности подключаемого модуля
Для схем, требующих учетных данных, конфигурация проверки подлинности (конфигурация проверки подлинности) — это запись, хранящаяся в хранилище маркеров Microsoft Enterprise, которая содержит учетные данные или сведения о клиенте, необходимые для проверки подлинности на сервере MCP или API. Анонимный доступ не требует настройки проверки подлинности. Выберите поддерживаемый путь конфигурации для проекта:
-
Work IQ Dev Tools (рекомендуется) настраивает проверку подлинности при добавлении OpenAPI или удаленного действия MCP с
wiqd agent add actionпомощью . Чтобы настроить поддерживаемый тип проверки подлинности в существующем манифесте подключаемого модуля, используйтеwiqd agent add auth. Следуйте приведенным ниже инструкциям WIQD для конкретной схемы, чтобы выбрать правильные варианты, а затем завершите рабочий процесс подготовки агента для вашей среды. - Набор средств агентов Microsoft 365 создает конфигурацию проверки подлинности и автоматически обновляет манифест подключаемого модуля по мере создания агента.
- Навык разработчика декларативного агента (только подключаемые модули MCP) создает конфигурацию проверки подлинности и обновляет манифест на естественном языке.
- Портал разработчиков Microsoft Teams позволяет создать конфигурацию проверки подлинности вручную или управлять конфигурацией, созданной набором средств агентов или навыком.
Для схем с проверкой подлинности манифест подключаемого модуля ссылается на конфигурацию проверки подлинности по ее идентификатору в объекте проверки подлинности во время выполнения. Во время выполнения Microsoft 365 Copilot использует конфигурацию проверки подлинности для получения маркера или ключа API из хранилища маркеров и включает его, когда подключаемый модуль вызывает сервер MCP или API.
Начните с раздела WIQD для выбранной схемы аутентификации. В тех же статьях сохранены альтернативы Toolkit, Developer-Skill, Portal и вручную, если таковые поддерживаются.
- Настройка проверки подлинности единого входа Microsoft Entra с помощью WIQD
- Настройка динамической регистрации клиентов с помощью WIQD
- Настройка проверки подлинности OAuth 2.0 с помощью WIQD
- Настройка аутентификации с помощью API-ключа с помощью WIQD
- Настройка анонимной проверки подлинности с помощью WIQD
Примечание
Для пакета подключаемого модуля, который подключает Cowork к удаленному серверу MCP, выполните проверку подлинности в манифесте приложения. Общие этапы регистрации учетных данных не делают эту конфигурацию взаимозаменяемой с конфигурацией манифеста подключаемого модуля MCP агента. Если ваш поставщик OAuth использует платформу удостоверений Майкрософт и подключение требует автоматического обновления маркера, включите offline_access в поле "Область" конфигурации OAuth все делегированные области для API.