Memory stores
Memory stores dão contexto persistente aos agents sem transformar cada session em uma fonte isolada de verdade.
#O que é memória
Um memory store é uma coleção de documentos versionados por path. Ele serve para informações que precisam sobreviver a uma execução: preferências de cliente, resumos aprovados, políticas internas, decisões anteriores ou contexto de negócio reutilizável.
Memória não substitui o event log. O event log explica o que aconteceu em uma session; memory stores guardam conhecimento que pode ser montado em sessions futuras.
#Modelo de documento
Cada documento tem conteúdo textual e metadados de integridade, como versão, tamanho, hash, autor e estado de redação. Escrever novamente no mesmo path cria uma versão nova em vez de sobrescrever silenciosamente a anterior.
Esse modelo permite auditar evolução de contexto, comparar versões e reconstruir qual informação estava disponível para uma session.
#Como entra em uma session
Ao criar a session, monte um memory store como read-only ou read-write.
- Read-only: o agent pode consultar contexto, mas não altera documentos.
- Read-write: o agent pode registrar novos aprendizados ou resumos quando a tool de memória estiver disponível.
Use read-write apenas quando escrever memória fizer parte do produto. Para contexto estático, prefira read-only.
#Boas práticas
- Nomeie paths por domínio, não por implementação:
clientes/cus_123/resumo.md. - Guarde fatos estáveis e aprovados; evite despejar transcrições inteiras sem curadoria.
- Separe memória operacional de conteúdo sensível por store quando políticas forem diferentes.
- Use redação quando o conteúdo não deve mais ser legível, mas a trilha precisa permanecer.
- Prefira resumos compactos e verificáveis a documentos longos sem estrutura.