Skip to main content
A cada mensagem, a Zatten acrescenta ao pedido do agente dois blocos de texto que o prompt não precisa conter:
  • “Contexto do lead atual”: nome, WhatsApp, notas, tags, coluna do funil e as propriedades marcadas para ir à IA. Só vai com Enviar dados ligado.
  • “Agora”: dia da semana, data e hora cheia de Brasília. Vai sempre.
Com isso o agente sabe com quem fala e que horas são, sem que o prompt mude de conversa para conversa. Vale para o LangChain Agent.

​
Onde fica no painel

Em Agente, seção Modelo, clique no ícone de configurações ao lado do modelo. Em Configurações do modelo, a chave Enviar dados liga o bloco “Contexto do lead atual”. Como todo o config do agente, a mudança vale depois de Publicar. O bloco “Agora” não tem chave: vai em toda mensagem.

​
Como os blocos chegam ao modelo

Os dois blocos vão juntos, numa mensagem de sistema colocada no fim do pedido, depois do histórico da conversa:
Os títulos são exatamente ## Contexto do lead atual e ## Agora. Eles não mudam, e o prompt pode citá-los pelo nome.

​
O que entra no “Contexto do lead atual”

Linha sem valor não aparece. Um lead novo, sem tags nem notas, recebe só as linhas preenchidas.

​
O “Agora”

Dia da semana, data e hora cheia no horário de Brasília, sem minutos e sem acentos (por exemplo, terca-feira, 07/10/2026, 9h (horario de Brasilia)). A hora é cheia de propósito: o bloco muda só uma vez por hora, o que preserva o cache do provider. Para horário comercial (“8h às 18h”), a precisão de hora basta. O fuso é sempre o de Brasília. Se o cliente final atende em outro fuso, diga no prompt como converter.

​
Por que no fim, e não no prompt

O prompt fica igual em todas as conversas e o histórico só cresce, então o começo do pedido se repete e o provider o reaproveita do cache (mais barato e mais rápido). Os dados do lead e a hora mudam no meio da conversa: se estivessem no prompt, quebrariam o cache inteiro a cada mudança. No fim, só o último trecho é novo. Veja Escrever um bom prompt. Os blocos são lidos na hora de cada chamada ao modelo. Se o agente move o lead de coluna ou um humano acrescenta uma tag no meio da conversa, a chamada seguinte já vê o valor novo. Os blocos não são gravados no histórico. Não aparecem em Conversas e não se acumulam na conversa. Aparecem no LangSmith, se estiver ligado.

​
Marcar propriedades para ir à IA

Só vão ao agente as propriedades marcadas com enviar para a IA (send_to_ai). A marcação vem ligada por padrão: propriedade criada pelo painel já vai para a IA. A tela de propriedades não mostra a opção; para mudá-la, use o template do projeto, no bloco properties. Veja Propriedades personalizadas. A propriedade vai identificada pelo slug (convenio), não pelo nome (“Convênio”). Escreva o prompt com o slug. Marque só o que ajuda o agente a decidir: convênio, interesse, faixa de preço, etapa da negociação. Dados que o agente não usa só aumentam o pedido.

​
Como citar os blocos no prompt

​
Ligar “Enviar dados”

Recomendação: ligado, em todo projeto. Sem ele, o agente não sabe o nome, as tags, a coluna nem as propriedades do lead; só vê o prompt e a conversa. Quando o campo não existe no config, o padrão do agente é desligado. Projetos migrados do motor antigo nascem com ele ligado. Confira em cada projeto.
Não confunda com o Enviar dados da conversa das tools HTTP. Lá, a opção acrescenta a identidade do lead (ID, número, conversa) ao corpo da chamada para a sua API. Aqui, os dados vão para o modelo.

​
Como funciona por trás

O servidor da Zatten lê, a cada mensagem, o lead, a coluna, os nomes das tags e as propriedades com send_to_ai ligado, e envia esses dados junto do lote para o agente. O agente monta os dois blocos e os põe no fim do pedido. No chat de teste do painel, os dados vêm do lead de teste do projeto.

​
Pelo MCP

  • Enviar dados: langchain.config.instructions.inject_context (true ou false). Escrever cria uma versão não publicada.
  • Propriedade para a IA: properties[].send_to_ai no template do projeto.

​
Armadilhas

  • “Enviar dados” desligado sem ninguém perceber. O agente pergunta o nome a quem já se apresentou e ignora tags e etapa. Confira a chave em todo projeto.
  • Propriedade com send_to_ai desligado. O valor existe no lead, mas o agente não vê. Não há aviso. (O padrão é ligado; isso acontece quando alguém desligou pelo template.)
  • Prompt usando o nome da propriedade. O bloco usa o slug. “Se o Convênio for…” funciona pior que “Se a propriedade convenio for…”.
  • Anotações internas vão para o modelo. Tudo o que a equipe escreve em Notas é enviado ao provider de IA (e ao LangSmith, se ligado). Não escreva ali o que não deve sair da Zatten.
  • Fuso fixo. O “Agora” é sempre Brasília. Cliente final em outro fuso precisa de instrução no prompt.
  • Hora sem minutos. Não peça ao agente cálculos que dependam de minutos (“faltam 15 minutos para fechar”).
  • Renomear coluna ou tag muda o que o agente lê. O prompt que compara a coluna com “Agendado” deixa de funcionar se a coluna virar “Consulta marcada”.

​
Perguntas frequentes

Sim, se a propriedade estiver marcada para ir à IA. Na chamada seguinte ao modelo, o valor novo já está no bloco.
Não. Eles não são gravados no histórico e não aparecem em Conversas.
Não pelo contexto. Grave o dado numa propriedade marcada para ir à IA (pela API ou por um fluxo), ou crie uma tool HTTP que o agente chama para buscar.
O motor antigo não tem esses blocos. Ele é legado: migre para o LangChain Agent.

​
Para saber mais

Termos para buscar: “context engineering”, “runtime context LangChain”, “prompt caching dynamic content at the end”, “inject_context”.