Saltar al contenido principal
La observabilidad en Brain Studio te permite registrar eventos de seguimiento directamente desde la configuración de tus nodos, para entender cómo interactúan los usuarios en cada punto de tu workflow. Estos eventos alimentan tus métricas y paneles de rendimiento.

​
¿Cómo funciona?

Los paneles de configuración de nodos como HTTP, SOAP, Código, Tool, Condicional, Skill y AI Agent, entre otros, incluyen una pestaña Eventos. Desde ahí puedes registrar hasta 10 eventos por nodo, cada uno con su propio nombre, condición de emisión y propiedades personalizadas. Cuando un nodo tiene eventos configurados, verás una insignia debajo de él en el canvas con un resumen de los eventos activos. Si no has configurado ninguno, la insignia muestra “Sin eventos activos”.

​
Configurar un evento

1

Abre la pestaña Eventos

Selecciona el nodo que quieres instrumentar y entra a su panel de configuración. Junto a la pestaña General encontrarás la pestaña Eventos, con el título “Configuración de evento”.
2

Agrega un evento

Haz clic en “Agregar evento” y completa el campo “Nombre del evento”. El nombre debe estar en snake_case (por ejemplo, payment_attempted o cita_agendada); si no cumple el formato, verás el error “Debe ser snake_case”.
3

Agrega propiedades (opcional)

En “Propiedades del evento”, usa “Agregar campo” para incluir hasta 5 pares de clave/valor. El valor puede ser una variable dinámica, como {{$context.amount}} o {{$memory.nombre_cliente}}.
Consulta las Variables de Contexto disponibles para saber qué datos puedes incluir en el payload de tus eventos.
Límites por nodo: máximo 10 eventos, cada uno con hasta 5 propiedades. Los nombres de evento y de propiedad deben escribirse en snake_case.

​
Ejemplo práctico

Tienes un nodo Tool llamado “Cobrar Pago” que procesa un cobro. Configuras un evento así:
  • Nombre del evento: payment_attempted
  • Cuándo registrar el evento: Éxito
  • Propiedades del evento:
    • monto: {{$context.amount}}
    • metodo: {{$context.payment_method}}
Cada vez que el nodo complete un cobro exitosamente, se registrará este evento con el monto y el método de pago usados, listos para analizarse en tus métricas.
Tienes un nodo API que consulta un sistema externo. Configuras un evento para detectar fallas:
  • Nombre del evento: consulta_externa_fallida
  • Cuándo registrar el evento: Error
  • Propiedades del evento:
    • codigo_error: {{$context.statusCode}}
Esto te permite identificar rápidamente cuántas veces y por qué falla esa integración.
Esta funcionalidad se está habilitando progresivamente para las empresas en Brain Studio.

​
Artículos relacionados

Nodos de Brain Studio

Conoce todos los tipos de nodos disponibles y cómo configurarlos.

Variables de Contexto

Aprende a usar $context y otras variables disponibles durante la ejecución.

Tu Primer Workflow

Aprende a crear tu primer workflow desde cero.