El agente de Copilot studio muestra error de autenticación en Teams: solución

Cuando intenta usar un agente de Copilot Studio dentro de Microsoft Teams, es posible que vea un mensaje de error que dice Authentication Failed (Error de autenticación). El agente deja de responder o se niega a iniciar una conversación. Este problema suele ocurrir porque la configuración de autenticación integrada del agente no coincide con el entorno de Teams o porque falta un registro de aplicación de Microsoft Entra ID requerido o está mal configurado. Este artículo explica por qué aparece el error y proporciona soluciones paso a paso para resolver el fallo de autenticación.

Por qué los agentes de Copilot Studio muestran Authentication Failed en Teams

El error Authentication Failed (Error de autenticación) ocurre cuando el agente de Copilot Studio no puede verificar la identidad del usuario o del servicio. En Teams, cada agente se ejecuta como una aplicación personalizada que debe autenticarse a través de Microsoft Entra ID, anteriormente Azure Active Directory. El agente envía una solicitud de token a Entra ID, pero si la URL de respuesta, el ID de cliente o el secreto de cliente no coinciden con el registro de la aplicación, Entra ID rechaza la solicitud y devuelve un error 401.

Existen tres causas raíz comunes. Primero, el agente usa la configuración de autenticación predeterminada que Copilot Studio genera automáticamente. Esta configuración funciona para el panel de prueba de Copilot Studio, pero no para Teams. Segundo, el registro de aplicación de Microsoft Entra ID carece de los permisos de API necesarios para Microsoft Graph o Teams. Tercero, el archivo de manifiesto del agente en Teams no incluye la URL de autenticación correcta, por lo que Teams no puede enviar la solicitud de token al punto de conexión correcto.

El método de autenticación predeterminado no es compatible con Teams

Cuando crea un nuevo agente en Copilot Studio, la plataforma establece la autenticación en Manual de forma predeterminada, pero la configuración apunta a un punto de conexión interno de Copilot Studio. Teams espera un registro de aplicación personalizado que usted controle. Si deja la configuración predeterminada sin cambios, el agente no puede autenticarse porque el punto de conexión del token no pertenece a su inquilino.

Secreto de cliente faltante o expirado

El agente usa un secreto de cliente para demostrar su identidad a Entra ID. Si nunca creó un secreto, o si el secreto expiró, el protocolo de enlace de autenticación falla. Copilot Studio no le advierte cuando un secreto está a punto de expirar. Debe administrar el ciclo de vida del secreto manualmente en el portal de Azure.

Pasos para solucionar Authentication Failed en Teams

Siga estos pasos en orden. No omita el paso de registro de la aplicación incluso si ya tiene un registro para otro agente. Cada agente necesita su propio registro.

1. Cree un registro de aplicación de Microsoft Entra ID para el agente
   Inicie sesión en el portal de Azure con una cuenta de Administrador global o Administrador de aplicaciones. Vaya a Microsoft Entra ID > Registros de aplicaciones > Nuevo registro. Escriba un nombre para la aplicación, por ejemplo, Contoso Sales Agent. En Tipos de cuenta admitidos, seleccione Solo las cuentas de este directorio organizativo. Deje el URI de redirección vacío. Haga clic en Registrar. Copie el valor Application Client ID (ID de cliente de la aplicación); lo necesitará más adelante.
2. Agregue un secreto de cliente
   En el mismo registro de aplicación, vaya a Certificados y secretos > Secretos de cliente > Nuevo secreto de cliente. Escriba una descripción y establezca un período de expiración de 180 días o 365 días. Haga clic en Agregar. Copie el valor del secreto inmediatamente. No podrá recuperarlo después de salir de esta página.
3. Configure los permisos de API para Microsoft Graph
   En el registro de aplicación, vaya a Permisos de API > Agregar un permiso. Seleccione Microsoft Graph > Permisos delegados. Agregue los siguientes permisos: openid, profile, email, User.Read y Team.ReadBasic.All. Haga clic en Agregar permisos. Luego haga clic en Conceder consentimiento de administrador para su inquilino. Confirme el consentimiento.
