El agente no responde

Un agente puede no responder en el chat de prueba del constructor, en un chatbot de tu sitio o a través de la API. La causa es casi siempre una de las comprobaciones siguientes. Recorre la lista en orden, porque las primeras son las más comunes y las más rápidas de descartar.

Síntomas#

• Envías un mensaje y no recibes nada.
• El chat muestra un error en lugar de una respuesta.
• Un visitante del chatbot ve “¡Vaya! Algo salió mal. ¡Contacta con el propietario del sitio web!”

Causas probables, en orden#

1. El espacio de trabajo se quedó sin créditos#

Los agentes no pueden ejecutarse sin créditos. Busca el aviso de Modo de solo lectura y comprueba la cifra de créditos en la parte inferior de la barra lateral. Quienes llaman a la API reciben “Créditos insuficientes para realizar esta acción. Recarga tus créditos.” Los visitantes del chatbot ven “Lo sentimos, has alcanzado tu límite de pago.” Consulta sin créditos.

2. La suscripción terminó o el espacio de trabajo está en solo lectura#

Si se canceló el plan, el espacio de trabajo está inactivo y las ejecuciones se rechazan con “Este espacio de trabajo está inactivo porque su suscripción terminó.” Solo el propietario puede volver a elegir un plan.

3. Una aplicación que el agente necesita no está conectada#

Si una herramienta necesita una cuenta que no has conectado, verás un aviso como “Se requiere la integración con Slack, pero no se encontró” o “El componente no está integrado”, y una ejecución que llegue a esa herramienta falla con “no está configurado. Configura primero la integración.” Abre Integraciones y conéctala. Consulta integración desconectada.

4. La memoria está activada sin ninguna categoría#

En el constructor de agentes, Memoria necesita una categoría. El constructor avisa: “Elige una categoría o desactiva la memoria. El agente se niega a ejecutarse mientras la memoria está activada y no se ha elegido ninguna.” Elige una categoría en Avanzado o desactiva la memoria. Consulta memoria e historial de chat.

5. Tus cambios están guardados pero no publicados#

Las ediciones se guardan como borrador. Quienes usan el agente en vivo, incluido un chatbot de tu sitio, ven la última versión publicada hasta que hagas clic en Publicar cambios. Un disparador muestra “Publica para activar” hasta que lo hagas. Consulta compartir y publicar.

6. El chatbot está desactivado o limitado por tasa#

En Chatbots, abre el chatbot y comprueba que Chatbot habilitado esté activado. Los visitantes que envían demasiados mensajes ven “Demasiadas solicitudes. Inténtalo de nuevo más tarde o inicia sesión para continuar.” Los límites están en Limitación de tasa dentro de la configuración del chatbot.

7. Un paso o una herramienta falló#

Una herramienta o un paso del agente puede fallar aunque el modelo en sí funcione. Abre Historial, busca la sesión, activa el filtro Mensajes de error y lee el evento que falló. Consulta una ejecución falló.

Soluciónalo#

1. Envía un mensaje de prueba corto en el chat del constructor y anota el texto exacto de cualquier error.
2. Relaciona ese texto con la lista anterior y aplica la solución.
3. Publica si cambiaste algo y luego vuelve a probar desde el lugar donde falló, como tu sitio.