Memória para agentes de IA: por que o agente esquece e como resolver

Um agente de IA esquece. Você explica uma regra do projeto, ele segue direitinho por uma hora, e na conversa seguinte pergunta de novo qual banco de dados você usa. Isso não é descuido de quem usa: a conversa é o que o modelo enxerga, e quando ela termina, nada daquilo fica com ele por padrão. A memória de agentes é a solução para esse problema: um lugar fora da conversa onde o que importa é guardado, e de onde o agente volta a buscar quando precisa.

Por que o agente esquece

Um modelo de linguagem responde com base no texto que recebe naquele momento: as instruções, o histórico da conversa e o que você acabou de digitar. Quando você abre uma conversa nova, esse texto volta a ser pequeno. As decisões de ontem não estão nele. Mesmo quando um produto diz que "lembra" de você, em geral ele guarda algumas frases de preferência, sem regra sobre o que ainda vale.

Há três perdas diferentes, e elas pedem coisas diferentes:

Quando você joga tudo num único bloco de texto, as três se misturam. Quando você separa, o agente sabe o que pode usar sem perguntar e o que precisa confirmar.

O que uma memória de agente precisa fazer

Não basta guardar. Uma memória que só acumula vira um depósito que ninguém consegue ler. Ela precisa de algumas regras:

• Achar o que vale. Quando o agente busca, deve trazer o que está vigente, não tudo o que já foi escrito. Uma decisão substituída não pode aparecer como se ainda valesse.

• Mudar sem apagar. Quando uma regra muda, a versão nova substitui a antiga, mas a antiga continua registrada. Assim dá para saber por que o agente fez algo no passado.

• Não confundir a fala de um site com uma decisão. O que uma página ou uma ferramenta disse, e ninguém confirmou, entra como observação, não como ordem.

• Não autorizar nada. Uma memória informa. "Aprovado" guardado semana passada não aprova o envio de hoje. Quem aprova é a pessoa, no momento da ação.

Essa última regra é a que mais protege. Um agente que trata a própria memória como permissão age sobre algo que pode já ter mudado.

Onde a memória mora

Você pode guardar a memória em arquivos do projeto, na memória do próprio cliente de IA ou num serviço à parte que o agente acessa por um conector. As duas primeiras opções deixam de servir quando você troca de ferramenta, quer dividir a memória com outra pessoa ou precisa ver e corrigir o que está guardado.

O terceiro caminho é o que o Brain faz. Cada espaço é um banco próprio, isolado, e o agente conversa com ele por um endereço MCP. Quem autoriza é você, pelo login, sem chave para colar no agente. Cada conexão autorizada vale só para o espaço que você escolheu. O mesmo espaço fica visível num painel web, onde você procura, revisa e corrige.

Como o Brain resolve isso

O Brain guarda cinco tipos de memória: decisão, preferência, observação, retomada e referência. Cada tipo tem seu comportamento. Decisão, preferência e referência não vencem pelo calendário. A observação, que é o que era verdade quando alguém olhou, vale por 30 dias. A retomada, que é o estado de uma tarefa, vale por 14. Um prazo próprio pode ser dado ao salvar, pela data de validade (campo expires_at).

Quem escreve também fica registrado: você, o agente ou uma ferramenta. O agente não escreve como você. Uma decisão ou preferência escrita por ele precisa trazer a fonte, quer dizer, quem disse aquilo, e o motivo.

Na busca, o agente só recebe o que vale: o que está ativo, não vencido e não substituído. Quando duas decisões vivas discordam, o Brain avisa, em vez de escolher uma por conta própria. E quando nada se aproxima do que foi perguntado, ele diz que não encontrou.

Como começar

Você cria um espaço no painel, copia o endereço do espaço na tela Conexão e ajustes, e adiciona esse endereço ao seu cliente MCP. Ao primeiro uso, o cliente abre o login, você autoriza aquele espaço, e pronto. Não há chave para guardar; o acesso é pelo login.

A partir daí, o agente costuma buscar no começo de uma tarefa e guardar o que foi decidido durante o trabalho. Na prática, vale revisar de vez em quando, sobretudo nas primeiras semanas, porque o que o agente guarda sozinho depende do modelo e do cliente que você usa. O painel existe para isso: você vê o que entrou e corrige o que estiver torto.

Perguntas frequentes

O agente com memória externa fica mais caro de usar?

A memória fica num espaço à parte e o agente consulta só o que precisa. Ainda não há planos, e nada é cobrado.

Posso apagar uma memória que o agente guardou errado?

Sim. Você pode esquecer, que deixa de valer mas continua registrada como histórico, ou apagar de vez, pelo painel. Apagar o espaço inteiro pede que você digite o nome dele, para evitar acidente.

O Brain lê minhas conversas com o agente?

Não. Ele guarda o que o agente ou você decidem salvar. A conversa inteira não vai para o Brain. O agente pode salvar por conta própria o que as regras de uso indicam; o comportamento depende do modelo e do cliente.

Preciso saber programar para usar?

Não. Você cria o espaço, cola o endereço no cliente e autoriza pelo login. O painel mostra as memórias em lista e num mapa de ligações, sem linguagem de programação.

Para continuar lendo

• Um espaço de memória por assunto: como organizar o que o agente sabe

• Como dar memória ao Claude com um endereço MCP

• O que é um servidor MCP e para que ele serve

Uma memória que você consegue ver

Uma memória que o agente usa, mas que você não enxerga, pode virar fonte de erro. O Brain mostra o que está guardado, deixa você corrigir e registra o que foi gravado, revisado e esquecido. Se você quer que o seu agente retome o trabalho de onde parou, comece por aqui. Conhecer o Brain

Fontes

• Referência do Brain para pessoas e agentes (llms.txt)

• Página do Brain