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.
Elephant · Agentes
elephant-agent lee todos tus buckets. Un agente con nombre tiene sus propios buckets, instrucciones, profundidad y presentación: un tutor de estudio que lee solo tu asignatura, un asistente de investigación que lee solo tus papers. El mismo id responde en ChatGPT, Claude, la API, n8n y el widget web. Créalo en Agent Builder, pruébalo en Playground y úsalo.
Un agente está vinculado a los conjuntos de fuentes exactos que puede usar, así que la recuperación es acotada y repetible.
Alcance, top_k, profundidad de respuesta, rol, visibilidad de fuentes y presentación viven en el agente, no en cada llamada.
Cada respuesta lleva las fuentes que usó, así que los usuarios verifican en lugar de confiar en una caja negra.
El ejemplo
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.
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": "elephant-agent:support", "replayed": false, … }Agentes con nombre
Cada asistente lee sus propios buckets y sigue sus propias instrucciones, y el id del modelo dice cuál respondió.
elephant-agent:study
Buckets
biologia-101, apuntes-examen
Brief
Hazme preguntas y resume solo desde el material de la asignatura, citando la página.
elephant-agent:research
Buckets
papers, notas-de-lectura
Brief
Responde desde los papers que reuní y cita el pasaje detrás de cada afirmación.
elephant-agent:home
Buckets
casa-y-contratos, manuales
Brief
Responde sobre mi alquiler, mi seguro y mis electrodomésticos desde los propios documentos.
Política
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
Elige los buckets, el rol, la profundidad de respuesta y el modo de presentación. O haz POST /v1/agents desde un script.
Haz preguntas reales a tus buckets reales con una clave de API de proyecto real, y revisa el estado de grounding antes de confiar en ello.
Usa elephant-agent:{agent_id} en ChatGPT, Claude, la API, n8n o el widget. Un id, unas instrucciones, un mismo conjunto de citas.
Playground
El trabajo de interpretación importante en Playground es cómo apareció el grounding. Cuatro estados te dicen si puedes confiar en la respuesta.
De la documentación
| Agente por defecto | elephant-agent |
|---|---|
| Agente con nombre | elephant-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 |
Preguntas y respuestas
Sigue leyendo
PDF, capturas, páginas y notas. Qué lee y cómo lo guardas.
Carpetas que tu IA recuerda. Pregunta a una, o a todas.
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
Elige sus buckets, escribe sus instrucciones una vez y llámalo por su nombre desde ChatGPT, Claude o tu propia app.