Agora, cada entrada no painel de registros segue um mesmo padrão de leitura: o que o agente fez, sobre o quê, com qual resultado e a que horas. Todos os registros aparecem colapsados por padrão para facilitar a leitura cronológica, e você pode expandi-los para ver o detalhe exato da operação. Além disso, cada registro fica localizado exatamente no ponto da conversa em que ocorreu, facilitando o contexto da ação.
📋 Que tipo de informação registra o Painel de registros?
O painel registra 6 tipos de operações principais. Aqui você tem um exemplo de como se visualiza cada uma:
1. Consulta à base de conhecimento
Quando o agente busca informação nos documentos carregados.
Se visualiza como:
Consultou [nome_do_documento](ex. Consultou modelos-catalogo-2026.pdf).Ao expandir: Você poderá ver exatamente quais termos a IA buscou (ex. "consumo Corolla LE") e o fragmento específico do documento que o sistema recuperou e usou para redigir a resposta.
2. Consulta a um Catálogo
Quando o agente cruza informação com tabelas de dados em tempo real (Catálogos).
Se visualiza como:
Consultou [nome_do_catalogo](ex. Consultou Promos ativas Julho26).Ao expandir: Você verá quais parâmetros o agente buscou (ex. "promos ativas Corolla") e exatamente quais linhas de informação o catálogo lhe devolveu. (Nota: As integrações externas agora são identificadas como "Aplicação externa").
3. Execução de uma Ferramenta (Integrações/APIs)
Quando o agente executa uma ação contra sistemas externos ou ferramentas nativas.
Se visualiza como:
Executou [nome_ferramenta], junto com o status do resultado marcado visualmente como Bem-sucedida ou Falha (ex. Executou GET_SHEET_DATA — Bem-sucedida).Ao expandir: Você verá o detalhe técnico completo (payload) da requisição enviada e a resposta devolvida pelo sistema, em formato JSON legível, com quebras de linha e um botão para copiar.
Se falhou: O painel mostrará o código e mensagem de erro, junto aos dados com os quais o agente tentou fazer a chamada.
Importante: Por segurança, as credenciais ou tokens de autenticação nunca são mostrados neste registro.
4. Passagem de um agente a outro (Ramos/Nós)
Quando a conversa salta para uma nova intenção ou para um agente especializado.
Se visualiza como: O nome do ramo tomado e a condição que se cumpriu (ex. Moveu para Awareness — "pediu cotação"). Mostra de onde vinha e para onde foi.
Ao expandir: Se o modelo de IA deixou um registro de raciocínio (reasoning) sobre por que tomou essa decisão, aparecerá aqui. Se não há reasoning disponível, a entrada simplesmente não mostrará a opção de expandir-se.
5. Captura de um dado (Campos)
Quando o agente salva informação fornecida pelo usuário nas variáveis do sistema.
Se visualiza como: O nome do campo e o valor salvo (ex. Capturou Email — mailto:[email protected]). Se o valor exceder a largura, se trunca visualmente e você pode vê-lo completo ao expandir.
Casos especiais:
Se o agente não conseguir capturar o dado ou o apagar, será mostrado explicitamente como "sem valor" (a entrada não se omite).
Se um mesmo campo se sobrescrever durante a mesma conversa, será criada uma nova entrada cronológica para cada escrita.
6. Captura de Etapas, Tipificações e Rótulos
Quando a conversa avança no funil ou se classifica.
Etapas: Registra em ordem os estados pelos quais passou (ex. Etapa: MQL — mql).
Tipificação: Mostra a tipificação aplicada. Ao expandir, você verá qual parte da conversa justificou essa tipificação.
Rótulos: Mostra os rótulos aplicados e seus valores. Se vários forem aplicados, se listarão todos juntos.
🕵️♂️ Como diagnosticar problemas comuns com o Painel de registros
O que NÃO está no painel, também é informação. A ausência de um registro é tão importante quanto sua presença. Se você notar que um agente respondeu de forma incorreta ou alucinada, o primeiro que deve buscar é se existe um registro de "Consulta a base de conhecimento". Se a entrada não está, significa que o agente respondeu de memória sem consultar a documentação da sua empresa.
Aqui mostramos como resolver os três cenários de suporte mais frequentes:
"O agente passou a conversa para o agente/nó errado."
O que buscar: Revise o registro de Passagem de um agente a outro (Ramos).
Como resolvê-lo: Expanda a entrada para ler o reasoning. Você verá exatamente qual instrução a IA interpretou para tomar essa decisão. Geralmente, isso se resolve refinando o prompt ou a descrição do nó destino para que seja mais específico e a IA não se confunda.
"O agente respondeu algo incorreto ou sem consultar a documentação."
O que buscar: Busque o registro de Consulta à base de conhecimento ou omissão da mesma logo antes da mensagem do agente.
Como resolvê-lo: Se o registro não existe, você deve ajustar o prompt do agente para tornar obrigatório o uso da base de dados. Se o registro sim existe, expanda-o para ver quais termos a IA buscou; é provável que seu documento não tenha a resposta redigida de forma clara para essa busca específica.
"A conversa terminou por uma saída que não correspondia (ou se aplicou uma tipificação errônea)."
O que buscar: Revise o registro de Captura de Etapas ou Tipificação ao final do fluxo.
Como resolvê-lo: Expanda o evento para ver a justificativa. Se a IA tipificou como "Venda perdida" quando era "Acompanhamento", revise se as definições das suas tipificações na configuração do agente são claras o suficiente para que a IA entenda a diferença.
O Painel de registros não é apenas um registro técnico, é a mente do seu agente exposta passo a passo. Use-o para entender como a IA toma decisões, auditar integrações falhadas (verificando o payload enviado e recebido) e corrigir comportamentos não desejados sem necessidade de escalar constantemente para suporte técnico. ✅