Memória de agentes de IA: contexto, histórico, fontes e regras de projeto
Por que uma janela de contexto grande não é memória, e como separar histórico de sessão, fatos de longo prazo, fontes, procedimentos e exclusão.
“O agente lembra de tudo” oculta vários mecanismos diferentes. Um modelo recebe um contexto limitado para a solicitação atual. Uma aplicação pode armazenar o histórico da sessão, recuperar trechos de documentos, registrar fatos duradouros sobre um usuário e carregar regras de projeto. Misturar esses níveis faz o sistema esquecer detalhes importantes, repetir informações obsoletas e expor dados à tarefa errada.
Uma janela de contexto é uma bancada de trabalho, não um arquivo
O contexto contém instruções do sistema, mensagens, resultados de ferramentas, arquivos e a resposta. Mesmo uma janela grande tem custo e limite. Mais texto irrelevante torna o detalhe necessário mais difícil de reter, e uma ressalva inicial pode desaparecer em meio a logs. Aparar o histórico e resumir cria espaço, mas um resumo também pode descartar uma exceção.
O contexto responde a “o que o modelo pode ver agora?”. A memória responde a “o que a aplicação armazenou e o que pode recuperar depois?”. Uma janela maior não substitui seleção, procedência e retenção.
A memória de curto prazo mantém o estado de um thread
O objetivo atual, o arquivo selecionado, as ferramentas já chamadas e o resultado intermediário pertencem ao estado da sessão ou do thread. LangGraph descreve threads e checkpoints como uma forma de preservar o estado entre etapas. Isso permite retomar após uma pausa, inspecionar um checkpoint anterior ou se recuperar de uma falha.
Esse estado não deve passar automaticamente para outro projeto ou conversa. Um token temporário, uma hipótese inacabada e o caminho de um arquivo rascunho são úteis dentro do thread atual e perigosos como memória global.
Memória semântica, episódica e procedural fazem trabalhos diferentes
A memória semântica armazena fatos e preferências: o fuso horário de um usuário, a stack do projeto ou um formato de relatório escolhido. A memória episódica armazena experiências úteis: como uma falha semelhante apareceu e qual solução funcionou. A memória procedural define como o trabalho é feito: instruções, políticas, ordem de verificação e regras de ferramentas. O guia conceitual do LangMem usa essa distinção.
Todo fato precisa de procedência, escopo e tempo. “O usuário prefere respostas concisas” pode ser global. “Não alterar o schema nesta release” pertence a um projeto e a um período. Um episódio sem resultado transforma a memória em um log ruidoso; um procedimento sem versão continua impondo um processo obsoleto.
Fontes e RAG fornecem evidência, não verdade automática
A recuperação encontra trechos relevantes e os adiciona ao contexto. Ela ajuda com uma base de conhecimento grande demais para ser enviada por completo. A qualidade depende de chunking, metadados, filtros de acesso, ranqueamento e atualização. Um trecho com palavras semelhantes pode pertencer a outro produto ou ano.
Preserve um link do documento e o trecho citado junto a um fato recuperado. Mostre a fonte em uma resposta crítica. Excluir um documento deve excluir ou invalidar seus embeddings e resumos derivados; caso contrário, o agente continua “lembrando” material que não existe mais.
AGENTS.md e regras de projeto são memória de equipe revisável
Para um agente de programação, um arquivo explícito de regras costuma ser mais útil do que uma memória automática oculta. Ele pode registrar comandos de build, limites de diretórios, estilo, critérios de conclusão e ações proibidas. As boas práticas do Codex recomendam fornecer um objetivo, contexto, restrições e definição de pronto, mantendo instruções duradouras em AGENTS.md.
O arquivo é versionado com o código, revisado e aplicado dentro de um escopo legível. Um conjunto longo de regras contraditórias ainda prejudica o desempenho. Mantenha as regras da raiz gerais e coloque instruções restritas perto da área relevante do projeto.
Escrever memória deve ser uma decisão separada
Não transforme toda mensagem em um fato de longo prazo. Classifique primeiro o candidato: ele é duradouro, quem é o dono, quão sensível é e pode ser verificado? Peça confirmação para fatos de perfil de usuário: “Salvar esta preferência?”. Um fato de cliente de um agente de suporte pertence a um sistema de registro governado, não a um índice vetorial irrestrito.
Atualizações exigem resolução de conflitos. Um novo cargo pode substituir um antigo, enquanto um novo endereço pode precisar de verificação. Alguns fatos devem expirar automaticamente. Procedimentos devem mudar por meio de uma versão e de um proprietário, não pelo prompt incidental mais recente.
Esquecimento, privacidade e testes completam a arquitetura
Usuários precisam de uma forma de inspecionar, corrigir e excluir material armazenado. O sistema deve explicar o escopo: esta sessão, este projeto, a conta ou a organização. Dados sensíveis são criptografados, o acesso é filtrado antes da recuperação, e logs não retêm segredos indefinidamente.
Teste a memória como uma sequência: salve um fato, altere-o, introduza um conflito, vá para outro projeto, exclua a fonte e pergunte novamente. Verifique tanto a lembrança quanto o esquecimento correto. Produtos relevantes aparecem na coleção de memória de agentes de IA da AIDive. Boa memória não é o maior armazenamento; é o menor conjunto de dados corretos retornado no escopo certo e no momento certo.