Pular para o conteúdo principal
A observabilidade no Brain Studio permite registrar eventos de rastreamento diretamente na configuração dos seus nós, para entender como os usuários interagem em cada ponto do seu workflow. Esses eventos alimentam suas métricas e painéis de desempenho.

​
Como funciona?

Os painéis de configuração de nós como HTTP, SOAP, Código, Tool, Condicional, Skill e AI Agent, entre outros, incluem uma aba Eventos. A partir dela você pode registrar até 10 eventos por nó, cada um com seu próprio nome, condição de emissão e propriedades personalizadas. Quando um nó tem eventos configurados, você verá um selo abaixo dele no canvas com um resumo dos eventos ativos. Se nenhum estiver configurado, o selo mostra “Sem eventos ativos”.

​
Configurar um evento

1

Abra a aba Eventos

Selecione o nó que deseja instrumentar e acesse seu painel de configuração. Ao lado da aba Geral, você encontrará a aba Eventos, com o título “Configuração de evento”.
2

Adicione um evento

Clique em “Adicionar evento” e preencha o campo “Nome do evento”. O nome deve estar em snake_case (por exemplo, payment_attempted ou consulta_agendada); se não seguir esse formato, você verá o erro “Deve ser snake_case”.
3

Adicione propriedades (opcional)

Em “Propriedades do evento”, use “Adicionar campo” para incluir até 5 pares de chave/valor. O valor pode ser uma variável dinâmica, como {{$context.amount}} ou {{$memory.nome_cliente}}.
Consulte as Variáveis de Contexto disponíveis para saber quais dados você pode incluir no payload dos seus eventos.
Limites por nó: máximo de 10 eventos, cada um com até 5 propriedades. Os nomes de evento e de propriedade devem ser escritos em snake_case.

​
Exemplo prático

Você tem um nó Tool chamado “Cobrar Pagamento” que processa uma cobrança. Você configura um evento assim:
  • Nome do evento: payment_attempted
  • Quando registrar o evento: Sucesso
  • Propriedades do evento:
    • valor: {{$context.amount}}
    • metodo: {{$context.payment_method}}
Toda vez que o nó concluir uma cobrança com sucesso, esse evento será registrado com o valor e o método de pagamento usados, prontos para serem analisados nas suas métricas.
Você tem um nó API que consulta um sistema externo. Você configura um evento para detectar falhas:
  • Nome do evento: consulta_externa_falhou
  • Quando registrar o evento: Erro
  • Propriedades do evento:
    • codigo_erro: {{$context.statusCode}}
Isso permite identificar rapidamente quantas vezes e por que essa integração falha.
Essa funcionalidade está sendo habilitada progressivamente para as empresas no Brain Studio.

​
Artigos relacionados

Nós do Brain Studio

Conheça todos os tipos de nós disponíveis e como configurá-los.

Variáveis de Contexto

Aprenda a usar $context e outras variáveis disponíveis durante a execução.

Seu Primeiro Workflow

Aprenda a criar seu primeiro workflow do zero.