Saltar al contenido
API v1 · https://bentho.org/api
QUICKSTART · ≈ 5 MIN

Tu primera respuesta en tres pasos

Necesitas un espacio de Bentho con el módulo Bentho API y algún documento cargado. No hay nada que instalar: la API es HTTP y JSON.

1 · Crea tu clave

En la consola, abre el módulo API de tu espacio y crea una clave: ponle un nombre (por ejemplo, erp-produccion), elige a qué espacios llega y si solo lee o también escribe.

La clave completa se ve una sola vez. Bentho solo guarda su huella: si la pierdes, crea otra y revoca la vieja.

Tiene esta forma: bth_, 16 caracteres hexadecimales, un punto y el secreto. Guárdala en una variable de entorno de tu servidor, nunca en el código:

BASH
export BENTHO_KEY="bth_7f3a1c9e04b2d8a1.xQ2…"

¿Cuál es el id de tu espacio? Pregúntale a la API: devuelve los espacios a los que llega la clave.

BASH
curl https://bentho.org/api/companies \
  -H "Authorization: Bearer $BENTHO_KEY"

# {"companies": [{"id": "mi-espacio", "name": "Mi espacio", "modules": ["api", …], …}]}

2 · Pregunta

Una petición a POST /api/rag/{espacio}/conversations con la pregunta y un session_id tuyo. El session_id es obligatorio: agrupa los turnos, así que reúsalo para las preguntas de seguimiento.

curl https://bentho.org/api/rag/mi-espacio/conversations \
  -H "Authorization: Bearer $BENTHO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "¿Cuántos días tengo para devolver un producto?",
    "session_id": "primera-prueba"
  }'

Tarda entre 2 y 20 segundos. Dale a tu cliente un timeout de al menos 60.

3 · Lee la respuesta

200 OK · EJEMPLO
{
  "status_code": "1000",
  "response": "Según la política de devoluciones, tienes 30 días desde la entrega…\n\nReferencia: politica_devoluciones.pdf",
  "sources": ["politica_devoluciones.pdf"],
  "confidence": 0.7556,
  "warning": false,
  …
}
  • status_code "1000": contestó con apoyo en tus documentos.
  • status_code "1001": no había información suficiente y prefirió no inventar. response trae el mensaje de rechazo del espacio y sources llega vacío.
  • warning: true: contestó, pero solo parte de la respuesta está respaldada. Muéstralo como tal.
  • confidence: de 0 a 1. Desde 0,75 responde sin reparos.

Y después