4. Establezca el método de autenticación en Copilot Studio en Manual
   Abra Copilot Studio y vaya a Agentes. Seleccione el agente que muestra el error. Haga clic en Configuración en el menú superior y luego vaya a la pestaña Autenticación. En Método de autenticación, seleccione Manual. Pegue el Application Client ID del paso 1 en el campo Client ID. Pegue el secreto de cliente del paso 2 en el campo Client Secret. Establezca la Redirect URL (URL de redirección) en: https://token.botframework.com/.auth/web/redirect. Haga clic en Guardar.
5. Actualice el manifiesto de la aplicación de Teams
   En Copilot Studio, vaya a la pestaña Canales del agente. Seleccione Microsoft Teams. Haga clic en Descargar manifiesto para obtener el archivo manifest.json. Abra el archivo en un editor de texto. Busque la sección webApplicationInfo. Establezca el valor de id en el Application Client ID del paso 1. Establezca el valor de resource en api://botid-{ApplicationClientID} reemplazando {ApplicationClientID} con su ID de cliente real. Guarde el archivo.
6. Cargue el manifiesto actualizado en Teams
   Vaya al centro de administración de Teams en admin.teams.microsoft.com. Seleccione Aplicaciones de Teams > Administrar aplicaciones > Cargar. Elija el archivo manifest.json actualizado. Establezca los permisos en Permitir para todos los usuarios o grupos específicos. Haga clic en Aplicar. Regrese a Copilot Studio y haga clic en Publicar para volver a implementar el agente.

Si la autenticación sigue fallando después de la solución principal

Si el error persiste después de completar los pasos anteriores, verifique los siguientes escenarios específicos.

El agente de Copilot Studio muestra Authentication Failed solo para usuarios invitados externos

El agente usa la autenticación predeterminada a nivel de inquilino, que no admite cuentas de invitado. Para solucionar esto, en Copilot Studio > Agente > Configuración > Autenticación, cambie los Tipos de cuenta admitidos a Cuentas en cualquier directorio organizativo. Luego actualice el registro de aplicación en Azure para permitir identidades externas. Este cambio requiere que vuelva a configurar el secreto de cliente y la URL de redirección.

El agente funciona en el panel de prueba de Copilot Studio pero falla en Teams

Esto indica que la autenticación está configurada correctamente para el punto de conexión interno de Copilot Studio, pero no para Teams. Verifique que la Redirect URL en Copilot Studio coincida exactamente con https://token.botframework.com/.auth/web/redirect. También confirme que el archivo de manifiesto incluya la sección webApplicationInfo correcta. Vuelva a descargar el manifiesto después de guardar los cambios en Copilot Studio.

El secreto de cliente expiró después de 90 días

Si el secreto expira, el agente no puede obtener un token. Cree un nuevo secreto de cliente en el portal de Azure como se describe en el paso 2. Luego actualice el secreto en Copilot Studio > Agente > Configuración > Autenticación. No necesita volver a cargar el manifiesto. El agente usará el nuevo secreto en el próximo reinicio.

Autenticación predeterminada de Copilot Studio frente a autenticación manual para Teams

Elemento	Autenticación predeterminada	Autenticación manual
Esfuerzo de configuración	Ninguno configuración automática	Requiere registro de aplicación en Azure y secreto
Funciona en Teams	No	Sí
Punto de conexión del token	Interno de Copilot Studio	Microsoft Entra ID de su inquilino
Administración del secreto de cliente	No aplicable	Usted crea y rota los secretos
Compatibilidad con la identidad del usuario	Identidad única	Admite usuarios invitados con configuración adicional

La tabla muestra que se requiere autenticación manual para cualquier agente de Copilot Studio que se ejecute dentro de Teams. La autenticación predeterminada solo funciona en el portal de Copilot Studio y en sitios web personalizados que usan el widget web de Copilot Studio.

Después de completar la configuración de autenticación manual, el agente autenticará a los usuarios a través de Microsoft Entra ID y no mostrará errores. Pruebe el agente abriendo Teams, navegando a Aplicaciones, buscando su agente e iniciando una conversación. Si necesita implementar el agente en varios inquilinos, repita el registro de la aplicación y la carga del manifiesto para cada inquilino. Use un secreto de cliente separado para cada entorno para evitar fallos de autenticación entre inquilinos.