¿Qué son las trazas?
Las trazas te permiten ver el flujo completo de una llamada desglosado en pasos individuales llamados spans. Cada span representa una operación concreta — como un turno de conversación, una respuesta del agente o la ejecución de una herramienta — con su duración exacta. Mientras que los logs de llamadas te dicen qué pasó, las trazas te dicen cuánto tardó cada paso y cómo se relacionan entre sí.Estructura de una traza
Cada llamada genera una traza con una estructura jerárquica. El span raíz representa la sesión completa, y dentro de él se anidan los pasos individuales:Tipos de spans
| Span | Qué representa |
|---|---|
| Sesión del agente | La llamada completa de inicio a fin |
| Turno del usuario | Un turno completo del contacto hablando |
| Turno del agente | Un turno completo del agente respondiendo |
| Generación LLM | El tiempo que tardó la IA en generar la respuesta |
| Síntesis de voz | El tiempo de conversión de texto a audio |
| Herramienta ejecutada | La ejecución de una herramienta (integración, transferencia, etc.) |
| Transición de camino | Un cambio de nodo en agentes con caminos conversacionales |
Información disponible en cada span
Dependiendo del tipo de span, puedes ver diferentes atributos:Turnos de conversación
| Atributo | Descripción |
|---|---|
| Mensaje del usuario | Lo que dijo el contacto |
| Respuesta del agente | Lo que respondió el agente |
| Interrumpido | Si el contacto interrumpió al agente |
Herramientas ejecutadas
| Atributo | Descripción |
|---|---|
| Nombre de la herramienta | Qué herramienta se ejecutó |
| Argumentos | Con qué parámetros se llamó |
Transiciones de camino
| Atributo | Descripción |
|---|---|
| Nodo origen | Desde qué nodo se hizo la transición |
| Nodo destino | A qué nodo se movió el agente |
| Tipo de nodo | El tipo del nodo destino |
Casos de uso
Diagnosticar llamadas lentas
Identifica qué paso está tardando más: ¿la generación de la IA? ¿La síntesis de voz? ¿Una integración externa?
Verificar flujos conversacionales
Confirma que los caminos conversacionales siguen las transiciones esperadas entre nodos.
Analizar herramientas
Revisa qué herramientas se ejecutaron, con qué parámetros y cuánto tardaron.
Entender interrupciones
Detecta en qué momentos los contactos interrumpieron al agente y cómo respondió.