#MEMORY
O que um agente aprende.Continua lá da próxima vez.
Fatos recuperados por significado e registros JSON recuperados por chave. Um agente, uma função, o seu backend e o dashboard leem o mesmo armazenamento.
#O QUE GUARDA
Fatos, por significado
O texto vira embedding ao ser escrito. Uma busca ordena o que está guardado por similaridade com a pergunta, não por palavra-chave.
Registros, por chave
Documentos JSON em uma coleção, lidos pela sua chave. Até dois campos indexados por coleção, para consultar por campo.
Três scopes
O projeto, um contato ou uma conversa. Uma busca em um scope nunca retorna um fato de outro.
Sem código
Adicione memória a um agente pelo dashboard e ele recebe duas skills juntas: remember e recall.
No seu código
ctx.memory dentro de qualquer handler de uma função, client.memory no SDK de TypeScript e REST em /v1/memory.
Expira quando você quiser
Um fato ou um registro pode se apagar sozinho depois do tempo que você definir, de 60 segundos a dois anos.
#DO SEU BACKEND
import Zavudev from "@zavudev/sdk"
const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY })
// A fact, filed against the person it is about.
await zavu.memory.add({
text: "Prefers WhatsApp over email.",
scope: "contact",
contactId: "jd7x2k3m4n5p6q7r8s9t0abc",
})
// Recalled by meaning. minScore makes "nothing on record" a real answer.
const { items } = await zavu.memory.search({
query: "how they prefer to be contacted",
scope: "contact",
contactId: "jd7x2k3m4n5p6q7r8s9t0abc",
minScore: 0.3,
})
// A JSON record, recalled by key.
await zavu.memory.collections.items.put("ORD-12345", {
collection: "orders",
scope: "contact:jd7x2k3m4n5p6q7r8s9t0abc",
value: { status: "shipped", total: 42.5 },
})#COMO UM AGENTE USA
- 01
Lembra
A skill remember salva um fato sobre a pessoa com quem o agente está falando. Se a Zavu não identificou quem escreve, ela recusa.
- 02
Recupera
Antes de responder, recall busca primeiro nesse contato e depois no projeto. Resultados abaixo de 0.3 de similaridade não são retornados.
- 03
Você pode ver
A tela Memory do dashboard mostra o que foi guardado em cada scope, e permite buscar e apagar.
#ANTES DE CONSTRUIR EM CIMA
- O Free inclui 250.000 unidades por mês e 0.5 GB, e para aí: novas escritas são recusadas até o dia 1, enquanto ler e apagar continuam funcionando.
- O Pro inclui 2.000.000 de unidades por mês e 5 GB. Depois disso são $5 por milhão de unidades e $1 por GB por mês.
- Uma unidade é a capacidade que uma requisição usa, e uma escrita conta cinco vezes uma leitura. Salvar um fato são cerca de 25 unidades; um recall sobre um contato com 100 fatos, cerca de 30.
- Os scopes têm limite: 10.000 fatos para o projeto (5.000 no Free), 2.000 por contato, 1.000 por conversa.
- Tudo cai por padrão no scope do projeto. Um fato sobre um cliente escrito ali pode ser recuperado na conversa de qualquer outro cliente, então guarde-o no contato.
- Os campos indexados de uma coleção são declarados na criação e não podem ser adicionados depois. Um registro comporta até 200 KB.
Dê memória ao seu agente.
Memory está em todos os planos, Free incluído. Comece com as duas skills e passe para código quando precisar.