Tu propio modelo razona
Un agente que reúne evidencia de tu conocimiento y sintetiza con su propio modelo y prompt.
Elephant · Búsqueda
A veces quieres la evidencia, no una respuesta. La búsqueda devuelve los pasajes que coinciden, ordenados, con archivo y página, desde los mismos buckets que leería una respuesta. Pídela en ChatGPT o Claude, o llama a POST /v1/search desde tu propio código.
Un agente que reúne evidencia de tu conocimiento y sintetiza con su propio modelo y prompt.
Búsqueda semántica sobre tus buckets: una barra lateral de pasajes, un panel de documentos relacionados, un selector de citas.
Mira qué encontraría la recuperación antes de pedir una respuesta. Ajusta buckets y consultas contra resultados reales.
El ejemplo
Por defecto busca en el alcance del agente por defecto. Pasa buckets para buscar en almacenes concretos, o agent para usar el alcance de un agente con nombre. Nunca ambos.
curl -X POST "https://api.calypso.so/v1/search" \
-H "Authorization: Bearer $CALYPSO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "What is the refund policy for international orders?"
}'
# Searches the default agent's scope: the same buckets elephant-agent answers from.Parámetros
Formula las consultas como preguntas naturales y no como palabras sueltas; la búsqueda semántica subyacente recupera notablemente mejor con preguntas.
| Parámetro | Por defecto | Qué hace |
|---|---|---|
| query | obligatorio | La consulta, de 1 a 4000 caracteres. |
| agent | elephant-agent | Busca en el alcance de un agente concreto: el de por defecto o uno con nombre. Excluyente con buckets. |
| buckets | — | Busca directamente en buckets concretos, por id o slug, hasta 5. Excluyente con agent. |
| max_results | 10 | De 1 a 20. La recuperación siempre busca en un conjunto de candidatos mayor, al menos 10 y hasta el doble del valor, antes de truncar. |
| depth | fast | fast ejecuta una única llamada acotada. standard ejecuta de 2 a 3 en paralelo y las fusiona por mejor posición sin duplicados, lo que eleva la cobertura en consultas cortas con la misma latencia. |
| additional_queries | — | Hasta 2 reformulaciones extra buscadas en paralelo con depth standard. Las aportas tú; no se gasta ninguna llamada a modelo en generarlas. |
El campo strategy
Cada respuesta dice cómo buscó. Un valor significa cobertura parcial y conviene manejarlo.
Cómo funciona
Agente por defecto, un agente con nombre o hasta cinco buckets por slug. Las mismas reglas que una respuesta con fuentes.
Envía una consulta en lenguaje natural; añade dos reformulaciones y depth standard cuando la cobertura importe más que los tokens.
Pasa results[].text a tu propio modelo o interfaz. Cada resultado lleva el mismo source_index y label que llevaría una cita.
De la documentación
| Endpoint | POST https://api.calypso.so/v1/search |
|---|---|
| Alcance | agent (por defecto o con nombre) o buckets (ids o slugs, hasta 5), nunca ambos |
| Resultados | De 1 a 20, ordenados; source_index es estable y empieza en 1 |
| Profundidad | fast: una llamada; standard: de 2 a 3 búsquedas paralelas fusionadas por mejor posición |
| Contrato de fuentes | Los mismos atributos que file_search_call.results[] de una respuesta: label, page_number, locator_label, source_type, knowledge_id |
| Cobro | Una búsqueda servida se mide como una respuesta servida; una cuenta sin cuota recibe 429 |
| Herramienta MCP | calypso-search |
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.
Asistentes con nombre, con sus propios buckets e instrucciones.
Una fuente en cada respuesta: archivo, página y pasaje, con un enlace para abrirlo.
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
La misma recuperación, los mismos buckets, las mismas fuentes, sin la respuesta escrita.