---
title: Memória do Agent
description: Configure a memória do seu Agent para que ele lembre de informações importantes de conversas anteriores com o mesmo cliente.
---

# Memória do Agent

Pensa num atendente que, toda vez que um cliente liga, começa do zero — sem lembrar que aquela pessoa já ligou ontem com o mesmo problema. Frustrante, né? A memória do Agent resolve exatamente isso.

Com a memória habilitada, o Agent extrai e armazena fatos importantes das conversas (nome do cliente, preferências, problemas recorrentes) e os recupera automaticamente nas próximas interações. O resultado é uma conversa muito mais natural e personalizada.

## Como funciona

1. **Durante a conversa:** o Agent identifica fatos relevantes que o cliente mencionou.
2. **Ao final:** um modelo de IA de extração (por padrão, `gpt-4o-mini`) lê a conversa e salva os fatos mais importantes numa base de memória vinculada ao contato.
3. **Na próxima conversa:** antes de responder, o Agent busca automaticamente os fatos salvos daquele contato e os inclui no contexto — como se o atendente tivesse relido as anotações antes de atender.
4. **Durante a conversa, sob demanda:** além da busca automática no início, o Agent também pode buscar um fato específico que não veio nessa busca inicial — útil em conversas longas. Disponível automaticamente quando a memória está ligada no nó **Agente de IA**; veja os detalhes em [Agente de IA → Busca de memória sob demanda](/guia/flow-builder/ia/agent-no#busca-de-memoria-sob-demanda-memory-search).

## Habilitando a memória

Para ativar, acesse a aba **Memória** nas configurações do Agent e ligue o toggle **Habilitar memória**.

<Passos>
  <Passo>

Acesse as configurações do Agent e clique na aba **Memória**.

  </Passo>
  <Passo>

Ligue o toggle **Habilitar memória**.

  </Passo>
  <Passo>

Ajuste os parâmetros conforme a necessidade do seu Agent (detalhes abaixo).

  </Passo>
  <Passo>

Salve as configurações e teste enviando algumas mensagens no painel de teste. Na segunda conversa, verifique se o Agent lembra dos fatos da primeira.

  </Passo>
</Passos>

## Parâmetros de memória

| Parâmetro | Padrão | O que controla |
|-----------|--------|---------------|
| Habilitar memória | Desligado | Liga ou desliga a memória |
| Quantidade de fatos recuperados (Top K) | `5` | Quantos fatos são recuperados por conversa. Mais fatos = mais contexto, mas também mais tokens (custo). |
| Similaridade mínima | `0.75` | Nota mínima de parecença (de 0 a 1) para um fato ser considerado relevante para a conversa atual. Valores mais altos = mais precisão, mas menos fatos retornados. |
| Máximo de fatos armazenados | `200` | Máximo de fatos guardados por contato. Quando atinge o limite, os mais antigos são descartados. |
| Modelo de extração | `gpt-4o-mini` | Modelo usado para extrair fatos da conversa. O `gpt-4o-mini` já equilibra bem custo e qualidade. |
| Dias de retenção | `365` | Por quantos dias os fatos ficam armazenados antes de expirar. |

<Cuidado>

**O toggle "Habilitar memória" aqui no Agent controla só a extração** (salvar fatos ao final da conversa). Para o Agent efetivamente **ler** esses fatos numa conversa, o nó **Agente de IA** que o executa no Flow Builder também precisa ter a opção **Memória** ligada (desligada por padrão). São dois interruptores independentes — os dois precisam estar ligados. Veja o detalhe em [Agente de IA → Memória do Agent no nó](/guia/flow-builder/ia/agent-no#memoria-do-agent-no-no-dois-interruptores-nao-um-so).

</Cuidado>

## Boas práticas

<Dica>

Comece com os valores padrão. Eles já funcionam bem para a maioria dos casos. Ajuste a quantidade de fatos recuperados (para mais contexto) ou a similaridade mínima (para mais precisão) só se perceber problemas de comportamento.

</Dica>

<Cuidado>

Fatos armazenados na memória contêm dados dos clientes — nome, preferências, histórico de problemas. Isso é dado pessoal. Siga as políticas de privacidade da sua empresa e as regras da LGPD ao habilitar essa funcionalidade. Use o campo de dias de retenção para garantir que dados não sejam guardados indefinidamente além do necessário.

</Cuidado>

**Quando usar uma quantidade maior de fatos recuperados (ex.: 10):**
- Conversas longas com muito contexto acumulado
- Agents de suporte com histórico rico de problemas

**Quando usar uma similaridade mínima mais alta (ex.: 0.85):**
- Quando o Agent está recuperando fatos irrelevantes e "confundindo" as conversas de clientes diferentes

## Saiba mais

- [Conhecimento (Base de Conhecimento)](/guia/agents/conhecimento) — outra forma de dar contexto ao Agent, a partir de documentos
- [Ferramentas do Agent](/guia/agents/ferramentas) — conectar sistemas externos, skills e sub-agents