---
title: "Crea un asistente de IA sobre tus propios archivos | Calypso"
canonical_url: "https://www.calypso.so/es/elephant/agents"
last_updated: 2026-11-21
meta:
  description: "Crea asistentes con nombre que leen solo los buckets que eliges, con sus instrucciones y su estilo de respuesta, y llámalos desde ChatGPT, Claude o la API."
  keywords: "custom AI assistant on your documents, AI study assistant for notes, AI research assistant for papers, build a RAG agent, OpenAI compatible RAG agent"
  "og:description": "Crea asistentes con nombre que leen solo los buckets que eliges, con sus instrucciones y su estilo de respuesta, y llámalos desde ChatGPT, Claude o la API."
  "og:title": "Crea un asistente de IA sobre tus propios archivos | Calypso"
  "twitter:description": "Crea asistentes con nombre que leen solo los buckets que eliges, con sus instrucciones y su estilo de respuesta, y llámalos desde ChatGPT, Claude o la API."
  "twitter:title": "Crea un asistente de IA sobre tus propios archivos | Calypso"
---

Conecta tu IA

**Elephant · Agentes**

# Un asistente por tarea. Una memoria.

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.

[**Leer la documentación de agentes**](https://docs.calypso.so/context/manage/agents) [**Prueba gratis 14 días**](https://elephant.calypso.so/join?targetAppKey=elephant)

## **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": "elephant-agent:support", "replayed": false, … }
```

**Agentes con nombre**

## Tres tareas, tres asistentes, una memoria.

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**

## 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 a tus buckets reales con una clave de API de proyecto real, y revisa el estado de grounding antes de confiar en ello.
3. 03 ### **Publica el id de modelo**

   Usa elephant-agent:{agent_id} en ChatGPT, Claude, la API, n8n o el widget. Un id, unas instrucciones, 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.

<dl>

<dt>**Disponible**</dt>
<dd>Se devolvieron fuentes con grounding y se pueden inspeccionar directamente.</dd>

<dt>**Oculto**</dt>
<dd>Probablemente hubo grounding, pero la política oculta los títulos de las fuentes a propósito.</dd>

<dt>**Ausente**</dt>
<dd>Se esperaba grounding pero no apareció con claridad. Revisa la clave, el agente con nombre y la disponibilidad del bucket.</dd>

<dt>**Ninguno**</dt>
<dd>No se devolvieron fuentes con grounding. La respuesta no está respaldada por evidencia.</dd></dl>

**De la documentación**

## Ids de modelo, endpoints y límites.

| **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**

## Antes de crear uno.

**Sigue leyendo**

[<h3>**Fuentes **</h3>PDF, capturas, páginas y notas. Qué lee y cómo lo guardas.](https://www.calypso.so/elephant/sources) [<h3>**Buckets **</h3>Carpetas que tu IA recuerda. Pregunta a una, o a todas.](https://www.calypso.so/elephant/buckets) [<h3>**Citas **</h3>Una fuente en cada respuesta: archivo, página y pasaje, con un enlace para abrirlo.](https://www.calypso.so/elephant/citations) [<h3>**Búsqueda **</h3>El pasaje exacto, ordenado, sin respuesta escrita.](https://www.calypso.so/elephant/search) [<h3>**Privacidad **</h3>Privado por defecto: no entrena con tus archivos, nunca borra, tú eliges qué puede hacer cada IA.](https://www.calypso.so/elephant/privacy) [<h3>**Agentes en la documentación **</h3>La referencia desde la que está escrita esta página, con cada endpoint y campo.](https://docs.calypso.so/context/manage/agents)

**Empieza hoy**

## **Dale a cada tarea su propio asistente.**

Elige sus buckets, escribe sus instrucciones una vez y llámalo por su nombre desde ChatGPT, Claude o tu propia app.

[**Prueba gratis 14 días**](https://elephant.calypso.so/join?targetAppKey=elephant) [**Lee la documentación**](https://docs.calypso.so/context/manage/agents)