El agente de Copilot studio muestra “este bot no está disponible”: solución
🔍 WiseChecker

El agente de Copilot studio muestra “este bot no está disponible”: solución

Cuando intentas chatear con un agente de Copilot Studio en Microsoft Teams o en un sitio web personalizado, aparece el mensaje “Este bot no está disponible” en lugar de la conversación esperada. Este error generalmente significa que el agente no está configurado correctamente para el canal que estás usando o que la configuración de autenticación bloquea la conexión. El problema también puede ocurrir si el estado de publicación del agente o las políticas de seguridad le impiden responder. Este artículo explica por qué ocurre el error y proporciona soluciones paso a paso para que el agente vuelva a estar disponible.

Puntos clave: Solucionar el error “Este bot no está disponible” en Copilot Studio

  • Copilot Studio > Agentes > Detalles del agente > Canales: Asegúrate de que el canal que estás usando esté habilitado y configurado con la URL de punto de conexión correcta.
  • Copilot Studio > Agentes > Detalles del agente > Autenticación: Verifica que el método de autenticación coincida con los requisitos del canal y que el ID de cliente y el secreto sean válidos.
  • Copilot Studio > Agentes > Detalles del agente > Publicación: Confirma que el agente esté publicado en el entorno de producción y no atascado en un estado de borrador o sin publicar.

ADVERTISEMENT

Por qué Copilot Studio muestra “Este bot no está disponible”

El error ocurre cuando el agente de Copilot Studio no puede establecer una conexión con el usuario final del canal. La causa raíz más común es una discrepancia entre el proveedor de autenticación configurado en el agente y los requisitos de autenticación del canal. Otra causa frecuente es que el agente se haya publicado en un entorno de prueba pero no en el entorno de producción, por lo que el canal solo ve la versión no publicada. Además, el agente puede estar deshabilitado para un canal específico, o la URL del punto de conexión del canal puede ser incorrecta. En Microsoft Teams, el agente también debe agregarse al catálogo de aplicaciones de Teams y asignarse a la política de usuario o grupo correcta. Si falta alguno de estos pasos o están mal configurados, el canal devuelve el mensaje “no disponible”.

Discrepancia en el proveedor de autenticación

Los agentes de Copilot Studio pueden usar Microsoft Entra ID, Azure Active Directory v2 o ninguna autenticación con fines de demostración. Cuando un canal requiere un tipo de autenticación específico, como Teams que requiere Entra ID, el agente debe configurarse en consecuencia. Si el agente usa “Sin autenticación” y el canal espera un token, la conexión falla.

Conflictos en el estado de publicación

Los agentes tienen versiones de borrador y publicadas. La versión publicada es la que está disponible para los usuarios finales. Si editaste el agente después de publicarlo y no lo publicaste de nuevo, el canal sigue usando la versión publicada anterior. Si nunca publicaste el agente, el canal no ve ninguna versión disponible.

Errores de configuración del canal

Cada canal en Copilot Studio tiene su propia configuración. El canal de Teams, por ejemplo, requiere un archivo de manifiesto y un ID de aplicación válido. El canal de sitio web personalizado necesita un secreto de Direct Line. Si estos valores faltan o son incorrectos, el canal no puede enrutar los mensajes al agente.

Pasos para solucionar el error “Este bot no está disponible”

