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.
Elephant · Buckets
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.
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.
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 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
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.
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
Cuatro partes de una vida, cuatro buckets. Cada pregunta lee el conjunto en el que debe confiar.
bucket://investigacion
Papers, preprints, diapositivas de clase y tus notas de lectura, listos para una revisión bibliográfica.
bucket://casa-y-contratos
Alquiler, póliza de seguro, garantías y las cartas que guardas, citados cláusula a cláusula.
bucket://manuales
Guías del hervidor, el coche y el router, para que cada configuración y arreglo sea una pregunta.
bucket://recibos
Facturas y recibos en PDF y fotos, para que totales y fechas estén a una pregunta.
Cómo funciona
Elige un slug que diga para qué es el conjunto. Los slugs son únicos en tu cuenta y aparecen en cada atributo de cita.
El bucket va en la URL de cada llamada de ingesta: archivos, importaciones, páginas, lotes y subidas por MCP.
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
| 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
Sigue leyendo
PDF, capturas, páginas y notas. Qué lee y cómo lo guardas.
Asistentes con nombre, con sus propios buckets e instrucciones.
Una fuente en cada respuesta: archivo, página y pasaje, con un enlace para abrirlo.
El pasaje exacto, ordenado, sin respuesta escrita.
Privado por defecto: no entrena con tus archivos, nunca borra, tú eliges qué puede hacer cada IA.
La referencia desde la que está escrita esta página, con cada endpoint y campo.
Empieza hoy
Pide a ChatGPT o Claude que cree un bucket y guarde un PDF en él, y hazle una pregunta un minuto después.