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.
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.
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.
- 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.
- 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.
- 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.
Agentes
Uno por defecto y los agentes con nombre que quieras, cada uno con su alcance y política.
Citas
Una fuente en cada respuesta: anotaciones por posición, lista estructurada de fuentes, modo nativo.
Búsqueda
Recuperación sin generación: los pasajes que una respuesta citaría, ordenados.
Privacidad
Tuyo, aislado: sin entrenar con tus datos, exporta o borra cuando quieras, claves con permisos explícitos.
Buckets en la documentación
La referencia desde la que está escrita esta página, con cada endpoint y campo.
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.