El agente de Copilot studio no aparece en la tienda de aplicaciones de Teams: solución
🔍 WiseChecker

El agente de Copilot studio no aparece en la tienda de aplicaciones de Teams: solución

Creó un agente de Copilot Studio y lo publicó, pero no aparece en la tienda de aplicaciones de Microsoft Teams. Esto impide que su equipo instale y use el agente dentro de los chats y canales de Teams. El problema suele deberse a pasos de implementación faltantes, permisos incorrectos o un manifiesto de aplicación mal configurado. Este artículo explica las causas principales y proporciona una solución paso a paso para que su agente sea visible en la tienda de aplicaciones de Teams.

Puntos clave: Cómo hacer visible un agente de Copilot Studio en Teams

  • Copilot Studio > Publicar > Canales > Microsoft Teams: Debe habilitar explícitamente el canal de Teams antes de que el agente aparezca en la tienda de aplicaciones.
  • Centro de administración de Teams > Administrar aplicaciones > Permitir: Un administrador a nivel de inquilino debe permitir el agente para todos los usuarios o grupos específicos.
  • Manifiesto de la aplicación > icono y descripción: Los iconos y descripciones de la aplicación faltantes o mal formados impiden que el agente aparezca en los resultados de búsqueda.

ADVERTISEMENT

Por qué el agente de Copilot Studio no aparece en la tienda de aplicaciones de Teams

Cuando publica un agente de Copilot Studio, este no se vuelve disponible automáticamente en la tienda de aplicaciones de Teams. El agente debe implementarse en un canal específico, y Teams es uno de varios canales posibles. Si no seleccionó el canal de Teams durante la publicación, el agente permanece invisible para los usuarios de Teams. Además, el agente debe ser aprobado por un administrador de Teams. Incluso si el canal está habilitado, la aplicación puede estar bloqueada de forma predeterminada en el centro de administración de Teams. Una tercera causa común es un manifiesto de aplicación incompleto. Copilot Studio genera un manifiesto para Teams, pero si las imágenes de los iconos superan los límites de tamaño o la descripción contiene caracteres no válidos, Teams rechaza el envío y el agente nunca aparece.

Configuración del canal

En Copilot Studio, cada agente se puede publicar en varios canales: un sitio web de demostración, Microsoft Teams, Microsoft Copilot y otros. El canal de Teams no se selecciona de forma predeterminada. Debe activarlo manualmente. Si omite este paso, el agente se publica pero no se registra en Teams.

Aprobación del administrador

Teams tiene un sistema de gobernanza de aplicaciones integrado. Las nuevas aplicaciones, incluidos los agentes de Copilot, están bloqueadas de forma predeterminada a menos que un administrador las permita explícitamente. La aplicación aparece en el centro de administración de Teams en Administrar aplicaciones, pero muestra un estado Bloqueado. Hasta que un administrador cambie el estado a Permitido, el agente no aparece en la tienda de aplicaciones de ningún usuario.

Validación del manifiesto

El manifiesto es un archivo JSON que indica a Teams cómo mostrar y ejecutar el agente. Copilot Studio genera este archivo automáticamente, pero si lo modificó manualmente o si el agente usa iconos personalizados, el manifiesto puede fallar la validación. Teams requiere iconos en formato PNG, de 192×192 píxeles para el icono completo y de 32×32 para el icono de contorno. Si los iconos faltan, son demasiado grandes o tienen el formato incorrecto, el manifiesto se rechaza silenciosamente y el agente nunca aparece.

Pasos para solucionar el agente de Copilot Studio faltante en Teams

