Saltar al contenido principal
DocumentaciónDevelopers

Memoria y el Brain

Dale a tus aplicaciones y agentes lo que sabe tu organización y lo que recuerda la plataforma, con la misma API key que usas para la inferencia.

Menú de la documentación

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

BrainMemory
Responde a¿Qué sabe la organización?¿Qué debe recordar el asistente sobre esta persona, este agente o este trabajo?
AutoridadOficial: una fuente de verdad que se cita.Un recuerdo: útil, posiblemente erróneo o desactualizado, nunca oficial.
Lo escribeFuentes que se sincronizan y personas que son dueñas de páginas.La persona o el agente, mientras trabajan.
Quién lo veLos 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ónMientras exista su fuente.Retención y vencimiento; se reemplaza cuando otro más nuevo lo sustituye; se borra a petición.
ConsultaBú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.

PermisoPermite
brain.readBuscar, leer y explorar los spaces de tu audiencia. Todos los miembros lo tienen.
brain.manageCrear y eliminar spaces y fuentes. Un administrador de equipo también gestiona los spaces de su equipo.
memory.useGuardar, recuperar, editar y borrar la memoria que te pertenece, y tus propios ajustes. Todos los miembros lo tienen.
memory.reviewDecidir sobre las propuestas de los equipos que revisas.
memory.manageDecidir 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.readLeer 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
  }'
JSON
{
  "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}'
JSON
{
  "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.

curl
# 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.

curl
# 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.

curl
# 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

FuenteQué aportaActualización
Un archivoUn documento: texto, Markdown, CSV, JSON o PDF, hasta 50 MiB. No se aceptan imágenes.No cambia.
Un enlaceUna 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 repositorioUna 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.

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/context devuelve el contexto estándar de un proyecto, como un AGENTS.md de toda la organización: las páginas fijadas que aplican y el nombre y la descripción de las skills que aplican, dentro de budget_tokens. Una página que no cabe se deja fuera entera, y truncated lo indica.
  • GET /brain/v1/documents/{document}/text devuelve el texto de un documento, hasta 20000 caracteres cada vez, con los metadatos que necesita una cita y un esquema en sections. next_offset indica dónde continuar.
  • GET /brain/v1/browse recorre 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}/download redirige a una dirección de corta duración del original almacenado.
curl
# 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:

HerramientaQué hace
ccsio-context_buildEmpieza 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_contextEl contexto estándar de un proyecto.
ccsio-brain_searchFragmentos citados, o no_evidence.
ccsio-brain_readEl texto de una página, un documento o una cita.
ccsio-brain_browseEl Brain como árbol.
ccsio-memory_saveGuardar un recuerdo.
ccsio-memory_recallRecuperar por consulta.
ccsio-memory_getLeer un recuerdo completo.
ccsio-memory_forgetBorrar un recuerdo propio, o sustituirlo por uno nuevo.
curl
# 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

PlanBrainMemory
Personal2 GB1 GB
Starter10 GB5 GB
Business20 GB10 GB
Advanced50 GB25 GB
Enterprise y DatacenterPor contratoPor 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-exceeded y los recuerdos nuevos con 409 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.
curl
# 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ódigoSignificadoQué hacer
404 memory-not-enabled, 404 brain-not-enabledEsta región no ofrece la capacidad.Usa una región que la ofrezca, o consúltanos en ccsio.ai/contact.
403 brain-disabledTu organización no tiene capacidad de Brain.Elige un plan que incluya el Brain.
403 memory-disabledMemory está desactivada para tu organización.Un administrador la activa en la política de memoria.
403 memory-scope-forbiddenNo 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-pausedLa persona pausó su memoria.Omite la llamada; leer y borrar siguen funcionando.
409 memory-revision-conflictEl recuerdo cambió desde que lo leíste.Léelo de nuevo y repite la edición.
409 memory-capacity-exceeded, 409 brain-capacity-exceededLa capacidad del plan está agotada.Borra recuerdos o elimina fuentes, o añade capacidad. No se borra nada por ti.
409 source-duplicateEsos mismos bytes ya están en ese space.Usa el documento que ya existe.
413 source-too-large, 415 source-type-not-supportedEl archivo supera los 50 MiB, o no es texto, Markdown, CSV, JSON ni PDF.Divide el archivo o conviértelo.
422 source-repository-authEl 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.

Explora la plataforma

Obtén tu primera key API

El registro está abierto. Cuatro pasos hasta tu primera llamada: crea tu cuenta, crea tu organización, crea tu API key y empieza a usarla.

  1. 01Crea tu cuenta
  2. 02Crea tu organización
  3. 03Crea tu API key
  4. 04Empieza a usarla