Calypso Calypso

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.

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.

IdentificadorSlug, único en tu cuenta y legible; id, estable para máquinas
ProvisionarPUT /v1/buckets/{slug} · 201 created, 200 existing
ListarGET /v1/buckets
MiembrosGET /v1/buckets/{bucket}/sources
Desvincular de un bucketDELETE /v1/buckets/{bucket}/sources/{id}
Borrar una fuente en todas partesDELETE /v1/sources/{id} · POST /v1/knowledge/files:delete (≤ 100 ids)
Regla de alcancebucket_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
ConcurrenciaDos 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

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.