Skip to main content
O LangChain Agent é o motor da Zatten. Todo projeto novo nasce nele. O motor antigo (OpenAI e OpenRouter chamados direto) é legado: continua funcionando para quem ainda está nele, mas não recebe recursos novos. Recomendação única: migre. Não existe caso em que ficar no motor antigo seja a melhor escolha. O que só existia lá (busca na web, code interpreter, base de arquivos) tem substituto no LangChain Agent, descrito abaixo. Como migrar está em Migrar para o LangChain Agent.

​
Em qual motor o projeto está?

  • No painel, em Agente: o LangChain Agent abre o builder, com os botões Salvar e Publicar e o histórico de versões. O motor antigo abre a tela antiga; se a conta pode migrar, ali aparece o botão Migrar.
  • No template (get_template): llm_attendant.llm vale LANGCHAIN_AGENT no motor atual. OPENAI_RESPONSES ou OPEN_ROUTER é o motor antigo.

​
O que o LangChain Agent traz

​
O que vale igual nos dois motores

Buffer, pausa humana, segmentação, voz (ElevenLabs), Ativo/Inativo e Horário de funcionamento são aplicados pelo servidor da Zatten, antes e depois do agente. Funcionam igual nos dois motores e não mudam na migração. A voz não tem tela no builder do LangChain Agent: muda só pelo template (Segmentação e voz). Ver Como o agente funciona.

​
O que só existia no motor antigo e como substituir

A migração avisa, no resultado, quais destes o projeto usava (“Sem equivalente no novo motor: …”). Monte o substituto antes de publicar.

​
Busca na web → MCP Firecrawl

O catálogo de servidores MCP do builder já traz o Firecrawl. Ele dá ao agente tools para buscar na web e ler páginas.
1

Crie a chave

Crie uma conta e uma chave em https://www.firecrawl.dev. O custo das buscas é cobrado pelo Firecrawl, à parte.
2

Adicione o servidor

No builder, em Tools, adicione um servidor MCP e escolha Firecrawl no catálogo. Preencha o header Authorization com Bearer seguido da chave.
3

Diga no prompt quando buscar

Exemplo: “Use a busca na web só para conferir horários e endereços de terceiros. Nunca busque preços nossos: eles estão na skill tabela-de-precos.”
4

Teste e publique

Teste no chat do builder com uma pergunta que exige busca. Depois publique.
Alternativas: uma tool HTTP que chama uma API de busca da sua escolha (você controla o formato da resposta), ou um app de busca em Integrações, se houver um que sirva.

​
Code interpreter → tool HTTP ou skill

O agente não executa código. Para cada tipo de conta, escolha:
  • Cálculo que precisa ser exato (orçamento, frete, parcelas, juros): uma tool HTTP para um endpoint seu que recebe os números e devolve o resultado. A conta fica certa sempre, e a regra muda num lugar só. Ver Como montar a sua API.
  • Tabelas de consulta (preços por faixa, prazos por região): uma skill com a tabela.
  • Contas simples (somar dois itens, aplicar 10%): um modelo com raciocínio costuma resolver. Para valor que vai para o cliente, prefira a tool.

​
Base de arquivos → skill, tool HTTP ou MCP

  • Conteúdo curto e estável (FAQ, políticas, cardápio, regras de atendimento): copie o texto para uma ou mais skills. O agente carrega cada skill só quando precisa. O builder avisa quando a soma das skills passa de cerca de 100 KB.
  • Base grande ou que muda sempre (catálogo de produtos, documentos jurídicos): uma tool HTTP para uma busca que devolve só os trechos relevantes. Pode ser uma API sua ou, se os arquivos já estão num vector store da OpenAI, a busca de vector store da própria API da OpenAI (ver o guia de Retrieval em “Para saber mais”).
  • Base que já existe num serviço com servidor MCP: ligue o servidor MCP dele.

​
Pelo MCP

  • llm_attendant.llm diz o motor. O assistente não muda o motor pelo template: migrar é pelo painel.
  • Num projeto no motor antigo, o bloco langchain é ignorado na escrita, com nota.
  • Skills do projeto (bloco skills) são convertidas em tools skill quando o projeto está no LangChain Agent.

​
Armadilhas

  • Migrar sem montar o substituto: o agente que usava busca na web ou base de arquivos passa a responder sem essa informação, e pode inventar. Monte a tool ou a skill e teste antes de publicar.
  • Um servidor MCP expõe todas as tools dele. Os filtros de tools do MCP (allowed_tools, blocked_tools) são aceitos, mas não filtram nada hoje. Explique no prompt quais usar.
  • Skill grande + limpeza de contexto: a limpeza pode apagar uma skill já carregada. Ver Skills do agente.
  • “Contexto v2” aparece em Configurações avançadas, mas não faz nada no LangChain Agent. Só o motor antigo lê essa chave. Ligada ou desligada, o resultado é o mesmo.
  • Busca na web custa duas vezes: o serviço de busca cobra pela busca, e o texto das páginas entra como tokens de entrada no modelo.

​
Perguntas frequentes

Funciona, mas é legado: não ganha recursos novos e não tem retry, fallback, versões nem LangSmith. A recomendação é migrar.
Não. Todo projeto novo nasce no LangChain Agent.
O custo é o do modelo, por token, nos dois. O LangChain Agent aproveita melhor o cache de prompt, o que tende a baixar o custo da entrada. Ver Estimar o custo de IA.

​
Para saber mais

Termos para buscar: “LangChain middleware”, “Firecrawl MCP server”, “vector store search API”, “RAG tool calling”, “agent skills progressive disclosure”.