Ver Logs
- Cómo la configuración de Nivel de registro en cada agente controla lo que se registra
- Dónde encontrar los logs en AutoTalk
- Cómo 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 los mensajes procesados, las llamadas a herramientas realizadas, las respuestas generadas y los errores encontrados. Revisar los logs es la manera más rápida de entender por qué un agente se comportó de cierta manera y de diagnosticar problemas.
Cómo funcionan los niveles de registro
Cada agente tiene una configuración de Nivel de registro, ubicada en la pestaña Avanzado del agente, dentro del grupo Opciones (el Nombre y el Tipo de Agente están en la pestaña General). El nivel de registro controla cuánto detalle se registra:
- Menor verbosidad: Solo se registran los eventos significativos (errores, advertencias). Adecuado para agentes en producción que funcionan sin problemas.
- Mayor verbosidad: Se registra información detallada sobre cada paso del procesamiento, incluyendo los datos de entrada/salida, los parámetros de las llamadas a herramientas y las decisiones internas. Ideal durante la configuración, las pruebas y la depuración.
Establece un nivel de registro más alto mientras construyes y pruebas tu agente. Una vez que el agente esté estable y manejando conversaciones reales de contactos, reduce el nivel de registro para ahorrar almacenamiento y facilitar la detección de problemas genuinos.
Dónde encontrar los logs
Los logs de los agentes están disponibles en AutoTalk:
- En la barra lateral, haz clic en Logs.
- Verás una lista de entradas de log de todos tus agentes y de la actividad del sistema.
- Filtra o busca para encontrar entradas relacionadas con un agente específico.
Qué contienen los logs
Cada entrada de log incluye:
| Campo | Descripción |
|---|---|
| Timestamp | Cuándo ocurrió el evento |
| Nombre del agente | Qué agente generó la entrada |
| Tipo de evento | El tipo de evento (mensaje recibido, respuesta enviada, llamada a herramienta, error, etc.) |
| Datos de entrada | El mensaje del contacto o el trigger que inició la acción |
| Datos de salida | La respuesta del agente o el resultado devuelto por una herramienta |
| Detalles de la llamada a herramienta | Qué herramienta se llamó, qué parámetros se enviaron y qué devolvió la herramienta |
| Errores | Cualquier error o excepción encontrada durante el procesamiento |
Usar los logs para solucionar problemas
Estos son escenarios comunes en los que los logs te ayudan a diagnosticar y corregir problemas:
El agente dio una respuesta incorrecta o inesperada
Revisa la entrada de log de ese turno de conversación. Observa:
- Los mensajes del sistema que se enviaron al modelo (¿estaban completos y eran precisos?)
- El historial de conversación que se incluyó (¿estaba presente el contexto relevante?)
- La respuesta cruda del modelo (¿malinterpretó la pregunta?)
Una llamada a herramienta falló
Encuentra la entrada de log de la llamada a herramienta. Verifica:
- Los parámetros que el agente envió a la herramienta (¿eran correctos?)
- El mensaje de error devuelto (¿indica un problema de configuración, de autenticación o de datos?)
- Si la herramienta fue llamada siquiera (si no, la descripción de la herramienta puede necesitar ser más 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 tardó mucho en completarse
- Considera si el modelo en sí estaba lento (esto puede suceder con modelos más grandes bajo carga pesada)
- Revisa si las pre-acciones están agregando un retraso innecesario
El agente no está respondiendo
Verifica si existe alguna entrada de log para la conversación. Si no hay ninguna:
- Verifica que el agente esté asignado al canal correcto
- Confirma que el interruptor del bot esté habilitado para la conversación
- Asegúrate de que la conversación no esté en un período de enfriamiento del bot (los agentes no tienen un interruptor de estado/activo aparte — que un agente responda se rige por la asignación de canal y el interruptor/enfriamiento del bot por conversación)
Adopta el hábito de revisar los logs después de implementar cualquier cambio en los mensajes del sistema, las herramientas o las pre-acciones de un agente. Una revisión rápida de las primeras interacciones te dirá si todo está funcionando como se espera.