Pruebas y Depuración
- Cómo usar el botón Iniciar depuración para probar pre-acciones
- Cómo probar tu agente en una conversación en vivo
- Cómo usar los niveles de registro y los logs para diagnosticar problemas
Antes de conectar tu agente de IA a un canal de producción, es importante probarlo a fondo. AutoTalk ofrece varias herramientas para probar y depurar agentes en diferentes niveles.
Depurar pre-acciones
Si tu agente LLM usa pre-acciones (configuradas en la pestaña Acciones), puedes probarlas sin ejecutar una conversación completa:
- Abre el agente y ve a la pestaña Acciones.
- Haz clic en el botón Iniciar depuración (cuya descripción emergente dice "Depurar todo").
- AutoTalk ejecuta cada paso de pre-acción en secuencia y te muestra el resultado de cada uno, incluyendo cualquier dato producido o error encontrado.
Esto te permite verificar que cada paso funciona correctamente antes de que el agente entre en operación. Si un paso falla, puedes corregirlo y hacer clic en Iniciar depuración de nuevo de inmediato.
Probar con conversaciones en vivo
La manera más realista de probar un agente es asignarlo a un canal y enviarle mensajes como lo haría un contacto:
- Asigna el agente a un canal de prueba (o a un número/cuenta secundaria que controles).
- Envía mensajes a ese canal desde un teléfono personal o un navegador.
- Observa cómo responde el agente en la bandeja de entrada de AutoTalk.
- En la vista de conversación, busca el interruptor del bot -- este te permite habilitar o deshabilitar el agente por conversación. Úsalo para alternar entre respuestas automatizadas y manuales durante las pruebas.
Qué probar
- Preguntas comunes: Haz los tipos de preguntas que tus contactos reales hacen con más frecuencia.
- Casos extremos: Intenta preguntas ambiguas, fuera de tema o de varias partes para ver cómo las maneja el agente.
- Pruebas de límites: Pregunta sobre temas que el agente debería rechazar (para verificar que tus mensajes del sistema establecen las barreras adecuadas).
- Uso de herramientas: Si el agente tiene herramientas configuradas, activa escenarios que deberían provocar llamadas a herramientas y verifica los resultados.
- Conversaciones largas: Continúa una conversación durante muchos intercambios para verificar que el contexto se mantiene y que el agente no pierde el hilo.
Usar los niveles de registro para la depuración
Cada agente tiene una configuración de Nivel de registro en su formulario de configuración. Durante las pruebas y la depuración, establécelo en un nivel de verbosidad más alto para capturar más detalles sobre lo que el agente está haciendo internamente.
Una vez que el agente esté estable y en producción, puedes reducir el nivel de registro para disminuir el ruido y el uso de almacenamiento. Consulta Ver Logs para conocer los detalles sobre dónde encontrar y leer los logs.
Problemas comunes y soluciones
| Problema | Causa posible | Solución |
|---|---|---|
| El agente da información imprecisa | Los mensajes del sistema son muy vagos o faltan datos clave | Agrega detalles más específicos a los mensajes del sistema en la pestaña Mensajes |
| El agente no usa sus herramientas | Las descripciones de las herramientas son poco claras o la selección de herramienta está mal configurada | Revisa las descripciones de las herramientas en la pestaña Herramientas y asegúrate de que la selección de herramienta esté en "auto" |
| Las respuestas son muy largas o divagan | La temperatura es muy alta o el máximo de tokens no está definido | Reduce la temperatura en la pestaña Avanzado y establece un límite de tokens |
| El agente responde sobre temas que debería evitar | Faltan barreras en los mensajes del sistema | Agrega instrucciones explícitas de "no hagas" a los mensajes del sistema |
| Las pre-acciones fallan silenciosamente | Un paso tiene una configuración incorrecta | Usa el botón "Iniciar depuración" (descripción emergente "Depurar todo") en la pestaña Acciones para identificar el paso que falla |
| El agente no responde en absoluto | El agente no está asignado al canal, o el interruptor del bot está desactivado | Verifica la asignación del canal y confirma que el interruptor del bot esté habilitado en la conversación |