Creó un agente personalizado en Copilot Studio y está listo para compartirlo con su equipo. Pero al hacer clic en Publicar y seleccionar el canal de Teams, la publicación falla sin un error claro. Esto ocurre debido a permisos faltantes, configuración incorrecta del canal o brechas de licencia en su inquilino de Microsoft 365. Este artículo explica las causas principales y proporciona soluciones paso a paso para publicar su agente en Microsoft Teams correctamente.
Puntos clave: Publicar un agente de Copilot Studio en Teams
- Copilot Studio > Configuración > Canales > Microsoft Teams: El canal de Teams debe estar habilitado y configurado antes de que la publicación se realice correctamente.
- Centro de administración de Microsoft 365 > Roles > Administrador global o Administrador de Teams: El usuario que publica necesita el rol de Administrador global o Administrador de Teams para implementar el agente en Teams.
- Copilot Studio > Publicar > Selección de canal: Después de corregir los permisos, use el botón Publicar y seleccione Teams como canal de destino para el agente.
Por qué falla la publicación de un agente de Copilot Studio en Teams
La acción de publicación en Copilot Studio envía la configuración de su agente al catálogo de aplicaciones de Microsoft Teams. Para que esto funcione, se deben cumplir tres condiciones. Primero, el usuario que publica debe tener el rol de Administrador de Teams o Administrador global en el centro de administración de Microsoft 365. Segundo, el canal de Teams debe estar activado dentro de la configuración del agente en Copilot Studio. Tercero, el agente debe asignarse al menos a un grupo de seguridad o a todo el inquilino en el centro de administración de Teams después de la publicación. Si falta alguna de estas condiciones, la operación de publicación fallará silenciosamente o devolverá un error genérico.
La causa principal más común es la falta de permisos de administrador. Muchos usuarios intentan publicar solo con el rol de creador de Copilot Studio. Ese rol permite crear y probar un agente, pero no otorga el derecho de implementar aplicaciones en Teams. Otra causa frecuente es que el canal de Teams está deshabilitado de forma predeterminada en los agentes nuevos. Debe habilitarlo explícitamente.
Pasos para solucionar problemas de publicación de un agente de Copilot Studio en Teams
Siga estos pasos en orden. No omita ningún paso. Cada paso aborda uno de los puntos de falla conocidos.
- Verifique su rol de administrador de Microsoft 365
Abra el centro de administración de Microsoft 365 en admin.microsoft.com. Vaya a Usuarios > Usuarios activos. Busque su cuenta. Revise la columna Roles. Si no ve Administrador global o Administrador de Teams, pida a su administrador de TI que asigne uno de estos roles a su cuenta. Sin uno de estos roles, la publicación en Teams siempre fallará. - Habilite el canal de Teams en el agente
Abra Copilot Studio. Vaya a Agentes y seleccione el agente que no puede publicar. En la barra de navegación superior, haga clic en Configuración. Luego haga clic en Canales. Busque Microsoft Teams en la lista. Cambie el interruptor a Activado. Si el interruptor está atenuado, es posible que su rol de administrador aún no esté completamente activo. Espere 15 minutos y actualice la página. - Publique el agente nuevamente
En el mismo agente, haga clic en el botón Publicar en la barra de herramientas superior. Aparece un cuadro de diálogo. Seleccione Microsoft Teams como canal de destino. Haga clic en Publicar. Espere el mensaje de confirmación. Si recibe un error, anote el código de error y continúe con el siguiente paso. - Revise el centro de administración de Teams para errores de implementación
Abra el centro de administración de Teams en admin.teams.microsoft.com. Vaya a Aplicaciones de Teams > Administrar aplicaciones. Busque su agente por nombre. Si el agente aparece con un estado Bloqueado o Pendiente de revisión, haga clic en él. Luego haga clic en Publicar. Establezca el estado en Permitido. Asigne la aplicación al menos a un grupo de seguridad o seleccione Todo el inquilino. Haga clic en Guardar. - Fuerce una resincronización del manifiesto del agente
En Copilot Studio, abra el agente. Vaya a Configuración > Canales > Microsoft Teams. Haga clic en los tres puntos junto a la entrada del canal de Teams. Seleccione Anular publicación. Luego vuelva a Publicar y seleccione Teams nuevamente. Esto borra un manifiesto obsoleto que puede bloquear la implementación.
Si la publicación aún falla después de la solución principal
Copilot Studio muestra el código de error 403
El error 403 significa que su cuenta carece de permiso para escribir en el catálogo de aplicaciones de Teams. Confirme que su rol de administrador sea Administrador de Teams o Administrador global. Si el rol es correcto, es posible que el rol no se haya propagado. Espere una hora e inténtelo de nuevo. Si el error persiste, cierre la sesión en todas las aplicaciones de Microsoft 365 y vuelva a iniciarla.
El agente se publicó pero no aparece en Teams
El agente puede estar en estado Borrador en el centro de administración de Teams. Abra el centro de administración de Teams en admin.teams.microsoft.com. Vaya a Aplicaciones de Teams > Administrar aplicaciones. Busque su agente. Si el estado es Borrador, haga clic en él y luego haga clic en Publicar. Después de publicar, asigne la aplicación a usuarios o grupos. La aplicación puede tardar hasta 24 horas en aparecer en la tienda de aplicaciones de Teams para los usuarios finales.
El botón Publicar está atenuado
Un botón Publicar atenuado significa que el agente tiene cambios sin guardar. Haga clic en Guardar en la barra de herramientas superior. Luego inténtelo de nuevo. Si el botón permanece atenuado, cierre el agente y vuelva a abrirlo. Si el problema continúa, borre la caché del navegador para el dominio de Copilot Studio.
Publicación de agentes de Copilot Studio: permisos requeridos vs roles de usuario comunes
| Elemento | Rol de creador de Copilot Studio | Rol de Administrador de Teams o Administrador global |
|---|---|---|
| Crear y editar agentes | Sí | Sí |
| Probar agente en Copilot Studio | Sí | Sí |
| Habilitar el canal de Teams en la configuración del agente | Sí | Sí |
| Publicar agente en el catálogo de aplicaciones de Teams | No | Sí |
| Aprobar o bloquear aplicaciones en el centro de administración de Teams | No | Sí |
| Asignar agente a usuarios o grupos en Teams | No | Sí |
La tabla muestra que el rol de creador de Copilot Studio es suficiente para crear y probar. Pero publicar en Teams requiere el rol elevado de Administrador de Teams o Administrador global. Si solo tiene el rol de creador, pida a su administrador que asigne el rol de Administrador de Teams a su cuenta durante el paso de publicación.
Ahora puede publicar un agente de Copilot Studio en Teams verificando su rol de administrador, habilitando el canal de Teams y usando el centro de administración de Teams para la aprobación final. Si publica agentes con frecuencia, pida a su departamento de TI que cree un rol de administrador personalizado con solo el permiso de publicación de aplicaciones de Teams. Esto reduce el riesgo de seguridad y le permite implementar agentes de forma independiente.