--- title: "Build a RAG agent with its own scope and policy | Calypso Context" canonical_url: "https://www.calypso.so/es/context/agents" last_updated: "2026-09-18T05:10:44.065Z" meta: description: "One default agent, any number of named agents. Each binds to its buckets, carries a role, an answer depth, and a presentation mode, and answers as the same model id through the API, MCP, n8n, the widget, and WhatsApp." keywords: "build a RAG agent, hosted RAG agents, custom AI agent on your documents, AI agents with citations, OpenAI compatible RAG agent" "og:description": "One default agent, any number of named agents. Each binds to its buckets, carries a role, an answer depth, and a presentation mode, and answers as the same model id through the API, MCP, n8n, the widget, and WhatsApp." "og:title": "Build a RAG agent with its own scope and policy | Calypso Context" "twitter:description": "One default agent, any number of named agents. Each binds to its buckets, carries a role, an answer depth, and a presentation mode, and answers as the same model id through the API, MCP, n8n, the widget, and WhatsApp." "twitter:title": "Build a RAG agent with its own scope and policy | Calypso Context" --- Consigue tu API key **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. [**Leer la documentación de agentes**](https://docs.calypso.so/context/manage/agents) [**Prueba gratis 14 días**](https://context.calypso.so/join) ## **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. ## **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. 1. 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. 2. 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. 3. 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.](https://www.calypso.so/context/sources) [

**Buckets **

Memoria de fuentes acotada y duradera. Provisiona por slug, vincula a agentes.](https://www.calypso.so/context/buckets) [

**Citas **

Una fuente en cada respuesta: anotaciones por posición, lista estructurada de fuentes, modo nativo.](https://www.calypso.so/context/citations) [

**Búsqueda **

Recuperación sin generación: los pasajes que una respuesta citaría, ordenados.](https://www.calypso.so/context/search) [

**Privacidad **

Tuyo, aislado: sin entrenar con tus datos, exporta o borra cuando quieras, claves con permisos explícitos.](https://www.calypso.so/context/privacy) [

**Agentes en la documentación **

La referencia desde la que está escrita esta página, con cada endpoint y campo.](https://docs.calypso.so/context/manage/agents) **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. [**Prueba gratis 14 días**](https://context.calypso.so/join) [**Leer la documentación para desarrolladores**](https://docs.calypso.so/context/manage/agents)