--- title: "Buckets: scoped knowledge for AI agents | Calypso Context" canonical_url: "https://www.calypso.so/es/context/buckets" last_updated: "2026-09-18T05:10:43.402Z" meta: description: "A bucket is a named, durable collection of sources. Ingestion writes into buckets, agents search only the buckets they are bound to, and nothing crosses between them. Provision by slug, list, inspect members, bind to agents." keywords: "knowledge base for AI agents, scoped retrieval, multi-tenant RAG, RAG knowledge buckets, retrieval storage for AI agents" "og:description": "A bucket is a named, durable collection of sources. Ingestion writes into buckets, agents search only the buckets they are bound to, and nothing crosses between them. Provision by slug, list, inspect members, bind to agents." "og:title": "Buckets: scoped knowledge for AI agents | Calypso Context" "twitter:description": "A bucket is a named, durable collection of sources. Ingestion writes into buckets, agents search only the buckets they are bound to, and nothing crosses between them. Provision by slug, list, inspect members, bind to agents." "twitter:title": "Buckets: scoped knowledge for AI agents | Calypso Context" --- Consigue tu API key **Calypso Context · Buckets** # Dale a cada agente la memoria correcta. Un bucket es una colección de fuentes con nombre y duradera. La ingesta escribe en buckets, los agentes buscan solo en los buckets a los que están vinculados y nada cruza entre ellos salvo que lo vincules. El slug es el identificador que usan tus scripts; el id es el identificador estable para máquinas. [**Leer la documentación de buckets**](https://docs.calypso.so/context/manage/buckets) [**Prueba gratis 14 días**](https://context.calypso.so/join) ## **Las subidas llegan con intención** Cada archivo, página, lote y subida por MCP nombra su bucket antes de que empiece el indexado. No hay un montón sin ordenar que limpiar después. ## **La disponibilidad se ve** Cada miembro reporta su propio bit ready y el bucket reporta la disponibilidad del almacén, así que sabes antes de probar si la recuperación puede funcionar. ## **Los agentes buscan en memoria curada** Un agente está vinculado a los buckets que corresponden a su trabajo. Soporte responde desde el manual; Ventas desde el catálogo; ninguno ve al otro. **El ejemplo** ## Provisiona por slug y luego inspecciona. PUT sobre el slug es la forma recomendada de que un script se asegure de que el destino existe antes de subir: explícito, idempotente y separado de la subida. **CALYPSO_API_KEY** ``` curl -X PUT "https://api.calypso.so/v1/buckets/support-handbook" \ -H "Authorization: Bearer $CALYPSO_API_KEY" # 201 when created, 200 with "created": false when it already exists. # { "id": "bucket_abc", "slug": "support-handbook", # "status": "active", "created": true } ``` **Buckets por propósito** ## Separa lo que nunca debería mezclarse. Un equipo, cuatro tipos de conocimiento, cuatro buckets. Cada agente lee el conjunto en el que debe confiar. bucket://support-handbook ### **Soporte** Páginas del centro de ayuda, PDFs de resolución de problemas, capturas y notas de escalado en un conjunto listo para citar. bucket://pricing ### **Precios** Hojas de planes en CSV, documentos de empaquetado, FAQs de compras y reglas de descuento separadas del conocimiento general de producto. bucket://legal ### **Legal** Términos, políticas, PDFs de cumplimiento y documentos de tratamiento de datos para un agente legal gobernado. bucket://onboarding ### **Onboarding** Guías de configuración, diagramas, listas de comprobación e instrucciones por cliente para un asistente de onboarding. **Cómo funciona** ## Nómbralo, enruta hacia él, vincúlalo. 1. 01 ### **Nombra el bucket** Elige un slug que diga para qué es el conjunto. Los slugs son únicos por equipo y aparecen en cada atributo de cita. 2. 02 ### **Enruta fuentes hacia él** El bucket va en la URL de cada llamada de ingesta: archivos, importaciones, páginas, lotes y subidas por MCP. 3. 03 ### **Vincúlalo a un agente** Un agente con nombre lista los buckets en los que busca. bucket_ids tiene prioridad sobre cualquier otro campo de fuentes de su política. **De la documentación** ## Los endpoints y las reglas. | **Identificador** | Slug, único por equipo y legible; id, estable para máquinas | | --- | --- | | **Provisionar** | PUT /v1/buckets/{slug} · 201 created, 200 existing | | **Listar** | GET /v1/buckets | | **Miembros** | GET /v1/buckets/{bucket}/sources | | **Desvincular de un bucket** | DELETE /v1/buckets/{bucket}/sources/{id} | | **Borrar una fuente en todas partes** | DELETE /v1/sources/{id} · POST /v1/knowledge/files:delete (≤ 100 ids) | | **Regla de alcance** | bucket_ids tiene prioridad sobre cualquier otro campo de fuentes: file_mode se fuerza a selected y file_ids, website_ids y qa_ids se vacían | | **Concurrencia** | Dos llamadas asegurando el mismo slug a la vez es un caso de éxito: la que pierde relee y devuelve el bucket ganador con created: false | **Preguntas y respuestas** ## Antes de crear uno. **Sigue leyendo** [

**Fuentes **

PDFs, imágenes, páginas y datos. Qué lee y cómo entra.](https://www.calypso.so/context/sources) [

**Agentes **

Uno por defecto y los agentes con nombre que quieras, cada uno con su alcance y política.](https://www.calypso.so/context/agents) [

**Citas **

Una fuente en cada respuesta: anotaciones por posición, lista estructurada de fuentes, modo nativo.](https://www.calypso.so/context/citations) [

**Búsqueda **

Recuperación sin generación: los pasajes que una respuesta citaría, ordenados.](https://www.calypso.so/context/search) [

**Privacidad **

Tuyo, aislado: sin entrenar con tus datos, exporta o borra cuando quieras, claves con permisos explícitos.](https://www.calypso.so/context/privacy) [

**Buckets en la documentación **

La referencia desde la que está escrita esta página, con cada endpoint y campo.](https://docs.calypso.so/context/manage/buckets) **Empieza hoy** ## **Crea la capa de fuentes en la que tus agentes pueden confiar.** Provisiona un bucket, enruta tus primeras fuentes y vincúlalo a un agente en la misma hora. [**Prueba gratis 14 días**](https://context.calypso.so/join) [**Leer la documentación para desarrolladores**](https://docs.calypso.so/context/manage/buckets)