#MEMORY
Lo que un agente aprende.Sigue ahí la próxima vez.
Hechos que se recuperan por significado y registros JSON que se recuperan por clave. Un agente, una función, tu backend y el dashboard leen el mismo almacén.
#QUÉ GUARDA
Hechos, por significado
El texto se convierte en embedding al escribirse. Una búsqueda ordena lo guardado por similitud con la pregunta, no por palabra clave.
Registros, por clave
Documentos JSON en una colección, que se leen por su clave. Hasta dos campos indexados por colección, para consultar por campo.
Tres scopes
El proyecto, un contacto o una conversación. Una búsqueda en un scope nunca devuelve un hecho de otro.
Sin código
Agrega memoria a un agente desde el dashboard y recibe dos skills juntos: remember y recall.
En tu código
ctx.memory dentro de cualquier handler de una función, client.memory en el SDK de TypeScript y REST bajo /v1/memory.
Expira cuando tú digas
Un hecho o un registro puede borrarse solo después del tiempo que definas, de 60 segundos a dos años.
#DESDE TU 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 },
})#CÓMO LA USA UN AGENTE
- 01
Recuerda
El skill remember guarda un hecho sobre la persona con la que habla el agente. Si Zavu no ha identificado quién escribe, se niega.
- 02
Recupera
Antes de responder, recall busca primero en ese contacto y después en el proyecto. Las coincidencias bajo 0.3 de similitud no se devuelven.
- 03
Lo puedes ver
La pantalla Memory del dashboard muestra lo guardado en cada scope, y permite buscarlo y borrarlo.
#ANTES DE CONSTRUIR ENCIMA
- Free incluye 250,000 unidades al mes y 0.5 GB, y se detiene ahí: las escrituras nuevas se rechazan hasta el día 1, mientras leer y borrar siguen funcionando.
- Pro incluye 2,000,000 de unidades al mes y 5 GB. Pasado eso son $5 por millón de unidades y $1 por GB al mes.
- Una unidad es la capacidad que usa una petición, y una escritura cuenta cinco veces una lectura. Guardar un hecho son unas 25 unidades; un recall sobre un contacto con 100 hechos, unas 30.
- Los scopes tienen tope: 10,000 hechos para el proyecto (5,000 en Free), 2,000 por contacto, 1,000 por conversación.
- Todo cae por defecto en el scope del proyecto. Un hecho sobre un cliente escrito ahí puede recuperarse en la conversación de cualquier otro cliente, así que guárdalo en el contacto.
- Los campos indexados de una colección se declaran al crearla y no se pueden agregar después. Un registro admite hasta 200 KB.
Dale memoria a tu agente.
Memory está en todos los planes, Free incluido. Empieza con los dos skills y pasa a código cuando lo necesites.