Busca solo en buckets aprobados
Un agente está vinculado a los conjuntos de fuentes exactos que puede usar, así que la recuperación es acotada y repetible.
Calypso Context · Agentes
Un mismo motor, comportamiento especializado.
calypso-agent es el agente por defecto de tu espacio. Un agente con nombre tiene su propio alcance de buckets, rol, profundidad de respuesta y modo de presentación, y el mismo id de modelo responde por la API, MCP, n8n, el widget web y Calypso WhatsApp. Constrúyelo en Agent Builder, pruébalo en Playground y publícalo.
Política definida una vez
Alcance, top_k, profundidad de respuesta, rol, visibilidad de fuentes y presentación viven en el agente, no en cada llamada.
Citas por defecto
Cada respuesta lleva las fuentes que usó, así que los usuarios verifican en lugar de confiar en una caja negra.
El ejemplo
Créalo una vez. Llámalo como a un modelo.
Provisiona un agente con nombre con una clave de idempotencia y luego dirígete a él por id de modelo desde cualquier SDK de OpenAI. El descubrimiento lista lo que tu clave puede usar.
CALYPSO_API_KEY
curl -X POST "https://api.calypso.so/v1/agents" \
-H "Authorization: Bearer $CALYPSO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: provision-support-agent" \
-d '{
"agent_id": "support",
"name": "Support Agent",
"instructions": "Answer from the support handbook. Be concise.",
"bucket_slugs": ["support-handbook"],
"response_policy": "medium"
}'
# { "object": "rag_agent", "agent_id": "support",
# "model": "calypso-agent:support", "replayed": false, … }Agentes con nombre
Tres trabajos, tres agentes, un motor.
Cada agente lee sus propios buckets y sigue su propio brief. El equipo que los opera nunca los confunde, porque el id de modelo dice cuál respondió.
calypso-agent:support
Buckets
support-handbook
Brief
Responde preguntas de resolución de problemas desde fuentes de soporte aprobadas, con citas.
calypso-agent:pricing
Buckets
pricing, legal
Brief
Explica planes, límites, empaquetado y reglas de compra solo desde fuentes aprobadas.
calypso-agent:onboarding
Buckets
onboarding, support-handbook
Brief
Guía la configuración y la implementación desde conocimiento curado de onboarding.
Política
Qué cambia la recuperación y qué solo cambia la presentación.
El id de modelo visible es solo parte de la historia. Estos campos deciden qué busca el agente y cómo habla. Cambia uno cada vez y valida en Playground.
| Campo | Cambia | Efecto |
|---|---|---|
| bucket_ids | Recuperación | Qué fuentes se pueden buscar. Tiene prioridad sobre cualquier otro campo de fuentes. |
| top_k | Recuperación | Cuántos pasajes devuelve la recuperación final, de 1 a 20, 10 por defecto. Más evidencia cuesta más tokens. |
| response_policy | Recuperación y modelo | Fast, medium o extended: cuánto trabajo ocurre antes de responder y qué modelo escribe la respuesta. |
| role | Presentación | Tono y postura de la respuesta. No es un mecanismo de selección de fuentes. |
| visibilidad de fuentes | Presentación | Si se devuelven los títulos de las fuentes. La recuperación ocurre igualmente. |
| modo de presentación | Presentación | Texto plano, markdown, markdown con tablas, apto para WhatsApp o auto. Elige según la superficie. |
Cómo funciona
Construir, probar, publicar.
- 01
Construye en Agent Builder
Elige los buckets, el rol, la profundidad de respuesta y el modo de presentación. O haz POST /v1/agents desde un script.
- 02
Prueba en Playground
Haz preguntas reales contra buckets reales con una clave de API real, y lee el estado de grounding antes de que nada llegue a un cliente.
- 03
Publica el id de modelo
Usa calypso-agent: en la API, MCP, n8n, el widget o un Smart Board. Un id, una política, un mismo conjunto de citas.
Playground
Lee el estado de grounding, no solo la respuesta.
El trabajo de interpretación importante en Playground es cómo apareció el grounding. Cuatro estados te dicen si puedes confiar en la respuesta.
- Disponible
- Se devolvieron fuentes con grounding y se pueden inspeccionar directamente.
- Oculto
- Probablemente hubo grounding, pero la política oculta los títulos de las fuentes a propósito.
- Ausente
- Se esperaba grounding pero no apareció con claridad. Revisa la clave, el agente con nombre y la disponibilidad del bucket.
- Ninguno
- No se devolvieron fuentes con grounding. La respuesta no está respaldada por evidencia.
De la documentación
Ids de modelo, endpoints y límites.
| Agente por defecto | calypso-agent |
|---|---|
| Agente con nombre | calypso-agent:{agent_id} |
| Descubrir | GET /v1/agents · GET /v1/models |
| Gestionar | POST /v1/agents · PUT /v1/agents/{agent_id} · DELETE /v1/agents/{agent_id} |
| top_k | De 1 a 20 pasajes por respuesta, 10 por defecto |
| Modos de respuesta | fast, medium, extended |
| Modos de presentación | texto plano, markdown, markdown con tablas, apto para WhatsApp, auto |
| Ids heredados | Los ids calypso-rag-agent se siguen aceptando como entrada; la API devuelve la forma canónica calypso-agent |
Preguntas y respuestas
Antes de crear uno.
Sigue leyendo
Fuentes
PDFs, imágenes, páginas y datos. Qué lee y cómo entra.
Buckets
Memoria de fuentes acotada y duradera. Provisiona por slug, vincula a agentes.
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.
Agentes 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 agentes en la que tu producto puede confiar.
Vincula buckets, define la política una vez y lanza respuestas con citas en cada superficie con un solo id de modelo.