Onde fica no painel
Menu Logs (/logs), título Logs do agente. Só admin e editor veem;
gestor e visualizador não têm o menu.
A tabela mostra, da mais recente para a mais antiga, 20 por página:
Como usar
Filtrar por tipo
Buscar
O campo Buscar por Erro, Nome e WhatsApp do lead procura primeiro leads pelo nome ou número. Se achar, mostra os registros desses leads. Se não achar nenhum lead, procura o termo no texto da mensagem e no detalhe do erro.Como depurar o agente
1
Ache o lead
Busque pelo número ou nome do lead que reclamou. Veja a sequência: a mensagem do
lead, o que veio depois.
2
Filtre por Erros
Se houver um erro logo depois da mensagem do lead, ele explica a falta de
resposta. Leia o Tipo e os Detalhes e use a tabela abaixo.
3
Sem erro e sem resposta?
Provavelmente a IA estava pausada ou desligada para o lead, ou a mensagem ainda
estava no buffer. Confira no chat do lead e em Pausa humana
e Buffer.
4
Respondeu errado?
Logs mostram o que foi enviado, não por que o modelo decidiu assim. No LangChain
Agent, as chamadas de tool e o raciocínio ficam no
LangSmith, com cada passo da conversa. Ligue o
LangSmith no projeto antes de precisar.
No LangChain Agent, as chamadas de tool não aparecem no filtro Function
Calls: ficam no LangSmith. Esse filtro mostra as chamadas do motor antigo. Mais um
motivo para migrar e ligar o LangSmith.
O que cada erro comum quer dizer
No LangChain Agent, todo erro do agente é gravado como
ERROR_OPENAI, qualquer
que seja o provider (OpenAI ou OpenRouter): modelo que recusou ou caiu, tempo
esgotado, servidor MCP fora do ar. O prefixo OPENAI é histórico. O motivo real está em
Detalhes, num texto que começa com “LangGraph error:” ou “LangGraph request
failed:”. Os tipos específicos (ERROR_OPENAI_KEY, _RATE_LIMIT, _TIMEOUT e os
outros da tabela) só aparecem em projetos no motor antigo. Para ver o passo exato que
falhou, abra o trace no LangSmith.Como funciona por trás
- Logs é uma visão das mensagens do projeto, com o tipo e o erro de cada uma. Não é um log técnico separado: um erro aparece aqui porque foi gravado junto da conversa.
- O total de páginas é estimado: em projetos grandes, o número no rodapé é aproximado.
- Um erro de entrega também gera o evento de erro nos Webhooks de eventos, se houver um com a opção de erros ligada. Use para ser avisado sem abrir a tela.
Pelo MCP
O MCP não lê logs. O assistente consulta pelo navegador (Usar o painel pelo navegador) ou pelo histórico do lead na API (A API do dia a dia). Para o raciocínio do agente, o LangSmith.Armadilhas
- Sem erro não quer dizer que deu certo. A IA pausada, desligada ou fora do horário não gera erro: simplesmente não responde.
- Busca por nome acha o lead, não o texto. Se o termo bate com um lead, a tela mostra os registros dele e não procura o termo nas mensagens de outros leads.
- O detalhe do erro vem do provider, muitas vezes em JSON e em inglês. Leia o
messagee ocode. - Logs não mostram as execuções do Trigger Flow. Elas ficam no botão Execuções do editor (Execuções e depuração).
Perguntas frequentes
O agente não respondeu e não há erro. O que olhar?
O agente não respondeu e não há erro. O que olhar?
O estado da IA no lead (ligada, pausada ou desligada), a pausa humana, o horário do
agente e se a conversa estava numa coluna que desliga a IA
(Funil).
Por quanto tempo os logs ficam?
Por quanto tempo os logs ficam?
Enquanto as mensagens ficarem no histórico do projeto, conforme o plano. Ver
Planos, limites e cobrança.
Para saber mais
- Observabilidade com LangSmith
- Como o agente funciona
- Testar o agente
- Janela de 24h
- Códigos de erro da Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
- LangSmith, observabilidade: https://docs.langchain.com/langsmith/observability
- Termos para buscar: “WhatsApp Cloud API error 131047”, “131026”, “131049”, “rate limit”, “context length exceeded”.