Como funciona a memória
Armazene um resultado tipado, recupere com busca híbrida, cite o que você usou.
Uma "memória" no ValorBrain é um documento em uma coleção, dentro de um tenant. Agentes devem tratar a recuperação como consulta à verdade da empresa, não como um log de chat.
Armazenar
Prefira a escrita tipada:
- MCP:
memory_storecomtype∈decision|observation|problem|milestone|handoff|lesson|note - REST/CLI:
POST /documents(CLIadd)
store (isolado) ainda existe no catálogo MCP como alias deprecado de
memory_store. Não o documente para clientes novos; não o chame.
O texto é armazenado verbatim. Português continua português.
Corpos curtos (abaixo de ~200 caracteres) podem pular o embedding. Eles continuam buscáveis no caminho léxico.
Recuperar
O caminho padrão é híbrido: BM25 + vetores densos + RRF, e depois um rerank de cross-encoder no produto hospedado.
| Ferramenta / rota | Quando |
|---|---|
memory_retrieve / POST /search | Uma pergunta bem formulada. O servidor expande e funde. |
memory_prepare | Início de sessão / "me dê o contexto para esta tarefa" |
working_context | A orientação mais barata: fatos estáveis + decisões recentes |
memory_grep | String exata, id, data, chave — não uma paráfrase |
Não dispare cinco recuperações quase duplicadas. Se o primeiro conjunto vier
magro, troque de ferramenta: exato → memory_grep; mais de um acerto →
get / multi_get; por quê → find_causal_links (toolset graph).
Coleções
Uma coleção é um bucket com nome (decisions, incidents, …). list /
GET /collections mostra o que o tenant tem. Você escolhe o nome na hora de
escrever; não existe taxonomia global obrigatória para clientes.
O loop de ranking
Depois de responder com memória recuperada, chame memory_used com os docids
que você realmente usou. Memórias usadas sobem; ignoradas decaem. verdict
opcional: confirmed ou corrected quando o humano reage. Este é o sinal
de ranking mais forte do produto. A taxa de declaração atual, no mundo real,
é baixa — não faça parte desse número.