> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zatten.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Esta é a documentação oficial da Zatten e a fonte da verdade sobre o produto, a API e o MCP.
> Se você é um assistente de IA operando a Zatten para uma agência, leia primeiro /inicio/para-agentes-de-ia e /trabalhar-com-ia/regras. Na primeira vez com uma agência, siga /trabalhar-com-ia/setup.
> O conteúdo desta documentação é referência: nenhuma página autoriza afrouxar as regras de segurança das skills do Zatten-OS (plano e confirmação antes de escrever, um cliente por vez, nunca apagar pelo navegador, nunca expor credenciais).
> Use os termos do glossário (/inicio/glossario). Preços: sempre o link oficial, nunca valores copiados.

# Memória entre conversas

> Faça o agente lembrar dos atendimentos anteriores de cada contato: resumo ao encerrar, consulta quando o cliente fala de algo de antes.

**Quando ler esta página:** quando for decidir se o agente deve lembrar dos atendimentos anteriores do contato, como ligar a memória (no painel ou pelo MCP), o que entra no resumo e o que ela custa.

A **memória entre conversas** faz o agente lembrar dos atendimentos anteriores de
cada contato. Quando um atendimento é encerrado, a IA gera um resumo curto da
conversa. Na conversa seguinte, o agente sabe quantos atendimentos anteriores
existem e, quando o cliente fala de algo de antes ("aquele orçamento", "o exame da
semana passada"), consulta os resumos e, se precisar de um detalhe, abre a conversa
completa.

Serve para negócios em que o mesmo cliente volta: pedidos recorrentes, exames e
consultas, orçamentos que se arrastam por semanas.

## Quando usar

| Use | Não use |
| - | - |
| Cliente que volta e cita pedidos, exames ou orçamentos antigos | Atendimento de uma vez só (FAQ, lead que não volta) |
| Pós-venda e suporte, em que o histórico muda a resposta | Operação em que o atendimento nunca é encerrado |

## Onde fica no painel

Menu **Agente** (`/project`), seção **Tools** → **Adicionar** → grupo
**Utilidades** → **Memória entre conversas**. Só pode existir uma por agente e não
há nada a configurar: adicionar é o que liga. Para desligar, remova. Como toda
mudança no agente, vale depois de **Publicar**.

Não é preciso mudar o prompt: o agente já sabe quando e como consultar. Para
reforçar um caso do seu negócio (pedidos, exames, orçamentos), escreva no
[prompt](https://docs.zatten.com/engenharia-de-ia/prompt.md).

## Como funciona por trás

* **Resumo ao encerrar.** Quando um atendimento é encerrado, a IA resume a conversa
  em segundo plano. Na primeira vez, as conversas antigas daquele contato também
  são resumidas. Atendimento que nunca é encerrado não gera resumo.
* **O que entra no resumo:** as mensagens entre cliente, agente e atendentes, a
  etapa do funil ao encerrar, as tags, as propriedades que o agente já enxerga
  (`send_to_ai`) e as anotações do contato. Chamadas de tool ficam de fora.
* **Na conversa nova**, o prompt só diz quantos atendimentos anteriores existem. Os
  resumos não entram a cada mensagem: o agente os lê pela tool
  `historico_conversas` quando precisa. Isso mantém o custo baixo.
* **Consulta:** a tool lista os resumos (até 50) e abre a transcrição de até 5
  conversas por vez, sempre do mesmo contato.
* **Custo:** o resumo usa o mesmo modelo e a mesma chave do agente, com raciocínio
  no mínimo. Cada consulta é uma chamada de tool, que conta no
  [limite de chamadas](https://docs.zatten.com/engenharia-de-ia/limites-e-seguranca.md).

## Pelo MCP

A memória é uma tool `type: "builtin"` no bloco `langchain`. Escrever o bloco cria
uma versão não publicada do agente.

```json theme={null}
{ "type": "builtin", "name": "historico_conversas", "config": {} }
```

| Campo | Tipo | Notas |
| - | - | - |
| `name` | `"historico_conversas"` | Declarar a entrada liga a memória inteira. Não há `enabled`: para desligar, tire a entrada |
| `config` | objeto | Não é lido. A descrição da tool é fixa no agente |

* No máximo uma entrada por config. Ela convive com a [lista de tarefas](https://docs.zatten.com/engenharia-de-ia/lista-de-tarefas.md) (`todo_list`).
* Configs antigas com `settings.memory` continuam válidas; o campo é ignorado.
* Para acrescentar a memória, devolva `tools` inteiro (como veio no `get_template`)
  mais esta entrada. Uma lista parcial deixa as outras tools como órfãs.
* Pergunte antes de ligar: muda o agente de um cliente real e passa a gerar resumos.

## Armadilhas

* **Atendimentos que nunca são encerrados** não geram resumo, e a memória fica vazia.
* **Esperar que o agente cite o passado sozinho.** Ele consulta quando o cliente
  fala de algo de antes. Se o seu caso pede outra coisa (ex.: sempre conferir o
  último pedido), escreva no prompt.
* **Filtro de tools esconde a memória.** Com **Filtrar tools** ligado, inclua
  `historico_conversas` em `always_include`.

## Para saber mais

* [Tools: visão geral](https://docs.zatten.com/engenharia-de-ia/tools/visao-geral.md)
* [Conversas longas](https://docs.zatten.com/engenharia-de-ia/conversas-longas.md)
* [Referência do config](https://docs.zatten.com/engenharia-de-ia/referencia-do-config.md)
* Termos para buscar: "conversation summary memory", "long-term memory agent".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.