---
title: "Buckets: carpetas de archivos que tu IA consulta | Elephant"
canonical_url: "https://www.calypso.so/es/elephant/buckets"
last_updated: 2026-11-21
meta:
  description: "Un bucket es una carpeta de fuentes que tu IA recuerda: una tesis, un alquiler, unos manuales. Guarda desde ChatGPT o Claude y pregunta a uno o a todos."
  keywords: "organise PDFs for ChatGPT, personal knowledge base AI, AI second brain folders, knowledge base for AI agents, RAG knowledge buckets"
  "og:description": "Un bucket es una carpeta de fuentes que tu IA recuerda: una tesis, un alquiler, unos manuales. Guarda desde ChatGPT o Claude y pregunta a uno o a todos."
  "og:title": "Buckets: carpetas de archivos que tu IA consulta | Elephant"
  "twitter:description": "Un bucket es una carpeta de fuentes que tu IA recuerda: una tesis, un alquiler, unos manuales. Guarda desde ChatGPT o Claude y pregunta a uno o a todos."
  "twitter:title": "Buckets: carpetas de archivos que tu IA consulta | Elephant"
---

Conecta tu IA

**Elephant · Buckets**

# Carpetas que tu IA recuerda.

Un bucket es una carpeta de fuentes con nombre: los papers de tu tesis, tu alquiler y tu seguro, los manuales de tu casa. Guarda en uno desde el chat, renómbralo, mueve archivos entre buckets. Pregunta a todos a la vez, o solo a los que nombres. 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://elephant.calypso.so/join?targetAppKey=elephant)

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

## **Pregunta a un bucket, o a todos**

Pregunta a todo a la vez, o dirige una pregunta a los buckets que deben responderla. Tu investigación nunca cita tus recibos salvo que se lo pidas.

**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.

Cuatro partes de una vida, cuatro buckets. Cada pregunta lee el conjunto en el que debe confiar.

bucket://investigacion

### **Investigación**

Papers, preprints, diapositivas de clase y tus notas de lectura, listos para una revisión bibliográfica.

bucket://casa-y-contratos

### **Casa y contratos**

Alquiler, póliza de seguro, garantías y las cartas que guardas, citados cláusula a cláusula.

bucket://manuales

### **Manuales**

Guías del hervidor, el coche y el router, para que cada configuración y arreglo sea una pregunta.

bucket://recibos

### **Recibos**

Facturas y recibos en PDF y fotos, para que totales y fechas estén a una pregunta.

**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 en tu cuenta 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 en tu cuenta 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**

[<h3>**Fuentes **</h3>PDF, capturas, páginas y notas. Qué lee y cómo lo guardas.](https://www.calypso.so/elephant/sources) [<h3>**Agentes **</h3>Asistentes con nombre, con sus propios buckets e instrucciones.](https://www.calypso.so/elephant/agents) [<h3>**Citas **</h3>Una fuente en cada respuesta: archivo, página y pasaje, con un enlace para abrirlo.](https://www.calypso.so/elephant/citations) [<h3>**Búsqueda **</h3>El pasaje exacto, ordenado, sin respuesta escrita.](https://www.calypso.so/elephant/search) [<h3>**Privacidad **</h3>Privado por defecto: no entrena con tus archivos, nunca borra, tú eliges qué puede hacer cada IA.](https://www.calypso.so/elephant/privacy) [<h3>**Buckets en la documentación **</h3>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 tu primer bucket en el chat.**

Pide a ChatGPT o Claude que cree un bucket y guarde un PDF en él, y hazle una pregunta un minuto después.

[**Prueba gratis 14 días**](https://elephant.calypso.so/join?targetAppKey=elephant) [**Lee la documentación**](https://docs.calypso.so/context/manage/buckets)