Índice
- Introducción
- Cómo acceder a los Logs y Eventos
- ¿Cómo funciona?
- Activación
- Contactos y contextos
- Tracking Mode
- Número de tokens
Introducción
La funcionalidad fue desarrollada con el objetivo de auxiliar al usuario de Blip a depurar sus flujos. Con los "Logs y Eventos" es posible observar el flujo actual del contacto inteligente a partir de la entrada del usuario.
Por ejemplo: puede analizar un usuario específico y seguir toda su jornada: contacto, contexto, tiempo transcurrido en cada acción y el log bruto completo de las acciones realizadas en cada paso.
Cómo acceder a los Logs y Eventos
En la pantalla Studio:
En la esquina superior derecha de la pantalla, haga clic en el icono
.
En el menú que se abra, seleccione Logs y eventos.
Se abrirá la siguiente pantalla:
¿Cómo funciona?
Los "Logs y Eventos" presentan las siguientes funcionalidades:
Tracing de contactos
Verificación de direccionamientos
Seguimiento de errores
Contenido de variables de contexto
Borrar contexto de un usuario específico
Esta funcionalidad es soportada en cualquier canal que tenga integración con la plataforma Blip.
Activación
Al activar los ‘Logs y Eventos’ tendrá acceso al monitoreo de los mensajes traficados por el bot, de esta forma es posible visualizar el contenido de cada una.
Ejemplos de uso
En la pantalla de Logs y Eventos, será posible visualizar todos los mensajes traficados en el contacto en el que el Tracing está activo. Para depurar un flujo, aún en la pantalla de logs y eventos, puede ir al icono de laboratorio, después en probar chatbot publicado o en construcción. En el monitoreo de los mensajes, es posible realizar algunos filtros:
Canal
Id de usuario
A partir de ahí, verá la pantalla de monitoreo:
Haciendo clic sobre un bloque, es posible visualizar toda la información de ejecución del flujo como, por ejemplo:
Información de ejecución de scripts;
Registro de Eventos (Trackings);
Peticiones HTTP;
Modelo, prompt, historial de mensajes y herramientas utilizadas (bloque de agente)
La funcionalidad de Logs y Eventos es una herramienta poderosa para entender y mejorar el comportamiento de su agente. Con ella, es posible ver en detalle el contexto que llega al agente, las herramientas disponibles en el momento, el prompt utilizado, la respuesta generada por el agente y el retorno de las herramientas activadas. Esta visión integral permite identificar puntos de mejora y ajustar al agente para un desempeño más eficaz.
Contactos y contextos
Haciendo clic en el globo que contiene el mensaje es posible visualizar y editar toda la información del usuario, las variables de contexto y de contacto.
Creación, edición y eliminación de variables de contexto
Tracking Mode
El tracking mode es una funcionalidad que permite visualizar los trackings (o TrackEvents) de una forma fácil, sin tener que rebuscar en el JSON de todo el proceso.
Para activar el Tracking Mode, basta con hacer clic en el botón que dice Modo Tracking en la barra superior de la pantalla. Cuando aparezcan los mensajes, verá la información debajo de cada bloque.
Tras la activación, podrá visualizar los trackings de cada bloque y tener acceso a la categoría, acción y variables extras.
También es posible ocultar los bloques que no tienen trackings haciendo clic en el botón con el icono de interrogación en la parte superior derecha de la pantalla.
Número de tokens
Entendiendo el Uso de Tokens en los Logs
Para ayudarlo a monitorear el desempeño y el costo de su agente, Studio muestra el consumo de tokens en la pantalla de Logs y Eventos.
¿Qué son los Tokens?
Piense en los tokens como las "piezas de un rompecabezas" o las sílabas de una palabra. Para la Inteligencia Artificial, todo lo que lee y escribe se transforma en estas pequeñas unidades para que pueda procesar la información.
¿Dónde visualizar?
Encontrará esta información directamente en el bloque del agente o en detalles haciendo clic en el bloque y accediendo al campo "usage".
Detalle de la Información
Al analizar el consumo, verá cuatro indicadores principales:
Input Tokens (Tokens de Entrada): Es todo lo que el agente necesita "leer" para entender qué debe hacer. Esto incluye sus instrucciones de sistema, las herramientas disponibles y el historial de la conversación (memoria de corto plazo).
Input Cached (Caché de Entrada): Es como una "memoria rápida". Es información que el modelo ya ha procesado recientemente y ha guardado para ahorrar tiempo y esfuerzo, haciendo que la respuesta sea más ágil.
Output Tokens (Tokens de Salida): Es la cantidad de texto que el agente "escribió" para responder al usuario. Puede limitar este tamaño en las configuraciones del agente a través del parámetro Max Tokens.
Total Tokens: Es la suma de todo lo que fue procesado (Entrada + Caché + Salida).
Consejo Práctico: A medida que el usuario conversa con el agente, el número de tokens tiende a crecer, ya que el agente necesita "releer" el historial acumulado para mantener el contexto de la conversación.
¿Cómo analizar en detalle?
Si desea una visión técnica completa, haga clic en el bloque del agente dentro del Log y busque la sección usage. Allí, el término "completion_tokens" se refiere exactamente a los Tokens de Salida (la respuesta generada).
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los vídeos en nuestro canal. 😃