Logs e Eventos – Blip | Blip Help

Índice

Introdução

A feature foi desenvolvida tendo como objetivo auxiliar o usuário do Blip a debugar seus fluxos. Com os "Logs e Eventos" é possível observar o fluxo corrente do contato inteligente, a partir do input do usuário.

Por exemplo: Você pode analisar um usuário específico e seguir toda a sua jornada: contato, contexto, tempo decorrido em cada ação e o log bruto completo das ações realizadas em cada passo.

Como acessar os Logs e Eventos

Você pode abrir os Logs e Eventos da seguinte forma:

Tela inicial (Home):
- No canto superior direito da tela, clique no ícone .
- No menu que abrir, selecione Testes e Logs.

Menu lateral:
- No menu lateral esquerdo, clique em Logs e Eventos.

Como funciona?

Os "Logs e Eventos" apresentam as seguintes funcionalidades:

Tracing de contatos
Verificação de direcionamentos
Acompanhamento de erros
Conteúdo de variáveis de contexto
Apagar contexto de um usuário específico

Essa feature é suportada em qualquer canal que tenha integração com a plataforma Blip.

Ativação

Ao ativar os ‘Logs e Eventos’ você terá acesso ao monitoramento das mensagens trafegadas pelo bot, dessa forma é possível visualizar o conteúdo de cada uma.

Exemplos de uso

Na tela de Logs e Eventos, será possível visualizar todas as mensagens trafegadas no contato em que o Tracing está ativo. Para debugar um fluxo, ainda na tela de logs e eventos, você pode ir em ícone de laboratório, depois em testar chatbot publicado ou em construção. No monitoramento das mensagens, é possível realizar alguns filtros:

Canal
Id de usuário

A partir daí, você verá a tela de monitoramento

Clicando em cima de um bloco, é possível visualizar todas as informações de execução do fluxo como, por exemplo:

Informações de execução de scripts;
Registro de Eventos (Trackings);
Requisições HTTP;
Modelo, prompt, histórico de mensagens e tools utilizadas (bloco de agente)

A funcionalidade de Logs e Eventos é uma ferramenta poderosa para entender e aprimorar o comportamento do seu agente. Com ela, é possível ver em detalhes o contexto que chega para o agente, as ferramentas disponíveis no momento, o prompt utilizado, a resposta gerada pelo agente e o retorno das ferramentas acionadas. Essa visão abrangente permite identificar pontos de melhoria e ajustar o agente para um desempenho mais eficaz

Contatos e contextos

Clicando no balão contendo a mensagem é possível visualizar e editar todas as informações de usuário, variáveis de contexto e de contato.

Criação, edição e deleção de variáveis de contexto

Tracking Mode

O tracking mode é funcionalidade, que permite visualizar os trackings (ou TrackEvents) de uma forma fácil, sem ter que vasculhar o JSON do processo inteiro.

Para ativar o Tracking Mode, basta clicar no botão escrito "Tracking Mode" na barra superior da tela. Quando as mensagens aparecerem, você verá as informações abaixo de cada bloco.

Após ativar, você poderá visualizar os trackings de cada bloco e ter acesso à categoria, ação e variáveis extras.

É possível também esconder os blocos que não tem trackings clicando no botão com o ícone de interrogação no topo direito da tela

Número de tokens

Entendendo o Uso de Tokens nos Logs

Para ajudar você a monitorar o desempenho e o custo do seu agente, o Studio exibe o consumo de tokens na tela de Logs e Eventos.

O que são Tokens?

Pense nos tokens como as "peças de um quebra-cabeça" ou as sílabas de uma palavra. Para a Inteligência Artificial, tudo o que ela lê e escreve é transformado nessas pequenas unidades para que ela consiga processar a informação.

Onde visualizar?

Você encontra essas informações diretamente no bloco do agente ou em detalhes clicando no bloco e acessando o campo "usage".

Detalhamento das Informações

Ao analisar o consumo, você verá quatro indicadores principais:

Input Tokens (Tokens de Entrada): É tudo o que o agente precisa "ler" para entender o que deve fazer. Isso inclui suas instruções de sistema, as ferramentas disponíveis e o histórico da conversa (memória de curto prazo).
Input Cached (Cache de Entrada): É como uma "memória rápida". São informações que o modelo já processou recentemente e guardou para economizar tempo e esforço, tornando a resposta mais ágil.
Output Tokens (Tokens de Saída): É a quantidade de texto que o agente "escreveu" para responder ao usuário. Você pode limitar esse tamanho nas configurações do agente através do parâmetro Max Tokens.
Total Tokens: É a soma de tudo o que foi processado (Entrada + Cache + Saída).

Dica Prática: Conforme o usuário conversa com o agente, o número de tokens tende a crescer, pois o agente precisa "reler" o histórico acumulado para manter o contexto da conversa.

Como analisar no detalhe?

Se quiser uma visão técnica completa, clique no bloco do agente dentro do Log e procure pela seção usage. Lá, o termo "completion_tokens" refere-se exatamente aos Tokens de Saída (a resposta gerada).

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