Documentación

Agente de voz IA

El agente guarda silencio tras el saludo

Solución cuando el agente responde al saludo pero deja de reaccionar a las entradas del interlocutor.

Tu agente responde al saludo inicial pero luego deja de responder a las entradas del interlocutor.

Síntomas

  • El agente contesta la llamada y entrega el mensaje de saludo inicial
  • Tras la respuesta del interlocutor, el agente deja de responder
  • No aparecen mensajes de error en el panel
  • La llamada no se corta, pero el agente no vuelve a hablar ni actuar
  • Ocurre de forma consistente en varias llamadas de prueba

Causas habituales

  1. Uso del modelo GPT Nano — No lo uses. GPT Nano presenta fallos persistentes en producción y suele quedarse sin respuesta tras el prompt inicial.
  2. API key de OpenAI agotada — Si usas una clave OpenAI propia (BYO), puede haber alcanzado el límite de tasa o de crédito.
  3. Estructura deficiente del prompt — Prompts de sistema demasiado complejos, contradictorios o mal formateados hacen que el modelo se «congele».
  4. Base de conocimientos demasiado grande — Bases masivas (>50 MB) pueden provocar timeouts y retrasos de procesamiento.

Cómo solucionarlo

Paso 1: Revisa la selección del modelo LLM

  1. Ve a Agent Settings → Model Configuration
  2. Comprueba qué modelo estás usando
  3. Si usas GPT Nano: cambia de inmediato a GPT 4.1-mini (recomendado para la mayoría de casos) o GPT 4.1 (si necesitas mayor capacidad de razonamiento)
  4. Guarda los cambios y haz una nueva llamada de prueba

Paso 2: Verifica tu API key de OpenAI (si usas BYO)

  1. Ve a Integrations → OpenAI
  2. Comprueba si tienes una API key personalizada configurada
  3. Inicia sesión en tu cuenta de OpenAI y verifica:
    • Que la cuenta tenga créditos disponibles
    • Que la API key no haya expirado
    • Que el uso no haya superado los límites de tasa
  4. Si la clave está agotada: elimina la clave personalizada para volver a la integración OpenAI por defecto de E-Smart360
  5. Haz clic en Save y prueba de nuevo

Paso 3: Simplifica el prompt del agente

  1. Ve a Agent Configuration → System Prompt
  2. Revisa el prompt en busca de:
    • Instrucciones contradictorias (p. ej., «sé útil pero nunca respondas preguntas»)
    • Condiciones anidadas excesivas o lógica demasiado compleja
    • Instrucciones que entren en conflicto con las funciones principales del agente
  3. Reduce a un máximo de 3–5 instrucciones centrales
  4. Prueba con una versión más limpia del prompt

Paso 4: Reduce el tamaño de la base de conocimientos

  1. Ve a Knowledge Base → Manage Files
  2. Comprueba el tamaño total de los archivos subidos
  3. Si supera 50 MB:
    • Elimina documentos obsoletos o redundantes
    • Divide PDFs grandes en fragmentos más pequeños
    • Archiva contenido poco usado
  4. Vuelve a subir la base de conocimientos optimizada
  5. Prueba el agente de nuevo

Guías relacionadas