Vista detallada de la conversación

​

Qué encontrarás en la vista detallada

• Línea de tiempo completa de los mensajes entre el cliente y el agente virtual.
• Ejecuciones de herramientas (por ejemplo, API REST, Transferencia a humano, Código).
• Consultas a bases de conocimiento, incluyendo resultados relevantes.
• Aplicación de guardrails o modificadores en cada respuesta.
• Transferencias de agente o de canal, cuando correspondan.
• Variables de contexto creadas o actualizadas en el transcurso de la conversación.

---

​

Descarga de eventos en CSV/JSON

En la parte superior de la vista detallada encontrarás el botón Descargar CSV.

• Al hacer clic, se descarga un archivo CSV que en realidad contiene un JSON completo
  con todos los eventos registrados durante la conversación.
• Cada evento incluye:
  • Timestamp exacto
  • Tipo de evento
  • Payload detallado (datos enviados, respuestas de herramientas, etc.)

Esto permite análisis offline, integración con sistemas externos o
trazabilidad avanzada en auditorías.

---

​

Tipos de eventos conocidos

El archivo JSON puede incluir varios tipos de eventos que describen el ciclo de vida de la conversación.
Algunos de los más comunes son:

---

​

Eventos en detalle

A continuación se describen los eventos reales que ocurren durante una conversación:

​

🧠 Asistente

• assistant.attend.started → el agente comienza a procesar un turno
• assistant.attend.end → finaliza el procesamiento
• assistant.response → respuesta generada por el modelo
• assistant.message → mensaje final enviado al usuario
• assistant.partial.message → streaming de respuesta

---

​

👤 Usuario

• user.talk → mensaje recibido (texto o voz)

---

​

🛠️ Herramientas

• tool.usage.request → el agente decide usar una herramienta
• tool.usage.result → respuesta de la herramienta

---

​

🔄 Mutaciones

• mutation → cambio de agente dentro de la conversación (multiagente)

---

​

⚙️ Sistema (Crew)

• crew.status.writing → el agente está escribiendo
• crew.status.waiting → el agente está en espera

---

​

📡 Sesión

• session.consumer.attach → conexión del usuario
• session.consumer.talk → evento previo a mensaje
• session.hearthbeat → señal de actividad

---

​

🎙️ Voz

• speech_started → inicio de habla
• speech_stopped → fin de habla
• transcription_calculated → resultado STT
• playout_finished → audio del agente reproducido

---

​

😊 Análisis

• custom (sentiment) → análisis de sentimiento u otros eventos personalizados

---

​

Filtrado por categorías y vistas

Dentro de la pestaña Eventos, puedes analizar la conversación utilizando filtros y vistas especializadas.

​

Categorías

Los eventos se agrupan automáticamente en:

• Sesión
• Agente
• Usuario
• Llamada
• Herramientas
• Sentimiento

Puedes expandir o contraer cada grupo para enfocarte en lo relevante.

---

​

Vistas de análisis

​

🔄 Flujo

• Visualiza la secuencia completa de la conversación
• Permite analizar turnos y dinámica

​

⚡ Latencia

• Muestra tiempos de respuesta del sistema
• Permite detectar cuellos de botella

​

🛠️ Herramientas

• Aísla invocaciones y resultados de tools
• Ideal para validar integraciones

​

😊 Sentimiento

• Muestra evolución emocional de la conversación
• Útil para calidad y experiencia de usuario

---

​

Cómo interpretar el flujo

Una conversación típica sigue este patrón:

1. Usuario → user.talk
2. Agente inicia → assistant.attend.started
3. (Opcional) Tool → tool.usage.request
4. Tool responde → tool.usage.result
5. (Opcional) Mutación → mutation
6. Respuesta → assistant.response
7. Mensaje → assistant.message
8. Audio → playout_finished

---

​

Buenas prácticas

• Usa Eventos para debugging profundo
• Usa Latencia para optimizar performance
• Usa Herramientas para validar integraciones
• Usa Sentimiento para control de calidad
• Exporta conversaciones complejas para análisis offline

---

​

Próximos pasos

• Aprende a buscar y filtrar conversaciones en Búsqueda y filtrado