Primeros pasos¶
De cero a una respuesta citada. Necesitas una clave de API, que el administrador de tu organización emite en Renbase Studio, en la sección API Keys.
1. Sube un documento¶
Envía el fichero con la colección a la que pertenece. Las colecciones organizan tu corpus —soporte, politicas, manual— y una colección se crea con solo nombrarla.
curl -X POST $RENBASE_API/v1/documents \
-H "Authorization: Bearer $RENBASE_KEY" \
-F file=@manual.pdf \
-F collection=soporte
La respuesta es inmediata y devuelve un trabajo:
El procesamiento ocurre en segundo plano, así que un manual grande no te deja la conexión abierta. Consulta el trabajo o sigue el flujo en vivo:
Cuando status llega a done, el documento ya es consultable. Se admiten PDF, DOCX, PPTX, XLSX, HTML, Markdown y texto plano.
2. Pregunta¶
curl -N -X POST $RENBASE_API/v1/ask \
-H "Authorization: Bearer $RENBASE_KEY" \
-H 'content-type: application/json' \
-d '{"query": "¿cuál es el plazo de devolución?", "collection": "soporte"}'
La respuesta llega en streaming por Server-Sent Events: primero las fuentes que va a usar, después el texto token a token y al final un evento con las citas resueltas.
event: sources
data: {"sources": [{"n": 1, "title": "manual.pdf", "excerpt": "…"}]}
event: token
data: {"text": "Las devoluciones se aceptan dentro de los 30 días"}
event: done
data: {"citations": [{"n": 1, "document_id": "…", "chunk_id": "…"}], "abstained": false}
Cada [1] del texto apunta a una entrada de citations. Si el corpus no puede sostener una respuesta, abstained vuelve como true y el texto explica por qué: eso es un resultado correcto, no un error.
3. Define un término que es tuyo¶
Los documentos cubren lo que está escrito. Las definiciones cubren lo que tu organización ha decidido. Añadir una es una sola llamada de un administrador:
curl -X POST $RENBASE_API/v1/context \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"kind": "metric",
"name": "cliente activo",
"aliases": ["cuenta activa"],
"body": "Cuenta con al menos una licencia de pago y un acceso en los últimos 90 días.",
"approve": true}'
A partir de ahí, cualquier pregunta que mencione «cliente activo» resuelve a esta definición —de forma exacta, no por parecido— y las respuestas la citan con su versión y su aprobador. Ver Definiciones de negocio.
4. Conecta un agente¶
Tus asistentes consultan el mismo corpus por MCP:
claude mcp add --transport http renbase https://api.renbase.ai/mcp \
--header "Authorization: Bearer $RENBASE_KEY"
Las herramientas disponibles están en Agentes de IA (MCP).
Sin escribir código¶
Todo lo anterior está también en Renbase Studio, el panel web: subir documentos arrastrándolos, preguntar con citas en vivo, revisar y aprobar definiciones, invitar miembros y emitir claves. Lo habitual es gobernar desde el panel e integrar por API.