Sigue estos pasos en orden. Después de cada paso, prueba el agente en el canal donde apareció el error.

  1. Verifica el estado de publicación del agente
    Abre Copilot Studio. Ve a Agentes y selecciona tu agente. En la página de detalles del agente, mira la sección Publicar. Si el estado muestra “Borrador” o “Última publicación” con una fecha antigua, haz clic en Publicar para enviar la versión más reciente a producción. Espera el mensaje de confirmación y luego prueba el agente de nuevo.
  2. Verifica que el canal esté habilitado
    En la página de detalles del agente, haz clic en Canales. Busca el canal que estás usando, como Teams, Webchat o Direct Line. Asegúrate de que el interruptor esté en Activado. Si el canal está desactivado, actívalo y guarda los cambios.
  3. Actualiza la URL del punto de conexión del canal
    Para canales de sitio web personalizados, copia el secreto de Direct Line desde la configuración del canal. Para Teams, regenera la URL del punto de conexión del canal si ha caducado. Ve a Canales > [Your Channel]. Haz clic en Editar y copia el nuevo punto de conexión. Reemplaza el punto de conexión antiguo en tu sitio web o en el registro de la aplicación de Teams.
  4. Configura la autenticación para el canal
    Ve a Detalles del agente > Autenticación. Selecciona el proveedor de autenticación que coincida con tu canal. Para Teams, elige Microsoft Entra ID o Azure AD v2. Ingresa el ID de cliente de tu registro de aplicación en Azure. Ingresa el Secreto de cliente y establece el ID de inquilino. Guarda la configuración. Si estás probando en un entorno de demostración, puedes establecer la autenticación en Sin autenticación, pero esto no es compatible con los canales de Teams en producción.
  5. Prueba el agente en el panel de prueba de Copilot Studio
    Antes de revisar el canal externo, usa el panel de prueba integrado. En la página de detalles del agente, haz clic en Probar. Escribe un mensaje. Si el agente responde, el problema está del lado del canal. Si el agente no responde, revisa los temas y desencadenadores del agente en busca de errores.
  6. Para Teams: Agrega el agente al catálogo de aplicaciones de Teams
    Si el agente es para Microsoft Teams, ve a Canales > Microsoft Teams. Haz clic en Abrir el centro de administración de Teams. En Aplicaciones de Teams > Administrar aplicaciones, carga el paquete de la aplicación del agente. Asigna la aplicación a usuarios o grupos usando Políticas de configuración. Espera de 10 a 30 minutos para que la política se propague y luego prueba el agente en Teams.
  7. Revisa las reglas de firewall y red
    Si el agente está alojado localmente o usa conectores personalizados, verifica que el firewall permita el tráfico HTTPS saliente a botframework.com y todos los subdominios. También permite el tráfico a copilotstudio.microsoft.com y todos los subdominios. El tráfico bloqueado impide que el canal llegue al agente.

ADVERTISEMENT

Si Copilot Studio sigue mostrando el error después de la solución principal

Algunos problemas requieren verificaciones adicionales más allá de los pasos de configuración estándar. A continuación se presentan tres escenarios específicos que causan el mismo mensaje de error.

El agente usa un conector personalizado y el conector no está publicado

Si tu agente depende de un conector personalizado para acceder a una API externa, el conector debe publicarse por separado. En Copilot Studio, ve a Agentes > Conectores. Selecciona tu conector personalizado y haz clic en Publicar. Si el conector está en modo borrador, el agente no puede recuperar datos y devuelve el error “no disponible”.

Token del canal caducado o revocado

Los secretos de Direct Line y los tokens de la aplicación de Teams caducan después de un período establecido. En Copilot Studio, ve a Canales > Direct Line o Teams. Haz clic en Regenerar para crear un nuevo secreto o token. Actualiza el punto de conexión en tu aplicación con el nuevo valor. Los tokens antiguos hacen que el canal rechace la conexión.

El agente supera los límites de cuota

Los agentes de Copilot Studio tienen cuotas de mensajes según la licencia. Si el agente supera el límite diario o por hora de mensajes, el canal bloquea nuevas conversaciones. En Copilot Studio, ve a Configuración > Uso. Revisa el recuento de mensajes. Si se alcanzó el límite, espera el período de restablecimiento o actualiza la licencia.

Opciones de canales de Copilot Studio: Direct Line vs Teams vs Webchat

Elemento Direct Line Microsoft Teams Webchat personalizado
Autenticación requerida Sí, con secreto de Direct Line Sí, Microsoft Entra ID o Azure AD v2 No, pero se puede agregar
Configuración del punto de conexión Copiar secreto desde Copilot Studio Cargar manifiesto en el centro de administración de Teams Insertar fragmento de JavaScript
Requisito de publicación El agente debe estar publicado El agente debe estar publicado y la aplicación agregada al catálogo El agente debe estar publicado
Causa común del error Secreto caducado Asignación de política de aplicación faltante Secreto de Direct Line incorrecto

El error “Este bot no está disponible” en Copilot Studio casi siempre es un problema de configuración o publicación. Después de verificar el estado de publicación del agente, habilitar el canal correcto y actualizar la configuración de autenticación, el agente debería responder normalmente. Si el problema persiste, examina el estado del conector personalizado y las fechas de caducidad de los tokens. Para implementaciones en Teams, verifica que la política de la aplicación esté asignada a los usuarios correctos. Como sugerencia avanzada, usa los registros de diagnóstico de Copilot Studio yendo a Detalles del agente > Configuración > Registros de diagnóstico para ver el código de error HTTP exacto devuelto por el canal, que identifica el paso que falla en la cadena de conexión.

ADVERTISEMENT