ADK · PRONTO

Agent Development Kit

Estamos preparando el ADK de Bentho: el kit para construir agentes que usan tus espacios como fuente, en Python y JavaScript, sin escribir a mano las cabeceras, los reintentos ni el manejo de eventos. Todavía no está publicado.

No hace falta esperar. La API es HTTP y JSON: cualquier lenguaje que haga una petición sirve hoy. Los ejemplos de cada ruta ya vienen en curl, Python y JavaScript.

Python

Mientras llega el paquete, basta requests (o httpx si trabajas con asyncio):

PYTHON

import os, requests

BENTHO = "https://bentho.org/api"
CABECERAS = {"Authorization": f"Bearer {os.environ['BENTHO_KEY']}"}

def preguntar(espacio: str, pregunta: str, sesion: str | None = None) -> dict:
    r = requests.post(
        f"{BENTHO}/rag/{espacio}/conversations",
        headers=CABECERAS,
        json={"question": pregunta, "session_id": sesion},
        timeout=60,
    )
    r.raise_for_status()
    return r.json()

JavaScript

Con fetch, en Node 18+ o en el navegador de tu backend. No pongas la clave en código que llegue al navegador de tus usuarios.

JAVASCRIPT

const BENTHO = "https://bentho.org/api";

export async function preguntar(espacio, pregunta, sesion) {
  const r = await fetch(`${BENTHO}/rag/${espacio}/conversations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BENTHO_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ question: pregunta, session_id: sesion }),
    signal: AbortSignal.timeout(60_000),
  });
  if (!r.ok) throw new Error(`Bentho respondió ${r.status}`);
  return r.json();
}

Mientras tanto, HTTP

Empieza por el quickstart y ten a mano errores, límites y créditos: son las dos páginas que un cliente propio necesita para ser robusto. Si tu agente ya lee skills, dale la skill bentho-api: le explica la API entera.