Como Funciona a Memória

O bot não esquece tudo quando a conversa acaba. Ele tem memória de longo prazo, histórico de mensagens e a conversa atual — mas cada coisa mora em um lugar diferente.

A analogia certa

Pense no bot como alguém que trabalha com três materiais:

Caderno de referência — arquivos Markdown com fatos, preferências, decisões e contexto importante
Arquivo de conversas — histórico bruto das mensagens, para buscar quando você pedir
Mesa de trabalho — a conversa atual, com o que acabou de ser dito

No dia a dia, ele consulta o caderno antes de responder. Se precisar de uma fala exata, data ou mensagem antiga, ele pode buscar no arquivo de conversas.

Onde a memória durável fica hoje

A memória consolidada fica em arquivos Markdown no workspace do bot, normalmente dentro de memory/.

Exemplos:

MEMORY.md — mapa geral: onde procurar cada tipo de conhecimento
memory/pessoas/... — perfis de pessoas, preferências, contexto e biografia
memory/projetos/... ou memory/projects/... — projetos em andamento, conforme a instalação
memory/protocolos/... — procedimentos e regras operacionais detalhadas
memory/daily/... — notas diárias e contexto salvo automaticamente

O banco ainda existe, mas não é mais “a memória principal” do bot. Ele guarda principalmente histórico bruto de mensagens, contatos, missões, regras e dados de operação.

O que é um fato?

Fato é uma informação curta e útil que o bot pode reaproveitar depois.

Exemplos:

"Diego prefere relatórios curtos pela manhã"
"Projeto Papo Alfa é um podcast com entrevistas de empreendedores"
"Com este cliente, responder sempre com linguagem simples"

Fatos importantes viram texto organizado nos arquivos de memória. O bot pode buscar esses arquivos por significado, não só por palavra exata.

Como os fatos são criados?

Automaticamente

O sistema pode registrar contexto importante em rotinas específicas, mas fatos duráveis devem ser verificados e organizados na memória Markdown.

Por pedido seu

Você pode pedir claramente:

"Guarda que eu prefiro receber relatórios em texto, não em tabela"

"Lembra que o prazo do projeto X é dia 15"

"Salva isso: meu telefone novo é 99999-1234"

Quando você pede explicitamente, a chance de virar memória útil é maior.

Como o bot usa a memória?

Antes de responder, o bot pode buscar nos arquivos de memória os trechos mais relevantes para aquele assunto. Essa busca é chamada de Search Memory.

Ela combina:

busca por texto exato
busca semântica, por significado
ranking de relevância

Ou seja: se você falar “aquele projeto do restaurante”, ele pode encontrar notas antigas mesmo que o arquivo use outro termo parecido.

Histórico completo de mensagens

Além da memória em Markdown, o bot mantém histórico bruto das conversas.

Use quando quiser recuperar algo literal:

"O que eu falei ontem sobre a reunião?"

"Busca a mensagem do Fernando sobre o preço da soja"

"O que aconteceu no grupo de manhã?"

Importante: o bot não relê todo o histórico antes de cada resposta. Seria lento e caro. Ele usa a memória consolidada como atalho e busca mensagens brutas quando isso for necessário.

Por que parece que ele esqueceu?

Os motivos mais comuns são:

A informação não virou memória consolidada — ela está no histórico, mas não foi promovida para os arquivos Markdown
A memória está desatualizada — algo mudou depois
O bot não buscou o lugar certo — peça para verificar no histórico ou na fonte
A sessão foi compactada — conversas longas são resumidas para caber no modelo
A informação não era relevante para aquela pergunta — o bot priorizou outro contexto

Como resolver:

"Busca no histórico o que eu falei sobre X"

"Verifica isso de novo na fonte"

"Atualiza essa informação: agora é Y"

Compactação e memória

Conversas muito longas são compactadas: o sistema resume parte do histórico para continuar cabendo no modelo.

Antes disso, o bot tenta salvar pontos importantes nos arquivos de memória. Mesmo assim, se algo for crítico, diga explicitamente:

"Guarda isso na memória"

Memória não é missão, regra ou automação

Isso confunde bastante:

memória guarda informação relevante
missão acompanha um objetivo até desfecho
regra contextual muda como o bot age em certo contexto
automação faz algo em horário ou intervalo definido

Guardar uma informação não cria missão. Lembrar de uma preferência também não cria regra automaticamente.

Boas práticas

Diga quando algo precisa ser guardado
Corrija dados errados assim que perceber
Peça para verificar se o assunto depende de data, preço, status ou decisão recente
Dê uma pista quando retomar coisa antiga: "sobre aquele projeto de março..."