Design de memória para agentes: o que persistir, o que resumir e o que esquecer

O que é

Um modelo só enxerga a sua janela de contexto; tudo o mais que um agente "lembra" é resultado de engenharia. O artigo do MemGPT descreve isso como gerenciamento de contexto virtual: a informação é movida entre o contexto limitado e um armazenamento externo, da mesma forma que um sistema operacional faz a paginação da memória, e é o próprio modelo que decide o que carregar e o que descartar. Na prática, há três camadas: o contexto (mensagens atuais e resultados de ferramentas); um scratchpad da tarefa (plano, notas de progresso, resultados intermediários, guardados como arquivos ou como um objeto estruturado e recarregados quando necessário); e a memória durável entre sessões (preferências, fatos sobre um ambiente, decisões anteriores). As ferramentas dos provedores seguem esse modelo. A memory tool da Anthropic roda no lado do cliente: o modelo solicita operações de arquivo sob o prefixo /memories, que a aplicação mapeia para um armazenamento sob o seu controle, e a documentação orienta quem implementa a rejeitar caminhos fora desse diretório. O recurso de edição de contexto pode remover resultados de ferramentas mais antigos (a estratégia clear_tool_uses_20250919, que substitui cada resultado removido por um texto de placeholder) para liberar espaço.

Por que importa

Com memória de menos, o agente refaz trabalho e esquece uma instrução dada dez passos antes; com memória demais, o contexto se enche de saídas de ferramentas desatualizadas, que tiram espaço da tarefa, consomem tokens a cada chamada e propagam erros antigos. Uma memória durável que nunca é podada vira um depósito de fatos obsoletos nos quais o agente confia.

Como aplicar

• Mantenha o plano e o progresso em um scratchpad que o agente atualiza de forma explícita (feito, próximo, bloqueado); recarregue-o após qualquer compactação do contexto.
• Persista entre sessões apenas o que continuará verdadeiro depois e que custaria esforço ao usuário repetir: preferências, fatos sobre o ambiente, decisões com suas justificativas. Registre cada item com um timestamp e sua origem.
• Não persista saídas brutas de ferramentas, segredos nem dados pessoais além da sessão; em vez disso, busque-os novamente.
• Resuma ou remova resultados antigos de ferramentas depois que eles já tiverem sido usados; mantenha os identificadores para que possam ser buscados de novo.
• Deixe a memória durável visível e editável pela pessoa e restrinja as operações de memória ao diretório de memória.
• Faça as memórias expirarem ou volte a verificá-las: um fato sobre a estrutura de um repositório deixa de ser verdade após a próxima refatoração.
• Trate o conteúdo da memória como dado, não como instrução: um "execute sempre este comando" injetado em um arquivo de memória persiste entre sessões.

Armadilhas

Memórias em texto livre, sem estrutura, que ninguém consegue revisar. Carregar todas as memórias em todos os prompts. Memórias que transformam uma falha passada em regra ("os testes nunca passam aqui"). Um único armazenamento de memória compartilhado entre usuários.