Cuando hace clic en un vínculo para instalar un agente de Copilot Studio en Microsoft Teams, la instalación puede fallar sin un mensaje de error claro. Esto suele ocurrir debido a una discrepancia entre la configuración de implementación del agente y los permisos del entorno de Teams del usuario. El vínculo puede apuntar a un agente específico de un inquilino al que su cuenta no tiene acceso, o el agente puede estar configurado para un canal de implementación diferente. Este artículo explica las causas principales de este error de instalación y proporciona soluciones paso a paso para resolverlo.
Puntos clave: solución de la instalación del agente de Copilot Studio desde un vínculo de Teams
- Copilot Studio > Configuración > Canales > Microsoft Teams: Verifique que el agente esté publicado en el canal de Teams y que el vínculo se genere a partir de la versión publicada.
- Centro de administración de Microsoft 365 > Aplicaciones de Teams > Políticas de configuración: Asegúrese de que la instalación de aplicaciones de terceros esté permitida y que el agente no esté bloqueado por una política de permisos de aplicaciones.
- Cliente de Teams > Aplicaciones > Administrar sus aplicaciones: Compruebe si el agente aparece en el catálogo de aplicaciones de la organización o si requiere la aprobación del administrador para su instalación.
Por qué falla la instalación del agente de Copilot Studio desde un vínculo de Teams
El vínculo de instalación de un agente de Copilot Studio se genera a partir de la configuración de publicación del agente en Copilot Studio. Cuando el vínculo falla, la causa principal más común es que el agente no se ha publicado en el canal de Teams en absoluto, o se ha publicado en un canal diferente, como un sitio web personalizado o Power Apps. El vínculo en sí es un vínculo profundo que apunta al identificador de aplicación del agente en el catálogo de aplicaciones de Microsoft Teams. Si el agente no está en ese catálogo, Teams no puede resolver el vínculo y el cuadro de diálogo de instalación no aparece o muestra un error.
Otra causa frecuente es una discrepancia de permisos. El agente puede estar configurado para un grupo de seguridad específico o habilitado solo para un subconjunto de usuarios del inquilino. Cuando un usuario ajeno a ese grupo hace clic en el vínculo, Teams comprueba las licencias y las pertenencias a grupos del usuario antes de permitir la instalación. Si el usuario no cumple los criterios, la instalación se bloquea de forma silenciosa.
Las políticas de permisos de aplicaciones de Teams establecidas por el administrador de Microsoft 365 también pueden impedir la instalación. Aunque el agente esté publicado correctamente, si el administrador ha bloqueado las aplicaciones de terceros o categorías específicas de aplicaciones, el usuario no podrá instalar el agente desde ningún vínculo. Esta es una política de todo el inquilino que anula la configuración individual del agente.
Pasos para solucionar la instalación del agente de Copilot Studio desde un vínculo de Teams
Método 1: Verificar que el agente esté publicado en el canal de Teams
- Abra Copilot Studio
Inicie sesión con una cuenta de Microsoft 365 que tenga el rol de Creador de entorno o Personalizador del sistema para el entorno del agente. - Vaya a la Configuración del agente
En el panel de navegación izquierdo, haga clic en Configuración y, a continuación, seleccione Canales. - Compruebe el estado del canal de Teams
Localice el canal Microsoft Teams en la lista. Si muestra un estado No configurado, haga clic en Configurar y siga las indicaciones para habilitarlo. Si muestra Configurado, continúe con el paso siguiente. - Publique el agente
Vuelva a la página principal del agente y haga clic en Publicar. Seleccione Publicar el contenido más reciente para enviar la versión más reciente a todos los canales habilitados, incluido Teams. - Vuelva a generar el vínculo de instalación
Después de publicar, vuelva a Configuración > Canales > Microsoft Teams. Haga clic en el botón Copiar vínculo para generar un nuevo vínculo de instalación. Envíe este nuevo vínculo al usuario.
Método 2: Comprobar los permisos del usuario y las asignaciones de licencias
- Abra el Centro de administración de Microsoft 365
Vaya a admin.microsoft.com e inicie sesión con una cuenta de administrador. - Vaya a Usuarios > Usuarios activos
Busque el usuario que no puede instalar el agente y haga clic en su nombre. - Verifique la licencia del usuario
En el panel de detalles del usuario, haga clic en la pestaña Licencias y aplicaciones. Confirme que el usuario tiene una licencia válida para Microsoft Teams y para Copilot para Microsoft 365 si el agente lo requiere. Asigne la licencia si falta. - Compruebe la configuración del grupo de seguridad del agente
En Copilot Studio, vaya a Configuración > Seguridad. Si el agente está restringido a un grupo de seguridad específico, asegúrese de que el usuario sea miembro de ese grupo en Microsoft Entra ID. - Pruebe con una cuenta de administrador
Pida al usuario que intente de nuevo el vínculo de instalación. Si sigue fallando, haga que un administrador haga clic en el mismo vínculo. Si el administrador puede instalarlo, el problema son los permisos o las licencias específicos del usuario.
Método 3: Revisar las políticas de permisos de aplicaciones de Teams
- Abra el Centro de administración de Teams
Vaya a admin.teams.microsoft.com e inicie sesión con una cuenta de administrador de Teams. - Vaya a Aplicaciones de Teams > Políticas de configuración
Haga clic en Políticas de configuración en el panel de navegación izquierdo. Seleccione la política que se aplica al usuario afectado, normalmente la política Global (predeterminada para toda la organización). - Permitir la instalación de aplicaciones de terceros
Asegúrese de que Permitir aplicaciones de terceros esté establecido en Activado. Si está establecido en Desactivado, cámbielo a Activado y haga clic en Guardar. - Compruebe las políticas de permisos de aplicaciones
Vaya a Aplicaciones de Teams > Políticas de permisos. Seleccione la política aplicada al usuario. En Aplicaciones de Microsoft, asegúrese de que la aplicación del agente no esté bloqueada. Puede buscar el agente por nombre en la lista de aplicaciones bloqueadas. Si aparece allí, elimínelo. - Permitir la carga de aplicaciones personalizadas
En la misma política de permisos, establezca Permitir la carga de aplicaciones personalizadas en Activado. Esta configuración es necesaria para los agentes publicados desde Copilot Studio porque se tratan como aplicaciones personalizadas. - Espere la propagación de la política
Los cambios de política pueden tardar hasta 24 horas en aplicarse a todos los usuarios. Pida al usuario que espere 2 horas y luego intente de nuevo el vínculo de instalación.
Si el vínculo de instalación sigue fallando después de la solución principal
El vínculo abre una página en blanco o muestra un error
Esto suele significar que el identificador de aplicación del agente no está registrado en el catálogo de aplicaciones de Teams. En Copilot Studio, vaya a Configuración > Canales > Microsoft Teams y haga clic en Desinstalar para eliminar la configuración del canal. Luego haga clic en Configurar de nuevo para volver a registrar el agente. Después de la reconfiguración, publique el agente y genere un nuevo vínculo.
Los usuarios ven un mensaje de que la aplicación está bloqueada por su administrador
Es probable que el agente esté bloqueado por una lista global de permitidos o bloqueados en el Centro de administración de Teams. Vaya a Centro de administración de Teams > Aplicaciones de Teams > Administrar aplicaciones. Busque el agente por nombre. Si su estado es Bloqueado, haga clic en él y seleccione Permitir. Luego indique a los usuarios que intenten de nuevo el vínculo después de 30 minutos.
El vínculo de instalación funciona para algunos usuarios pero no para otros
Esto indica un problema de licencias o de grupo de seguridad. Verifique que todos los usuarios afectados tengan las licencias de Microsoft 365 necesarias y sean miembros de los grupos de seguridad correctos en Microsoft Entra ID. Si el agente está configurado para un grupo de seguridad específico, agregue los usuarios que faltan a ese grupo. Los cambios en la pertenencia a grupos pueden tardar hasta 15 minutos en propagarse a Teams.
Métodos de instalación del agente de Copilot Studio: vínculo de Teams vs. carga directa
| Elemento | Instalación mediante vínculo de Teams | Carga directa en el Centro de administración de Teams |
|---|---|---|
| Requisitos previos | Agente publicado en el canal de Teams en Copilot Studio | Archivo de manifiesto del agente descargado desde Copilot Studio |
| Interacción del usuario | El usuario hace clic en un vínculo profundo y confirma la instalación | El administrador carga el manifiesto en el catálogo de aplicaciones del inquilino |
| Comprobaciones de permisos | Licencia del usuario, grupo de seguridad y políticas de Teams | Solo se requieren permisos de administrador para la carga |
| Manejo de errores | Fallo silencioso si las políticas bloquean la aplicación | Mensaje de error explícito si el manifiesto no es válido |
| Ideal para | Instalación de autoservicio por parte de los usuarios finales | Implementación controlada por administradores de TI |
Después de aplicar los pasos anteriores, podrá instalar agentes de Copilot Studio desde vínculos de Teams sin errores. Si el problema persiste, verifique que el canal de Teams del agente esté configurado y publicado, compruebe las licencias de los usuarios y la pertenencia a grupos de seguridad, y revise las políticas de permisos de aplicaciones de Teams. Como sugerencia avanzada, puede usar el análisis de aplicaciones del Centro de administración de Teams para ver por qué falló la instalación de un usuario específico consultando los eventos de instalación de la aplicación en Centro de administración de Teams > Aplicaciones de Teams > Administrar aplicaciones > [Agent name] > Uso.