🧪 Prueba y Depuración de Conversaciones de IA en el Estudio de Agentes IA
La Línea de Tiempo de Ejecución de Mensajes y el Emulador de Chat del Estudio de Agentes IA dan visibilidad completa de cada paso de una conversación de IA, para que puedas depurar más rápido, identificar cuellos de botella, y publicar agentes con confianza.
📋 Contenido de este Tutorial
🧪 ¿Qué son la Línea de Tiempo y el Emulador de Chat?
✨ Beneficios Clave
📊 Línea de Tiempo de Ejecución de Mensajes
🔗 Botón de Nodo de Transición
📈 Panel de Métricas de Rendimiento
💬 Emulador de Chat
🧭 Cómo Probar y Depurar Conversaciones
❓ Preguntas Frecuentes
🧪 ¿Qué son la Línea de Tiempo y el Emulador de Chat?
Son herramientas integradas en el Estudio de Agentes IA que te ayudan a probar y depurar conversaciones de IA con visibilidad completa. La Línea de Tiempo registra cada evento, llamada a herramienta, y decisión que toma tu agente junto con métricas del modelo, mientras que el Emulador de Chat te permite simular conversaciones, reiniciar sesiones, y saltar directamente al nodo responsable de cualquier respuesta.
Juntas, eliminan el efecto de "caja negra" a menudo asociado con los flujos de IA, mostrando exactamente qué pasa en cada paso de la ejecución, permitiéndote rastrear la lógica, inspeccionar entradas y salidas, y hacer mejoras específicas basadas en datos reales.
✨ Beneficios Clave
Transparencia completa de ejecución: sigue cada transición de nodo e invocación de herramienta en el orden exacto en que ocurren, eliminando las conjeturas.
Insights de rendimiento a nivel de paso: detecta indicaciones lentas, llamadas a API, o pasos de herramienta al instante y optimízalos para respuestas más rápidas.
Conciencia de modelo y costo: revisa detalles del modelo, uso de recursos de IA, temperatura, y otras configuraciones de ejecución directamente junto a cada mensaje.
Resolución instantánea de problemas: salta desde cualquier entrada de registro directo al nodo responsable en el lienzo para hacer correcciones específicas rápidamente.
Entorno de prueba realista: valida conversaciones en una interfaz de chat que refleja la experiencia del usuario final, asegurando un control de calidad preciso.
📊 Línea de Tiempo de Ejecución de Mensajes
La Línea de Tiempo aparece junto al Emulador de Chat y se actualiza en vivo mientras corre tu agente.
Las tarjetas de evento listan el nombre del nodo, modelo, entradas/salidas, y tiempo de ejecución.
Insignias de latencia con color (rojo = lento; verde = rápido) resaltan cuellos de botella.
Pasa el cursor para ver entradas/salidas en formato JSON crudo para inspección detallada.
💡 Seguimiento de tareas con el Gestor de Pendientes: el Estudio de Agentes IA ahora rastrea el trabajo de agentes de varios pasos usando un Gestor de Pendientes. Las tareas se muestran con etiquetas descriptivas y estados dinámicos, para que puedas seguir el progreso de forma más confiable durante una ejecución de prueba.
🔗 Botón de Nodo de Transición
En la Línea de Tiempo de Ejecución, cada paso muestra una etiqueta morada. Estas etiquetas de Transición en las que puedes hacer clic indican el nodo exacto al que se movió la conversación durante la ejecución. Al hacer clic en la etiqueta, se enfoca y resalta automáticamente ese nodo en el lienzo, permitiéndote revisar o modificar su lógica de inmediato sin buscar manualmente en tu flujo.
📈 Panel de Métricas de Rendimiento
Debajo de cada mensaje, el pie de página de métricas muestra: modelo y versión, conteo de entradas/salidas, temperatura, máximo de tokens, top-p, penalizaciones de frecuencia/presencia, y una estimación de costo total (si la facturación está habilitada). Esta información ayuda a evaluar tanto el rendimiento como la eficiencia durante las pruebas.
💬 Emulador de Chat
Es una interfaz de chat simulada usada para probar conversaciones de IA de forma segura. Ofrece un entorno de prueba optimizado que refleja escenarios reales de despliegue.
Ventana de chat limpia y adaptable a móvil, con soporte de avatar.
Botón de reinicio para limpiar el contexto entre ejecuciones.
Diseño lado a lado con la Línea de Tiempo para revisión simultánea.
🧭 Cómo Probar y Depurar Conversaciones
Paso 1: Abre el Entorno de Prueba. Ve a Agentes IA → Estudio de Agentes IA y abre el agente que quieres probar. Haz clic en la pestaña Probar en la esquina superior derecha. Al abrirse el panel, el sistema revisa tu agente en busca de campos obligatorios faltantes. Si falta algo, aparece una advertencia naranja en la parte superior con el nodo y campo exactos que debes completar — la advertencia no bloquea la prueba, pero completar los campos ayuda a evitar errores confusos de ejecución.
Paso 2: Inicia una Sesión de Prueba. Haz clic en Iniciar para lanzar el Emulador de Chat. La Línea de Tiempo de Ejecución de Mensajes aparecerá junto a la ventana de chat automáticamente. Envía un mensaje de prueba en el emulador o dispara el agente vía API. Mientras el agente procesa la solicitud, cada transición de nodo, llamada a herramienta, y paso de ejecución del modelo se registra en tiempo real en el panel de la Línea de Tiempo.
Paso 3: Revisa los Registros de Ejecución. Examina las tarjetas de evento en la Línea de Tiempo para entender cómo manejó el agente la conversación. Busca nombres de nodos, actividad de herramientas, uso de recursos, tiempo de ejecución, y cualquier insignia de latencia que indique pasos más lentos.
Paso 4: Inspecciona las Métricas de Rendimiento. Haz clic en entradas individuales del registro para revisar métricas detalladas como versión del modelo, entradas/salidas, temperatura, y estimaciones de costo (si están habilitadas). Usa esta información para evaluar la eficiencia y ajustar indicaciones o configuraciones de herramientas.
Paso 5: Salta al Nodo de Origen. Haz clic en la tarjeta de registro para resaltar automáticamente el nodo correspondiente en el constructor. Esto te permite ajustar rápidamente la lógica, indicaciones, o variables sin buscar manualmente en el lienzo.
Paso 6: Reinicia y Vuelve a Probar. Usa el botón de Reinicio en el Emulador de Chat para limpiar la conversación y los registros de ejecución. Ejecuta la conversación de nuevo para verificar que tus cambios resolvieron el problema.
Paso 7: Publica con Confianza. Una vez que las pruebas confirmen que la conversación se comporta como esperas y el rendimiento está optimizado, mueve tu agente a Staging o Producción como de costumbre.
❓ Preguntas Frecuentes
¿La Línea de Tiempo está disponible para agentes de IA de Voz? Sí. Cuando abres la pestaña de Prueba para un agente de IA de Voz, aparece la misma vista de registro después de que termina una llamada de prueba.
¿La Línea de Tiempo aumenta el consumo de recursos o el costo? No. Registra metadatos que ya devuelven el modelo y los nodos de herramientas.
¿Puedo exportar los registros de la Línea de Tiempo? Haz clic en el ícono de descarga en la parte superior derecha de la Línea de Tiempo para guardar un archivo JSON de la ejecución completa.
¿Por qué no veo el botón "Ir al Nodo"? El botón aparece solo después de que el agente se ha guardado al menos una vez. Asegúrate de no estar viendo un Borrador sin guardar.
¿Reiniciar el Emulador de Chat borra la Línea de Tiempo? Sí. Reiniciar limpia tanto el contexto del chat como sus registros de ejecución asociados para una sesión nueva.
¿Por qué veo una advertencia de "Campos Obligatorios Faltantes" al hacer clic en Probar? El sistema detectó uno o más nodos con campos obligatorios sin llenar. Abre el nodo listado, completa los campos requeridos, y guarda para eliminar el ícono de advertencia.
