Calypso Calypso

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.

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.

CampoCambiaEfecto
bucket_idsRecuperaciónQué fuentes se pueden buscar. Tiene prioridad sobre cualquier otro campo de fuentes.
top_kRecuperaciónCuántos pasajes devuelve la recuperación final, de 1 a 20, 10 por defecto. Más evidencia cuesta más tokens.
response_policyRecuperación y modeloFast, medium o extended: cuánto trabajo ocurre antes de responder y qué modelo escribe la respuesta.
rolePresentaciónTono y postura de la respuesta. No es un mecanismo de selección de fuentes.
visibilidad de fuentesPresentaciónSi se devuelven los títulos de las fuentes. La recuperación ocurre igualmente.
modo de presentaciónPresentaciónTexto 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.

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 defectoelephant-agent
Agente con nombreelephant-agent:{agent_id}
DescubrirGET /v1/agents · GET /v1/models
GestionarPOST /v1/agents · PUT /v1/agents/{agent_id} · DELETE /v1/agents/{agent_id}
top_kDe 1 a 20 pasajes por respuesta, 10 por defecto
Modos de respuestafast, medium, extended
Modos de presentacióntexto plano, markdown, markdown con tablas, apto para WhatsApp, auto

Preguntas y respuestas

Antes de crear uno.

Sigue leyendo

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.