Dos capacidades añaden contexto a tus aplicaciones y agentes. El Brain es lo que sabe tu organización: documentos y páginas que se pueden citar. Memory es lo que la plataforma recuerda de trabajar con alguien: notas breves sobre una persona, un agente o un trabajo. Ambos responden en el host de inferencia de tu región, en /brain/v1/ y /memory/v1/, con la API key que ya usas para la inferencia, y como herramientas MCP en /mcp/.
Cuál usar
| Brain | Memory | |
|---|---|---|
| Responde a | ¿Qué sabe la organización? | ¿Qué debe recordar el asistente sobre esta persona, este agente o este trabajo? |
| Autoridad | Oficial: una fuente de verdad que se cita. | Un recuerdo: útil, posiblemente erróneo o desactualizado, nunca oficial. |
| Lo escribe | Fuentes que se sincronizan y personas que son dueñas de páginas. | La persona o el agente, mientras trabajan. |
| Quién lo ve | Los spaces de su audiencia: toda la organización o un equipo. | Su dueño: una persona, un agente, un equipo o la organización. |
| Duración | Mientras exista su fuente. | Retención y vencimiento; se reemplaza cuando otro más nuevo lo sustituye; se borra a petición. |
| Consulta | Búsqueda con citas y el contexto estándar de un proyecto. | Recall: un perfil breve y los recuerdos más relevantes para una consulta. |
API keys y permisos
Usa cualquiera de los dos tipos de API key de Autenticación: una API key de cuenta de servicio para una aplicación o un agente, o la API key personal de una persona, que es como un plan Personal, sin cuentas de servicio, usa Memory y el Brain. Envíala como en la inferencia. La API key actúa con los roles de su titular, y el permiso que necesita una operación decide lo que puede hacer.
| Permiso | Permite |
|---|---|
brain.read | Buscar, leer y explorar los spaces de tu audiencia. Todos los miembros lo tienen. |
brain.manage | Crear y eliminar spaces y fuentes. Un administrador de equipo también gestiona los spaces de su equipo. |
memory.use | Guardar, recuperar, editar y borrar la memoria que te pertenece, y tus propios ajustes. Todos los miembros lo tienen. |
memory.review | Decidir sobre las propuestas de los equipos que revisas. |
memory.manage | Decidir sobre las propuestas de la organización, borrar la memoria de un miembro y la de un usuario final, y definir la política de memoria. |
memory.read | Leer la política de memoria y el uso. |
Memory y el Brain también responden en el host de la consola, con las mismas reglas. Las aplicaciones y los agentes usan el host de inferencia. Cada uno pertenece a tu plan: una organización sin capacidad de Brain responde 403 brain-disabled, y una que tiene la memoria desactivada responde 403 memory-disabled.
Memory
Un recuerdo es un texto breve de 1 a 8000 caracteres con un tipo (preference, fact, decision, event, task-state o lesson), un dueño y, opcionalmente, una etiqueta project. Todo recuerdo es eso, un recuerdo: útil, nunca oficial.
Guardar un recuerdo
Sin owner, el recuerdo es del propio llamador. Indica {"kind": "team", "team": "<team>"} o {"kind": "org"} para recordar para un equipo o para la organización, o deja que una cuenta de servicio lleve su propia memoria agent. pinned lo añade al perfil de su dueño, que el recall siempre devuelve; importance va de 1 a 5; ttl_days acorta su vida; supersedes reemplaza un recuerdo anterior del mismo dueño y proyecto.
curl "https://api.latam.ccsio.ai/memory/v1/memories" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Answers in Spanish, short and direct.",
"type": "preference",
"pinned": true
}'{
"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": null,
"session": null,
"type": "preference",
"content": "Answers in Spanish, short and direct.",
"importance": 3,
"pinned": true,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-12T10:15:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-12T10:15:00Z",
"revision": 1,
"created_at": "2026-11-12T10:15:00Z",
"updated_at": "2026-11-12T10:15:00Z"
}Quien escribe decide la procedencia, no el cuerpo: una persona, con una sesión o con una API key personal, escribe recuerdos user que ella confirmó; una cuenta de servicio escribe recuerdos agent. Lo que un agente escribe en el ámbito propio de una persona solo queda activo mientras la política de la organización y el ajuste de esa persona permitan ambos que los agentes escriban ahí; si no, se guarda como propuesta, y la respuesta sigue siendo 201.
Recuperar (recall)
El recall busca en todos los recuerdos que el llamador puede leer, por significado y por palabras a la vez, y responde con el perfil del dueño (los recuerdos fijados) y las mejores coincidencias, dentro de budget_tokens. Cada coincidencia indica si la encontró la búsqueda vectorial, la de texto o ambas. Solo se sirven recuerdos activos.
curl "https://api.latam.ccsio.ai/memory/v1/recall" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "How should I answer this user?", "limit": 5, "budget_tokens": 800}'{
"profile": [
{
"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": null,
"session": null,
"type": "preference",
"content": "Answers in Spanish, short and direct.",
"importance": 3,
"pinned": true,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-12T10:15:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-12T10:15:00Z",
"revision": 1,
"created_at": "2026-11-12T10:15:00Z",
"updated_at": "2026-11-12T10:15:00Z"
}
],
"profile_overflow": 0,
"memories": [
{
"memory": {
"id": "m-01k9x6d4f0h2k4n6q8s0v2x4z6",
"owner": { "kind": "user", "id": "u-01k7yp2c9w4x5e8h3j6m0n1q2r", "team": null },
"project": "billing",
"session": null,
"type": "decision",
"content": "We chose pgvector on 2026-11-09 because the data stays in one database.",
"importance": 4,
"pinned": false,
"provenance": { "source": "user", "trust": "user-confirmed" },
"state": "active",
"valid_from": "2026-11-10T08:00:00Z",
"superseded_by": null,
"superseded_at": null,
"expires_at": "2027-11-10T08:00:00Z",
"revision": 1,
"created_at": "2026-11-10T08:00:00Z",
"updated_at": "2026-11-10T08:00:00Z"
},
"score": 0.82,
"matched": "both"
}
],
"budget_used_tokens": 41,
"truncated": false
}Listar, editar y borrar
Una lista devuelve resúmenes con un fragmento de 200 caracteres como máximo, los más recientes primero; lee un recuerdo para obtener su texto completo. Filtra por owner, team, project, type, state y pinned. Para editar un recuerdo que te pertenece, envía el expected_revision que leíste: si alguien lo editó entretanto, no cambia nada y la respuesta es 409 memory-revision-conflict. Solo se puede editar un recuerdo activo, y cada edición añade una revisión que puedes listar.
# Read the memory: the answer carries its revision.
curl "https://api.latam.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Edit it, naming the revision you read. Another edit in between refuses yours with 409 memory-revision-conflict.
curl -X PATCH "https://api.latam.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Answers in Spanish, short and direct, with an example.", "expected_revision": 1}'
# The revisions of a memory you own, newest first.
curl "https://api.latam.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2/revisions" \
-H "Authorization: Bearer $CCSIO_API_KEY"El dueño borra un recuerdo, y también lo hace un administrador con memory.manage en nombre de un miembro, sin leerlo. Borrar elimina el texto y su vector en una sola transacción y queda registrado en el diario; la respuesta es un recibo y nunca el texto. Borrar sigue funcionando mientras la memoria está en pausa, sobre su capacidad o desactivada. Una persona también puede pausar su memoria y exportarla, en /memory/v1/me/settings y /memory/v1/exports.
# The text and its vector go in one transaction; the answer is a receipt and never the text.
curl -X POST "https://api.latam.ccsio.ai/memory/v1/memories/m-01k9x4q2c8e6g0j3m5p7r9t1v2/erase" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"id": "m-01k9x4q2c8e6g0j3m5p7r9t1v2", "state": "erased", "event_id": "...", "journal_head": {...}}Propuestas y quién las revisa
Un recuerdo espera como propuesta, y el recall nunca lo sirve, cuando un agente escribe en el ámbito de una persona que no lo permite, o cuando alguien escribe en un ámbito de equipo o de organización que la política somete a revisión (ambos por defecto). Quién decide:
- Una propuesta personal: solo su dueño.
- La propuesta de un equipo: los revisores del equipo, con
memory.review. - La propuesta de la organización: administradores con
memory.manage.
Aceptar activa el recuerdo, opcionalmente con un content corregido. Rechazar lo borra y deja constancia del borrado en el diario.
# The proposals you may decide on: yours, your teams' (memory.review) or the organization's (memory.manage).
curl "https://api.latam.ccsio.ai/memory/v1/proposals" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Accept one, as proposed or with a corrected text. It is served by recall from then on.
curl -X POST "https://api.latam.ccsio.ai/memory/v1/proposals/m-01k9x7f6h2k4n6q8s0v2x4z6b8/accept" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Releases go out on Thursdays, after the freeze."}'
# Reject one: its text and vector are erased and the erasure is journaled.
curl -X POST "https://api.latam.ccsio.ai/memory/v1/proposals/m-01k9x7f6h2k4n6q8s0v2x4z6b8/reject" \
-H "Authorization: Bearer $CCSIO_API_KEY"Los usuarios finales de tu aplicación
Una aplicación que atiende a sus propios clientes guarda lo que un agente aprende de cada uno bajo un subject: un id opaco de 1 a 128 caracteres que tú eliges, como el id de tu cliente. Solo una cuenta de servicio puede usarlo, sobre su propia memoria agent. El recall y la lista sin subject nunca devuelven un recuerdo que lo lleve, así que una aplicación nunca mezcla a dos de sus clientes. La API key de una persona que envía un subject se rechaza con 400 invalid-request.
# With the key of a service account, in the name of one of your application's end users.
curl "https://api.latam.ccsio.ai/memory/v1/memories" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content": "Asked about a refund for order 4411.", "type": "event", "subject": "customer-4711"}'
# Recall only what the agent remembers about that end user.
curl "https://api.latam.ccsio.ai/memory/v1/recall" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "open questions", "subject": "customer-4711"}'
# A privacy request: erase everything remembered about the end user (permission memory.manage).
curl -X POST "https://api.latam.ccsio.ai/memory/v1/subjects/customer-4711/erase" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"erased": 3, "event_id": "...", "journal_head": {...}}Borrar un subject es la respuesta a una solicitud de privacidad de un usuario final. Requiere memory.manage, borra en una sola transacción todos los recuerdos que llevan el subject sin leer ninguno, y responde erased con el número de recuerdos. Un subject sin recuerdos también es 200 con erased 0, así que la ruta no revela si el usuario final existió alguna vez. El subject nunca se escribe en un log ni en un evento de seguridad.
El Brain
Tu organización tiene un Brain, dividido en spaces. Una fuente trae documentos a un space, y una fuente que contiene páginas trae páginas: conocimiento en Markdown que las personas han verificado. La búsqueda, el contexto y la exploración leen ambos.
Spaces
Un space es la unidad de acceso: todos los de su audiencia leen todo lo que contiene. Un space organization es para todos los miembros; un space team es para los miembros de ese equipo. Solo ves los spaces de tu audiencia, y un space que no puedes ver se omite de una búsqueda, nunca es un error. Eliminar un space elimina sus fuentes, documentos y páginas, sus datos de búsqueda y los originales almacenados, y libera la capacidad de inmediato.
# An organization space is readable by every member (permission brain.manage to create it).
curl "https://api.latam.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Support", "kind": "organization"}'
# A team space is readable by that team's members; a team admin may create it too.
curl "https://api.latam.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Platform runbooks", "kind": "team", "team": "platform"}'
# The spaces you can reach.
curl "https://api.latam.ccsio.ai/brain/v1/spaces" \
-H "Authorization: Bearer $CCSIO_API_KEY"Fuentes
| Fuente | Qué aporta | Actualización |
|---|---|---|
| Un archivo | Un documento: texto, Markdown, CSV, JSON o PDF, hasta 50 MiB. No se aceptan imágenes. | No cambia. |
| Un enlace | Una página web pública, hasta 20 MiB. | Se vuelve a descargar cada sync_interval_minutes (de 5 a 1440), o con la ruta de sincronización. |
| Un repositorio | Una carpeta de un repositorio en gitlab.com o github.com. Lee archivos .md, .markdown, .txt, .csv, .json y .pdf, de hasta 5 MiB cada uno y 5.000 archivos. | Se consulta periódicamente en busca de cambios, y con la ruta de sincronización. |
Un repositorio tiene dos modos. En el modo documents, sus archivos se indexan como documentos sin procesar. En el modo pages se convierten en páginas del Brain y el repositorio sigue siendo su fuente de verdad: las páginas cambian por merge request y la API solo las lee. El token de acceso de un repositorio privado se almacena cifrado y es de solo escritura: la API nunca lo devuelve, solo indica si hay uno. GitLab autoalojado y GitHub Enterprise no se admiten.
# A file: text, Markdown, CSV, JSON or PDF, up to 50 MiB. The space is a query parameter.
curl "https://api.latam.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-F file=@./refund-policy.pdf
# A public web page, fetched again every 6 hours.
curl "https://api.latam.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind": "url", "url": "https://example.com/help/refunds", "sync_interval_minutes": 360}'
# A folder of a GitLab or GitHub repository, indexed as documents. The token is optional for a public repository and is never returned.
curl "https://api.latam.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "git",
"provider": "github",
"repository": "https://github.com/acme/handbook",
"branch": "main",
"path": "docs",
"mode": "documents",
"access_token": "<a token that can read the repository>"
}'
# The same kind of source in pages mode: the files become read-only Brain pages and the repository stays their source of truth.
curl "https://api.latam.ccsio.ai/brain/v1/sources?space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind": "git", "provider": "gitlab", "repository": "https://gitlab.com/acme/knowledge", "mode": "pages"}'
# A source starts pending. Read it until its state is ready (or failed, with its error).
curl "https://api.latam.ccsio.ai/brain/v1/sources/src-01k9xb3d5f7h9k1n3q5s7u9w1y" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Sync a link or a repository now instead of at the next poll.
curl -X POST "https://api.latam.ccsio.ai/brain/v1/sources/src-01k9xb3d5f7h9k1n3q5s7u9w1y/sync" \
-H "Authorization: Bearer $CCSIO_API_KEY"Una fuente nueva está pending, luego syncing, y termina ready o failed con un error. Subir dos veces los mismos bytes a un space es 409 source-duplicate. El texto de un documento tiene como máximo 2.000.000 de caracteres; nada se trunca, y un documento que lo supere falla con source-too-much-text.
Búsqueda con citas
La búsqueda lee las páginas y los documentos de tus spaces por significado y por palabras a la vez (mode hybrid, o solo lexical o vector). Los resultados llegan de mejor a peor, en este orden: páginas verificadas, páginas sin verificar, páginas desactualizadas y, al final, documentos. Cada uno lleva una freshness, un snippet que es material de referencia y nunca una instrucción, y una citation_id que lo nombra en tu respuesta y que brain_read y la ruta de texto vuelven a aceptar. Una cita sigue siendo válida hasta que cambia el contenido al que apunta.
curl "https://api.latam.ccsio.ai/brain/v1/search" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Can I get a refund after 30 days?", "limit": 5}'{
"results": [
{
"citation_id": "pg-01k9xc4e6g8j0m2p4r6t8v0w2y.2",
"kind": "page",
"id": "pg-01k9xc4e6g8j0m2p4r6t8v0w2y",
"title": "Refund policy",
"snippet": "Refunds are possible within 30 days of the purchase. After 30 days, only a defect gives the right to a refund.",
"source": "src-01k9xb3d5f7h9k1n3q5s7u9w1y",
"space": "sp-01k9xa2c4e6g8j0m2p4r6t8v0w",
"freshness": "verified",
"score": 0.0328,
"location": { "heading_path": ["Refunds", "After 30 days"] }
}
],
"no_evidence": false
}Contexto, texto de documentos y exploración
POST /brain/v1/contextdevuelve el contexto estándar de un proyecto, como unAGENTS.mdde toda la organización: las páginas fijadas que aplican y el nombre y la descripción de las skills que aplican, dentro debudget_tokens. Una página que no cabe se deja fuera entera, ytruncatedlo indica.GET /brain/v1/documents/{document}/textdevuelve el texto de un documento, hasta 20000 caracteres cada vez, con los metadatos que necesita una cita y un esquema ensections.next_offsetindica dónde continuar.GET /brain/v1/browserecorre el Brain como un árbol: primero los spaces y luego las carpetas, páginas y documentos de un space. Úsalo para saber qué existe, y la búsqueda para encontrar una respuesta.GET /brain/v1/documents/{document}/downloadredirige a una dirección de corta duración del original almacenado.
# The standing context of a project: its pinned pages and the skills that apply, within a budget of tokens.
curl "https://api.latam.ccsio.ai/brain/v1/context" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project": "billing", "budget_tokens": 4000}'
# The text of a document or a page, up to 20000 characters at a time. next_offset says where to continue.
curl "https://api.latam.ccsio.ai/brain/v1/documents/doc-01k9xd5f7h9k1n3q5s7u9w1y3a/text?offset=0" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Start at one section of the outline that an earlier answer returned.
curl -G "https://api.latam.ccsio.ai/brain/v1/documents/doc-01k9xd5f7h9k1n3q5s7u9w1y3a/text" \
--data-urlencode "section=Refunds > After 30 days" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# Walk the Brain as a tree: the spaces, then a space's folders, pages and documents.
curl "https://api.latam.ccsio.ai/brain/v1/browse" \
-H "Authorization: Bearer $CCSIO_API_KEY"
curl -G "https://api.latam.ccsio.ai/brain/v1/browse" \
--data-urlencode "space=sp-01k9xa2c4e6g8j0m2p4r6t8v0w" \
--data-urlencode "path=policies" \
-H "Authorization: Bearer $CCSIO_API_KEY"Herramientas MCP
Los agentes llegan a ambos por el endpoint de la guía de MCP, con la misma API key y sin instalar nada: el elemento de plataforma ccsio aparece en toda organización que tiene Memory o el Brain, no cuenta para las conexiones MCP del plan y no se puede editar ni limitar a equipos. Un cliente ve cada herramienta como el alias, un guion y el nombre de la herramienta:
| Herramienta | Qué hace |
|---|---|
ccsio-context_build | Empieza aquí: las páginas fijadas y las skills del Brain, el perfil de memoria y los recuerdos relevantes de un proyecto, en un solo paquete dentro de un presupuesto. |
ccsio-brain_context | El contexto estándar de un proyecto. |
ccsio-brain_search | Fragmentos citados, o no_evidence. |
ccsio-brain_read | El texto de una página, un documento o una cita. |
ccsio-brain_browse | El Brain como árbol. |
ccsio-memory_save | Guardar un recuerdo. |
ccsio-memory_recall | Recuperar por consulta. |
ccsio-memory_get | Leer un recuerdo completo. |
ccsio-memory_forget | Borrar un recuerdo propio, o sustituirlo por uno nuevo. |
# After "initialize" (see the MCP guide), call a tool of the item ccsio by its name as a client sees it.
curl "https://api.latam.ccsio.ai/mcp/" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Mcp-Session-Id: <the id from initialize>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call",
"params": {"name": "ccsio-brain_search",
"arguments": {"query": "Can I get a refund after 30 days?"}}}'
curl "https://api.latam.ccsio.ai/mcp/" \
-H "Authorization: Bearer $CCSIO_API_KEY" \
-H "Mcp-Session-Id: <the id from initialize>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc": "2.0", "id": 4, "method": "tools/call",
"params": {"name": "ccsio-memory_save",
"arguments": {"content": "In this repository we chose pgvector.", "type": "decision", "project": "billing"}}}'Las herramientas reciben los mismos argumentos que las rutas y exigen los mismos permisos: memory.use para Memory, brain.read para el Brain. La lista de herramientas es la misma para todos; lo que un llamador puede hacer se decide al llamar la herramienta, y un rechazo es un error de herramienta que lleva el código de la ruta, como memory-scope-forbidden o brain-disabled. Un recuerdo guardado por una herramienta lo escribe un agente, así que sigue las reglas de la memoria de agente descritas arriba.
Límites del plan
| Plan | Brain | Memory |
|---|---|---|
| Personal | 2 GB | 1 GB |
| Starter | 10 GB | 5 GB |
| Business | 20 GB | 10 GB |
| Advanced | 50 GB | 25 GB |
| Enterprise y Datacenter | Por contrato | Por contrato |
- Cuenta lo que tú aportas. En el Brain, los bytes de los originales almacenados más el texto de las páginas; en Memory, el texto de los recuerdos no borrados. Los vectores, los índices, el texto extraído, las revisiones y el diario de borrados no cuentan.
- Los embeddings están incluidos. La ingesta, la búsqueda y el recall generan los embeddings por ti, fuera de tus límites de solicitudes y de tus créditos.
- Al llegar al 100 %, la ingesta se rechaza con
409 brain-capacity-exceededy los recuerdos nuevos con409 memory-capacity-exceeded. Leer, buscar, recuperar y borrar siguen funcionando, y no se borra nada para hacer sitio. - Una capacidad adicional de Brain se suma al Brain de tu plan. Memory no tiene complemento.
# What Memory holds against your plan (permission memory.read), and the same for the Brain (brain.read).
curl "https://api.latam.ccsio.ai/memory/v1/usage" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"used_bytes": 183204, "limit_bytes": 1073741824, "percent": 0.02, "memory_count": 412}
curl "https://api.latam.ccsio.ai/brain/v1/usage" \
-H "Authorization: Bearer $CCSIO_API_KEY"
# → {"used_bytes": 52428800, "limit_bytes": 2147483648, "percent": 2.44, "documents": 37,
# "sources": {"pending": 0, "syncing": 0, "ready": 5, "failed": 1}}Errores que conviene conocer
Usan el sobre de error de la plataforma; basa tu lógica en code, como en Errores.
| Estado y código | Significado | Qué hacer |
|---|---|---|
404 memory-not-enabled, 404 brain-not-enabled | Esta región no ofrece la capacidad. | Usa una región que la ofrezca, o consúltanos en ccsio.ai/contact. |
403 brain-disabled | Tu organización no tiene capacidad de Brain. | Elige un plan que incluya el Brain. |
403 memory-disabled | Memory está desactivada para tu organización. | Un administrador la activa en la política de memoria. |
403 memory-scope-forbidden | No puedes actuar en ese ámbito de dueño, o el recuerdo no es tuyo. | Escribe en tu propio ámbito o en un equipo al que perteneces. |
409 memory-paused | La persona pausó su memoria. | Omite la llamada; leer y borrar siguen funcionando. |
409 memory-revision-conflict | El recuerdo cambió desde que lo leíste. | Léelo de nuevo y repite la edición. |
409 memory-capacity-exceeded, 409 brain-capacity-exceeded | La capacidad del plan está agotada. | Borra recuerdos o elimina fuentes, o añade capacidad. No se borra nada por ti. |
409 source-duplicate | Esos mismos bytes ya están en ese space. | Usa el documento que ya existe. |
413 source-too-large, 415 source-type-not-supported | El archivo supera los 50 MiB, o no es texto, Markdown, CSV, JSON ni PDF. | Divide el archivo o conviértelo. |
422 source-repository-auth | El proveedor rechazó el token de acceso, o el repositorio es privado y no se dio ninguno. | Envía un token que pueda leer el repositorio. |
{
"error": {
"code": "memory-revision-conflict",
"category": "client",
"message": "the memory changed since the revision you read",
"request_id": "01K7YQ4D8M2P6S9V3X5Z7B1C4F"
}
}Referencia
Cada operación, con sus campos, permisos y códigos de error, está en la referencia de la API: Memories, Memory recall, Memory proposals, Brain spaces, Brain sources, Brain documents, Brain pages y Brain search.