Skip to main content
O painel tem dois jeitos de testar o LangChain Agent sem afetar leads reais:
  • Chat de teste: conversa com o agente como se fosse um lead, usando a configuração que está na tela, inclusive alterações ainda não salvas.
  • Testar (no editor de uma tool HTTP): roda uma tool sozinha e mostra o que a API respondeu e o que o agente leria.
Teste sempre antes de Publicar. Publicar põe a mudança no ar para todos os leads (Versões e publicação).

​
O chat de teste

Onde fica: menu Agente (/project), à direita do editor. Só aparece em tela larga (computador); no celular, a coluna do chat some. No topo do chat, um selo diz o que está rodando: Botões no topo: Nova conversa (+) começa do zero; Conversas anteriores (ícone de relógio) reabre um teste anterior.

​
O contato de teste

O agente responde como se falasse com o contato de teste do projeto (WhatsApp 5511999999999, nome “Contato Teste”). Os dados dele aparecem no painel Informações do Contato, ao lado do chat: nome, coluna do funil, tags, departamento, responsável, status da IA e propriedades. São esses dados que entram no contexto injetado e nas variáveis das tools ({{lead_name}}, {{lead_properties.x}}). Para testar um caso específico (um lead numa coluna, com uma tag), coloque o contato de teste nesse estado antes de conversar. Resetar dados do contato volta o contato ao início: nome “Contato Teste”, primeira coluna, sem tags, sem responsável, sem departamento, sem pausa e sem propriedades.
As tools rodam de verdade. Mover no funil, aplicar tag ou preencher propriedade age sobre o contato de teste. Uma tool HTTP chama a API real do cliente (cria o pedido, reserva o horário). Uma ação de app integrado (Gmail) envia o e-mail de verdade. Antes de testar uma tool que mexe em sistema externo, combine com o cliente final um ambiente ou um dado de teste.

​
O que o chat de teste mostra

  • A resposta do agente, como o lead leria (sem a divisão em várias mensagens).
  • Cada chamada de tool, num cartão: os argumentos e o retorno. Erro de tool aparece marcado.
  • Chamadas a load_skill (qual skill foi carregada) e a write_todos (a lista de tarefas).
Com o monitoramento ligado na versão testada, o teste também vai para o LangSmith, com o passo a passo completo.

​
O que o chat de teste não testa

O chat de teste chama o agente direto. O que acontece fora do agente, no caminho do WhatsApp, não passa por ele: Para esses testes, use um número de WhatsApp da equipe como lead e encerre o atendimento depois.

​
Testar uma tool HTTP

No editor de uma tool HTTP (seção Tools → a tool → Testar), a tool roda uma vez, pelo mesmo código que roda no atendimento.
  • Usa os dados do contato de teste para as variáveis do lead. Os campos de texto podem ser editados no painel de teste. Sem contato de teste, usa valores de exemplo.
  • Os argumentos que o modelo preencheria ({{args.x}}) você digita.
  • O resultado tem três abas:
Se uma variável do lead estiver vazia, aparece Variável não disponível e a chamada não é feita, como aconteceria com um lead real sem aquele dado. Endereços internos (rede privada) são bloqueados no teste. As ações da Zatten (mover no funil, tag, departamento etc.) não têm o botão Testar: teste pelo chat de teste e confira o efeito no contato de teste. Detalhes dos campos em Tool HTTP: referência.

​
O que testar antes de publicar

Escreva os casos antes de mexer, e repita os mesmos casos depois de cada mudança.
1

O caminho feliz

O atendimento mais comum do cliente final, do “oi” ao fechamento (agendou, pediu orçamento, foi qualificado). Confira cada tool chamada e o efeito no contato de teste.
2

O que mudou

O caso que motivou a mudança. Se foi correção de um erro real, use a mensagem do lead que deu errado (do chat do painel ou do LangSmith).
3

Transferência para humano

Peça para falar com uma pessoa e confira que o agente transfere.
4

Fora do escopo

Uma pergunta que o agente não deve responder (preço que não está nas regras, assunto fora do negócio). Ele não pode inventar.
5

As skills

Uma pergunta que exige cada skill. Confira no cartão que load_skill foi chamada com a skill certa.
6

Erros de tool

Se possível, um caso em que a API do cliente devolve erro. O agente deve avisar o lead sem inventar que a ação foi feita.
7

Os estados do lead

Repita um caso com o contato de teste noutra coluna ou com outra tag, se o prompt depender disso.
Depois de publicar, acompanhe as primeiras conversas reais no chat do painel e no LangSmith.

​
Pelo MCP

O MCP da Zatten não conversa com o agente nem roda tools. Depois de uma escrita no bloco langchain (que cria uma versão não publicada), o teste é feito no painel:
  • pela própria pessoa, no chat de teste, com a versão nova aberta no seletor; ou
  • pelo assistente, com navegador, confirmando o nome do projeto na tela antes.
Em Para você fazer no painel, inclua “testar no chat de teste” antes de “publicar”.

​
Armadilhas

  • Testar a versão errada. Confira o selo no topo do chat: Rascunho, no ar ou não publicada.
  • Teste passou, produção falhou. Buffer, pausa, mídia, segmentação e automações não passam pelo chat de teste.
  • Contato de teste num estado esquecido. Uma tag ou etapa deixada por um teste anterior muda o contexto. Use Resetar dados do contato.
  • Efeito real fora da Zatten. Tools HTTP e ações de apps integrados agem em sistemas reais.
  • A aprovação aparece no teste, mas não existe no WhatsApp. Um cartão de aprovação no chat de teste indica uma tool com aprovação ligada; no atendimento real, isso trava a conversa. Desligue (Limites e segurança).
  • Salvar não é publicar. Testou e gostou: salve e publique.

​
Para saber mais