📈 Registro de Actividad de Agentes Gestionados: Monitorea y Depura tus Agentes de IA
Consulta en un solo lugar todas las conversaciones y ejecuciones automáticas de tus Agentes Gestionados, con el detalle necesario para verificar resultados y detectar problemas rápidamente.
📋 Contenido de este Tutorial
📈 ¿Qué es el Registro de Actividad?
✨ Beneficios Clave
🧭 Cómo Usar el Registro de Actividad
🔍 Entendiendo los Datos del Registro
📄 Cómo Revisar el Detalle de Ejecución de una Corrida
❓ Preguntas Frecuentes
📈 ¿Qué es el Registro de Actividad?
El Registro de Actividad es una línea de tiempo unificada dentro de cada Agente Gestionado que muestra sus ejecuciones recientes en orden cronológico inverso (las más nuevas primero). Combina en una sola vista las conversaciones de chat en vivo con las ejecuciones automáticas por disparador — como envíos de formulario o cambios de etiqueta.
Cada elemento del registro incluye: un ícono (un rayo para disparadores, una burbuja de chat para conversaciones), una etiqueta de estado de la corrida (por ejemplo "Completado"), una marca de tiempo, una insignia de tipo de disparador ("Disparador" o "Chat") y una descripción de contexto que indica qué inició al agente.
El Registro de Actividad vive dentro del Estudio de Agentes IA, en la pestaña Actividad de cada Agente Gestionado, e incluye una insignia con el número de corridas recientes.
✨ Beneficios Clave
Visibilidad completa: observa las acciones del agente tanto en chat como en automatizaciones desde una sola vista cronológica.
Depuración más rápida: revisa los pasos de ejecución y las llamadas a herramientas en línea para identificar problemas rápidamente.
Confianza y transparencia: verifica los resultados de las corridas automáticas por disparador con registros de ejecución detallados.
Monitoreo simplificado: el chat y las automatizaciones aparecen juntos, sin tener que cambiar de contexto.
Seguimiento de rendimiento: accede a métricas de tiempo y uso de tokens para detectar pasos lentos.
🧭 Cómo Usar el Registro de Actividad
Paso 1: Ve al Estudio de Agentes IA. Entra a la sección de Agentes IA en CRMHUB, abre el Estudio de Agentes IA y selecciona tu Agente Gestionado.
Paso 2: Abre la pestaña Actividad. Haz clic en la pestaña Actividad, que muestra la insignia con el número de corridas recientes. Las corridas aparecen en orden cronológico inverso.
Paso 3: Explora el registro. Desplázate para ver todas las corridas — tanto de chat como automáticas — con su estado, marca de tiempo, tipo de disparador y contexto. Haz clic en cualquier fila para abrir su registro de ejecución.
Paso 4: Consulta el registro de ejecución. Al hacer clic en una corrida se muestra su registro de ejecución, con el título de la conversación, botones de acción (actualizar, tiempo, uso de tokens, "Copiar ID", "Ver en Registros de Agentes"), la vista de la conversación del agente (a la izquierda) y la línea de tiempo de ejecución (a la derecha).
🔍 Entendiendo los Datos del Registro
Ícono de la corrida: un rayo indica corridas automáticas por disparador; una burbuja de chat indica conversaciones en vivo.
Estado de la corrida: indica si la ejecución se completó con éxito, falló o sigue en progreso.
Marca de tiempo: muestra cuándo comenzó la corrida, útil para correlacionar la actividad con eventos externos.
Etiqueta de tipo de disparador: la insignia "Disparador" (automatización) o "Chat" (conversación en vivo) distingue el origen de la interacción.
Descripción de contexto: para disparadores, muestra el nombre del formulario o de la etiqueta; para chat, muestra una vista previa del mensaje.
📄 Cómo Revisar el Detalle de Ejecución de una Corrida
Vista de conversación del agente (izquierda): muestra el resumen de la corrida, el tiempo de "pensamiento" del agente y un resumen estructurado de la ejecución, con pasos numerados y tablas de datos que muestran los campos y valores usados.
Línea de tiempo de ejecución (derecha): muestra los pasos secuenciales, incluyendo llamadas al modelo de lenguaje y el uso de cada herramienta, con métricas de tiempo y de tokens. Los pasos se pueden expandir para revelar las entradas, salidas y datos estructurados en detalle.
Barra de acciones superior: incluye el título de la conversación, un ícono de actualizar, el tiempo total de ejecución, el uso total de tokens, el botón "Copiar ID" y el botón "Ver en Registros de Agentes" para acceder a una vista más amplia con más espacio en pantalla.
❓ Preguntas Frecuentes
¿Dónde está el Registro de Actividad? Dentro del Estudio de Agentes IA, en la pestaña Actividad de cada Agente Gestionado compatible.
¿Qué tipos de corridas aparecen? Conversaciones de chat en vivo (burbuja de chat, etiqueta "Chat") y disparadores automáticos (rayo, etiqueta "Disparador") originados por envíos de formulario o cambios de etiqueta.
¿Cómo identifico si una corrida tuvo éxito o falló? Los indicadores de estado, como "Completado" o estados de error visibles, muestran el resultado de cada corrida.
¿Qué contiene el registro de ejecución? La vista de conversación con el resumen de la corrida y el resumen estructurado de ejecución, además de la línea de tiempo con los pasos, sus tiempos y su uso de tokens.
¿Cómo depuro una corrida fallida? Haz clic en la corrida fallida para abrir su registro de ejecución, revisa la vista de conversación y los pasos de la línea de tiempo para ubicar el punto de falla, y examina los mensajes de error dentro de los pasos expandidos.
¿Puedo exportar los datos de actividad? La disponibilidad de exportación puede variar; usa "Copiar ID" para referenciar una corrida específica en notas o conversaciones de soporte.
¿Puedo ver la actividad de varios agentes al mismo tiempo? Cada Registro de Actividad es específico de un agente; navega a la pestaña de cada agente por separado para revisar varios agentes.
¿Qué significan las métricas de tiempo y tokens? El tiempo muestra la duración de un paso o de la corrida completa; los tokens indican las unidades de procesamiento de texto consumidas por el modelo de IA en cada paso o corrida.