Ahora, cada entrada en el panel de registros sigue un mismo patrón de lectura: qué hizo el agente, sobre qué, con qué resultado y a qué hora. Todas los registros aparecen colapsados por defecto para facilitar la lectura cronológica, y puedes desplegarlas para ver el detalle exacto de la operación. Además, cada registro queda ubicado exactamente en el punto de la conversación en el que ocurrió, facilitando el contexto de la acción.
📋 ¿Qué tipo de información registra el Panel de registros?
El panel registra 6 tipos de operaciones principales. Aquí tienes un ejemplo de cómo se visualiza cada una:
1. Consulta a la base de conocimiento
Cuando el agente busca información en los documentos cargados.
Se visualiza como:
Consultó [nombre_del_documento](ej. Consultó modelos-catalogo-2026.pdf).Al desplegar: Podrás ver exactamente qué términos buscó la IA (ej. "consumo Corolla LE") y el fragmento específico del documento que el sistema recuperó y usó para redactar la respuesta.
2. Consulta a un Catálogo
Cuando el agente cruza información con tablas de datos en vivo (Catálogos).
Se visualiza como:
Consultó [nombre_del_catalogo](ej. Consultó Promos activas Julio26).Al desplegar: Verás qué parámetros buscó el agente (ej. "promos activas Corolla") y exactamente qué filas de información le devolvió el catálogo. (Nota: Las integraciones externas se identifican ahora como "Aplicación externa").
3. Ejecución de una Herramienta (Integraciones/APIs)
Cuando el agente ejecuta una acción contra sistemas externos o herramientas nativas.
Se visualiza como:
Ejecutó [nombre_herramienta], junto con el estado del resultado marcado visualmente como Exitosa o Fallida (ej. Ejecutó GET_SHEET_DATA — Exitosa).Al desplegar: Verás el detalle técnico completo (payload) de la petición enviada y la respuesta devuelta por el sistema, en formato JSON legible, con saltos de línea y un botón para copiar.
Si falló: El panel mostrará el código y mensaje de error, junto a los datos con los que el agente intentó realizar la llamada.
Importante: Por seguridad, las credenciales o tokens de autenticación nunca se muestran en este registro.
4. Pase de un agente a otro (Ramas/Nodos)
Cuando la conversación salta a una nueva intención o a un agente especializado.
Se visualiza como: El nombre de la rama tomada y la condición que se cumplió (ej. Movió a Awareness — "pidió cotización"). Muestra de dónde venía y a dónde fue.
Al desplegar: Si el modelo de IA dejó un registro de razonamiento (reasoning) sobre por qué tomó esa decisión, aparecerá aquí. Si no hay reasoning disponible, la entrada simplemente no mostrará la opción de desplegarse.
5. Captura de un dato (Campos)
Cuando el agente guarda información proporcionada por el usuario en las variables del sistema.
Se visualiza como: El nombre del campo y el valor guardado (ej. Capturó Email — mailto:[email protected]). Si el valor excede el ancho, se trunca visualmente y puedes verlo completo al desplegar.
Casos especiales:
Si el agente no logra capturar el dato o lo borra, se mostrará explícitamente como "sin valor" (la entrada no se omite).
Si un mismo campo se sobrescribe durante la misma conversación, se creará una nueva entrada cronológica por cada escritura.
6. Captura de Etapas, Tipificaciones y Etiquetas
Cuando la conversación avanza en el embudo o se clasifica.
Etapas: Registra en orden los estados por los que pasó (ej. Etapa: MQL — mql).
Tipificación: Muestra la tipificación aplicada. Al desplegar, verás qué parte de la conversación justificó esa tipificación.
Etiquetas: Muestra las etiquetas aplicadas y sus valores. Si se aplican varias, se listarán todas juntas.
🕵️♂️ Cómo diagnosticar problemas comunes con el Panel de registros
Lo que NO está en el panel, también es información. La ausencia de un registro es tan importante como su presencia. Si notas que un agente respondió de forma incorrecta o alucinada, lo primero que debes buscar es si existe un registro de "Consulta a base de conocimiento". Si la entrada no está, significa que el agente respondió de memoria sin consultar la documentación de tu empresa.
Aquí te mostramos cómo resolver los tres escenarios de soporte más frecuentes:
"El agente pasó la conversación al agente/nodo equivocado."
Qué buscar: Revisa el registro de Pase de un agente a otro (Ramas).
Cómo resolverlo: Despliega la entrada para leer el reasoning. Verás exactamente qué instrucción interpretó la IA para tomar esa decisión. Generalmente, esto se soluciona refinando el prompt o la descripción del nodo destino para que sea más específico y la IA no se confunda.
"El agente respondió algo incorrecto o sin consultar la documentación."
Qué buscar: Busca el registro de Consulta a la base de conocimiento u omisión de la misma justo antes del mensaje del agente.
Cómo resolverlo: Si el registro no existe, debes ajustar el prompt del agente para hacer obligatorio el uso de la base de datos. Si el registro sí existe, despliégala para ver qué términos buscó la IA; es probable que tu documento no tenga la respuesta redactada de forma clara para esa búsqueda específica.
"La conversación terminó por una salida que no correspondía (o se aplicó una tipificación errónea)."
Qué buscar: Revisa el registro de Captura de Etapas o Tipificación al final del flujo.
Cómo resolverlo: Despliega el evento para ver la justificación. Si la IA tipificó como "Venta perdida" cuando era "Seguimiento", revisa si las definiciones de tus tipificaciones en la configuración del agente son lo suficientemente claras como para que la IA entienda la diferencia.
El Panel de registros no es solo un registro técnico, es la mente de tu agente expuesta paso a paso. Úsalo para entender cómo toma decisiones la IA, auditar integraciones fallidas (verificando el payload enviado y recibido) y corregir comportamientos no deseados sin necesidad de escalar constantemente a soporte técnico. ✅