Memoria de la empresa
La memoria de Quipua es contexto que tu empresa escribe a propósito (quiénes sois, cómo trabajáis, datos de producto, reglas de cada área) y que Quipua añade a cada petición de la API, para que todas las aplicaciones y personas partan del mismo contexto sin repetirlo en cada prompt. Nunca se captura de las conversaciones.
Cómo funciona
- Se activa por organización en el panel (Memoria). Mientras no esté activada, no se añade nada.
- Se escribe en el panel, por capas: empresa (para todas las keys), equipo (para las keys de ese equipo) y un resumen de cada área.
- Cada key tiene un modo de memoria:
| Modo | Qué recibe |
|---|---|
| Empresa + equipo (por defecto) | Memoria de la empresa y la de su equipo. |
| Dirección | Lo anterior y además el resumen de todas las áreas. Lo asigna un Responsable. |
| Sin memoria | Nada. |
Quipua la antepone a tu prompt de sistema (en /v1/chat/completions como primer mensaje system; en /v1/messages, delante de system), siempre en el mismo orden para que caiga en la caché de prompts: con Claude se marca como cacheable automáticamente. Tus instrucciones prevalecen sobre la memoria.
Coste
Los tokens de la memoria son tokens de entrada y se cobran como tales (con el precio reducido cuando se leen de la caché). También cuentan para la reserva de saldo y para la regla de contexto largo del modelo automático, pero no para el tope de contexto de la key.
La cabecera de respuesta x-ci-memory-tokens dice cuántos tokens de memoria se añadieron (estimados).
Desactivarla en una petición
Manda la cabecera x-ci-memory: off:
r = client.chat.completions.create(
model="claude-sonnet-5",
max_tokens=300,
messages=[{"role": "user", "content": "Traduce al inglés: buenos días"}],
extra_headers={"x-ci-memory": "off"},
)const r = await client.chat.completions.create(
{
model: "claude-sonnet-5",
max_tokens: 300,
messages: [{ role: "user", content: "Traduce al inglés: buenos días" }],
},
{ headers: { "x-ci-memory": "off" } },
);curl https://api.quipua.com/v1/chat/completions \
-H "Authorization: Bearer ci_live_xxx" -H "Content-Type: application/json" \
-H "x-ci-memory: off" \
-d '{"model": "claude-sonnet-5", "max_tokens": 300, "messages": [{"role": "user", "content": "Traduce al inglés: buenos días"}]}'Proponer memoria desde tu aplicación
POST /v1/memory/proposals crea propuestas de memoria para el equipo de la key. No entran en la memoria hasta que un Responsable las aprueba en el panel (Memoria → Propuestas pendientes), donde puede editarlas y decidir si van a la memoria del equipo o de la empresa, o descartarlas (se borran).
Hay dos formas de usarlo:
1. Que el modelo destile una conversación
Mandas la conversación en messages y el modelo extrae como máximo 5 hechos duraderos (decisiones, preferencias, datos estables), excluyendo datos sensibles. La conversación se lee sólo en memoria y se descarta: Quipua no la guarda.
import httpx
r = httpx.post(
"https://api.quipua.com/v1/memory/proposals",
headers={"Authorization": "Bearer ci_live_xxx"},
json={
"messages": [
{"role": "user", "content": "A partir de ahora los envíos a Monterrey van por Estafeta."},
{"role": "assistant", "content": "Entendido, lo tendré en cuenta."},
],
},
timeout=120,
)
print(r.json())const r = await fetch("https://api.quipua.com/v1/memory/proposals", {
method: "POST",
headers: { Authorization: "Bearer ci_live_xxx", "Content-Type": "application/json" },
body: JSON.stringify({
messages: [
{ role: "user", content: "A partir de ahora los envíos a Monterrey van por Estafeta." },
{ role: "assistant", content: "Entendido, lo tendré en cuenta." },
],
}),
});
console.log(await r.json());curl https://api.quipua.com/v1/memory/proposals \
-H "Authorization: Bearer ci_live_xxx" -H "Content-Type: application/json" \
-d '{"messages": [{"role": "user", "content": "A partir de ahora los envíos a Monterrey van por Estafeta."}]}'La destilación es una petición normal al modelo con tu key (por defecto claude-haiku-4-5; puedes indicar otro en model): se cobra al equipo y pasa por saldo, presupuesto y límites. Si la conversación es muy larga, se usa el final (unos 60.000 caracteres).
2. Proponer hechos tal cual
Si tu aplicación ya sabe qué recordar, manda facts (texto u objetos con title y content). No se llama al modelo ni se cobra nada.
{"facts": [
{"title": "Paquetería Monterrey", "content": "Los envíos a Monterrey van por Estafeta."},
"El horario de soporte es de 9:00 a 18:00 (hora de Ciudad de México)."
]}Respuesta
{
"object": "list",
"distill_request_id": "…",
"data": [
{"id": 42, "title": "Paquetería Monterrey", "content": "Los envíos a Monterrey van por Estafeta.", "status": "pending"}
]
}distill_request_id es el x-request-id de la petición de destilación (o null si mandaste facts). Como máximo se crean 5 propuestas por llamada; el título se recorta a 120 caracteres y el contenido a 600.
Límites y errores
| Código | Cuándo |
|---|---|
400 invalid_request | No hay messages ni facts. |
403 memory_disabled | La organización no tiene activada la memoria. |
429 memory_proposals_full | Hay demasiadas propuestas pendientes de revisar (200 por organización). |
502 distill_failed | El modelo falló al destilar (los errores 4xx del proveedor conservan su código). |
Las propuestas pendientes caducan a los 30 días. Además se aplican los errores generales: saldo, presupuesto, límite de peticiones…
Conocimiento con búsqueda
Para documentos largos (procedimientos, catálogos, políticas, preguntas frecuentes) que no caben en la memoria fija, añádelos en el panel, Memoria → Conocimiento con búsqueda, a la empresa o a un equipo. Quipua los trocea por párrafos y los indexa con embeddings.
En cada petición busca los fragmentos más parecidos a la última pregunta y le pasa al modelo sólo esos (hasta unos 3.000 tokens), en una parte aparte que no rompe la caché de la memoria fija. Una key busca en el conocimiento de la empresa y en el de su equipo, nunca en el de otros equipos. Si nada es lo bastante parecido, no se añade nada.
- Hasta 40.000 tokens por documento y 300.000 por empresa.
- «Probar la búsqueda», en la misma página, muestra lo que recibiría la IA con una pregunta.
- Con
x-ci-memory: offtampoco se busca. - El indexado y la búsqueda los asume Quipua: no se cobran aparte.