Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Recomendación
Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.
Los agentes declarativos en Microsoft 365 Copilot se conectan a servicios back-end a través de complementos de API o MCP. Estas integraciones de acciones conectan el agente a un servidor de Protocolo de contexto de modelo (MCP) o una API descrita por un documento OpenAPI. Configure la autenticación para que Microsoft 365 Copilot pueda obtener y enviar las credenciales correctas en nombre del usuario que ha iniciado sesión.
Nota
En este artículo se configura la autenticación en un manifiesto de complemento de API o MCP para un agente declarativo. No configura el paquete externo instalable. Consulte Complementos y acciones de agente declarativas para la relación de manifiesto.
Los tutoriales de autenticación utilizan un complemento MCP como ejemplo predeterminado. El complemento MCP es la integración del agente con el servidor remoto, no el servidor en sí. Los mismos pasos de configuración se aplican a los complementos de API creados a partir de un documento OpenAPI, excepto donde se indique en cada artículo.
Esquemas de autenticación compatibles
Elija el esquema de autenticación que coincida con la forma en que el servidor MCP o la API protegen sus puntos finales:
| Esquema de autenticación | Complementos de MCP | Complementos de API | Artículo |
|---|---|---|---|
| Inicio de sesión único (SSO) de Microsoft Entra | Compatible | Compatible | Configuración de la autenticación SSO de Microsoft Entra |
| Registro dinámico de cliente (DCR) | Compatible | Incompatible | Configurar el registro de cliente dinámico |
| Flujo de código de autorización de OAuth 2.0 | Compatible | Compatible | Configurar la autenticación de OAuth 2.0 |
| Clave de API | No se admite | Compatible | Configurar la autenticación de claves de API |
| Sin autenticación (anónimo) | Compatible | Compatible | No configurar autenticación (anónimo) |
Nota
Esta tabla cubre los complementos MCP y API utilizados como acciones de agente declarativo. Un complemento que hace referencia a un servidor MCP remoto a través agentConnectors del manifiesto de la aplicación Microsoft 365 usa una configuración de autorización diferente. Ese esquema incluye ApiKeyPluginVault, mientras que los complementos de MCP utilizados como acciones de agente declarativo no admiten claves API. Para conocer los requisitos de configuración y host, consulte Configuración de servidores MCP remotos para complementos de Microsoft 365 Copilot.
Cómo funciona la autenticación del complemento
Para los esquemas que requieren credenciales, una configuración de autenticación (configuración de autenticación) es un registro almacenado en el almacén de tokens de Microsoft Enterprise que contiene las credenciales o los detalles de cliente necesarios para autenticarse en el servidor MCP o la API. El acceso anónimo no requiere una configuración de autenticación. Elija la ruta de configuración compatible para el proyecto:
-
Las herramientas de desarrollo de Work IQ (recomendado) Configura la autenticación cuando agrega una acción OpenAPI o MCP remota con
wiqd agent add action. Para configurar un tipo de autenticación admitido en un manifiesto de complemento existente, usewiqd agent add auth. Siga la guía de WIQD específica del esquema a continuación para obtener las opciones correctas y, a continuación, complete el flujo de trabajo de aprovisionamiento del agente para su entorno. - El Kit de herramientas de agentes de Microsoft 365 crea la configuración de autenticación y actualiza el manifiesto del complemento automáticamente a medida que crea el agente.
- La aptitud de desarrollador de agente declarativo (solo complementos MCP) crea la configuración de autenticación y actualiza el manifiesto a partir de instrucciones en lenguaje natural.
- El portal para desarrolladores de Microsoft Teams le permite crear la configuración de autenticación manualmente o administrar una creada por Agents Toolkit o la habilidad.
En el caso de los esquemas autenticados, el manifiesto del complemento hace referencia a la configuración de autenticación por su identificador en el objeto de autenticación en tiempo de ejecución. En tiempo de ejecución, Microsoft 365 Copilot usa la configuración de autenticación para obtener un token o una clave de API del almacén de tokens y la incluye cuando el complemento llama al servidor MCP o a la API.
Comience con la sección WIQD para el esquema de autenticación elegido. Los mismos artículos conservan el kit de herramientas, las aptitudes para desarrolladores, el portal y las alternativas manuales cuando se admiten.
- Configuración de la autenticación SSO de Microsoft Entra con WIQD
- Configuración del registro de clientes dinámicos con WIQD
- Configurar la autenticación de OAuth 2.0 con WIQD
- Configuración de la autenticación de claves de API con WIQD
- Configuración de la autenticación anónima con WIQD
Nota
Para un paquete de complementos que conecta Cowork a un servidor MCP remoto, siga la autenticación en el manifiesto de la aplicación. Los pasos de registro de credenciales compartidas no hacen que esa configuración sea intercambiable con la configuración del manifiesto del complemento MCP de un agente. Si su proveedor de OAuth usa la Plataforma de identidad de Microsoft y la conexión necesita una actualización automática del token, incluya offline_access en el campo Ámbito de la configuración de OAuth cualquier ámbito delegado específico de la API.