Ver Logs
- Como la configuracion de Log Level en cada agente controla lo que se registra
- Donde encontrar los logs en AutoTalk
- Como usar los logs para solucionar problemas de comportamiento del agente
Los Logs proporcionan un registro detallado de la actividad de tu agente de IA. Capturan mensajes procesados, llamadas a herramientas realizadas, respuestas generadas y errores encontrados. Revisar los logs es la manera mas rapida de entender por que un agente se comporto de cierta manera y diagnosticar problemas.
Como funcionan los niveles de log
Cada agente tiene una configuracion de Log Level, definida en el formulario principal del agente junto con el nombre y el tipo de asistente. El nivel de log controla cuanta informacion se registra:
- Menor verbosidad: Solo se registran eventos significativos (errores, advertencias). Adecuado para agentes en produccion que funcionan sin problemas.
- Mayor verbosidad: Se registra informacion detallada sobre cada paso del procesamiento, incluyendo datos de entrada/salida, parametros de llamadas a herramientas y decisiones internas. Ideal durante la configuracion, pruebas y depuracion.
Establece un nivel de log mas alto mientras construyes y pruebas tu agente. Una vez que el agente este estable y manejando conversaciones reales de clientes, reduce el nivel de log para ahorrar almacenamiento y facilitar la deteccion de problemas genuinos.
Donde encontrar los logs
Los logs de los agentes estan disponibles en la seccion Empresa de AutoTalk:
- En la barra lateral, ve a Empresa.
- Haz clic en Logs.
- Veras una lista de entradas de log de todos tus agentes y actividad del sistema.
- Filtra o busca para encontrar entradas relacionadas con un agente especifico.
Que contienen los logs
Cada entrada de log tipicamente incluye:
| Campo | Descripcion |
|---|---|
| Timestamp | Cuando ocurrio el evento |
| Nombre del agente | Que agente genero la entrada |
| Tipo de evento | El tipo de evento (mensaje recibido, respuesta enviada, llamada a herramienta, error, etc.) |
| Datos de entrada | El mensaje del cliente o trigger que inicio la accion |
| Datos de salida | La respuesta del agente o el resultado devuelto por una herramienta |
| Detalles de llamada a herramienta | Que herramienta fue llamada, que parametros se enviaron y que devolvio la herramienta |
| Errores | Cualquier error o excepcion encontrada durante el procesamiento |
Usar logs para solucion de problemas
Aqui hay escenarios comunes donde los logs te ayudan a diagnosticar y corregir problemas:
El agente dio una respuesta incorrecta o inesperada
Revisa la entrada de log para ese turno de conversacion. Observa:
- Los mensajes del sistema que se enviaron al modelo (estaban completos y precisos?)
- El historial de conversacion que se incluyo (estaba presente el contexto relevante?)
- La respuesta cruda del modelo (malinterpreto la pregunta?)
Una llamada a herramienta fallo
Encuentra la entrada de log para la llamada a herramienta. Verifica:
- Los parametros que el agente envio a la herramienta (eran correctos?)
- El mensaje de error devuelto (indica un problema de configuracion, autenticacion o datos?)
- Si la herramienta fue llamada (si no, la descripcion de la herramienta puede necesitar ser mas clara)
Las respuestas son lentas
Compara los timestamps entre el evento de mensaje recibido y el evento de respuesta enviada. Si hay un intervalo grande:
- Verifica si una llamada a herramienta tardo mucho en completarse
- Considera si el modelo mismo estaba lento (esto puede suceder con modelos mas grandes bajo carga pesada)
- Revisa si las pre-acciones estan agregando retraso innecesario
El agente no esta respondiendo
Verifica si existen entradas de log para la conversacion. Si no hay:
- Verifica que el agente este asignado al canal correcto
- Confirma que el interruptor del bot este habilitado para la conversacion
- Confirma que el estado del agente este activo
Haz el habito de revisar los logs despues de implementar cualquier cambio en los mensajes del sistema, herramientas o pre-acciones de un agente. Una revision rapida de las primeras interacciones te dira si todo esta funcionando como se espera.