Siga estos pasos en orden. Después de cada paso, verifique la tienda de aplicaciones de Teams para ver si aparece el agente. Es posible que deba esperar hasta 24 horas para que los cambios se propaguen.

  1. Habilite el canal de Teams en Copilot Studio
    Vaya a Copilot Studio y abra su agente. Seleccione Publicar en la navegación izquierda. Haga clic en Canales. Busque Microsoft Teams en la lista. Active el interruptor. Haga clic en Guardar y luego en Publicar. Esto registra el agente en la plataforma de Teams.
  2. Verifique el agente en el centro de administración de Teams
    Inicie sesión en el centro de administración de Microsoft 365. Vaya a Centro de administración de Teams > Aplicaciones de Teams > Administrar aplicaciones. Busque su agente por nombre. Si aparece con un estado Bloqueado, continúe con el siguiente paso. Si no aparece en absoluto, espere 30 minutos y actualice la página. Si aún no aparece, vuelva a publicar el agente desde Copilot Studio.
  3. Permita el agente para su organización
    En la página Administrar aplicaciones, haga clic en el nombre del agente. Haga clic en el botón Permitir. Opcionalmente, seleccione usuarios o grupos específicos en Asignar a. Haga clic en Guardar. El estado del agente cambia a Permitido. Los usuarios ahora pueden ver el agente en la tienda de aplicaciones.
  4. Revise el manifiesto de la aplicación en busca de errores
    En Copilot Studio, vaya a Publicar > Canales > Microsoft Teams. Haga clic en Descargar manifiesto. Abra el archivo ZIP y extraiga el archivo manifest.json. Ábralo en un editor de texto. Verifique que la sección de iconos apunte a archivos PNG válidos. Compruebe que la descripción tenga menos de 128 caracteres y no contenga caracteres especiales como comillas o barras invertidas. Si encuentra errores, corríjalos en Copilot Studio editando los detalles del agente y vuelva a publicar.
  5. Borre la caché del cliente de Teams
    En el equipo del usuario, cierre Teams por completo. Abra el Explorador de archivos y vaya a %appdata%\Microsoft\Teams. Elimine todos los archivos de esta carpeta. Reinicie Teams. Esto obliga a Teams a recargar el manifiesto de la aplicación desde el servidor. El agente ahora debería aparecer en la tienda de aplicaciones.

ADVERTISEMENT

Si el agente de Copilot Studio aún no aparece

Si el agente sigue siendo invisible después de completar los pasos principales, revise estos factores adicionales.

El agente está publicado en el entorno incorrecto

Los agentes de Copilot Studio están limitados al entorno. Si publicó el agente en un entorno de desarrollo pero los usuarios están en un entorno de producción, el agente no aparece. Vaya a Copilot Studio y revise el selector de entorno en la esquina superior derecha. Cambie al entorno correcto y vuelva a publicar.

La directiva de configuración de aplicaciones de Teams bloquea el agente

Incluso si la aplicación está Permitida, una directiva de configuración de aplicaciones puede impedir que usuarios específicos la vean. En el centro de administración de Teams, vaya a Aplicaciones de Teams > Directivas de configuración. Revise la directiva aplicada a sus usuarios. Asegúrese de que el agente no esté en la lista de Aplicaciones bloqueadas. Si lo está, elimínelo de la lista de bloqueadas y guarde la directiva.

El agente de Copilot Studio supera los límites de tamaño de la aplicación de Teams

La tienda de aplicaciones de Teams tiene un límite de tamaño de 50 MB para todo el paquete de la aplicación. Si su agente incluye archivos grandes como imágenes personalizadas o audio, el paquete puede superar este límite. En Copilot Studio, reduzca el tamaño de los archivos cargados. Vuelva a publicar el agente.

Visibilidad del agente de Copilot Studio en Teams: antes y después de la solución

Elemento Antes de la solución Después de la solución
Canal de Teams habilitado No Sí
Estado de aprobación del administrador Bloqueado Permitido
Icono del manifiesto Faltante o de tamaño excesivo 192×192 PNG, 32×32 PNG
Visibilidad en la tienda de aplicaciones No listado Listado en los resultados de búsqueda

Después de aplicar los pasos anteriores, su agente de Copilot Studio debería aparecer en la tienda de aplicaciones de Teams. Realice una prueba buscando el nombre del agente en la sección Aplicaciones de Teams. Si el agente aún no aparece, verifique que todos los usuarios tengan la directiva de configuración de aplicaciones correcta y que el agente esté publicado en el entorno de producción. Para escenarios avanzados, use el registro de auditoría del centro de administración de Teams para comprobar cuándo se permitió la aplicación y qué administrador lo hizo.

ADVERTISEMENT