DocumentațieDocumentation

Robyn API

Adresa de bază și cheile se primesc la intrarea în pilot. Exemplele de mai jos folosesc variabila ROBYN_URL.The base URL and keys are issued when you join the pilot. The examples below use the ROBYN_URL variable.

Pornire rapidăQuickstart

curl "$ROBYN_URL/v1/systemone" \
  -H "Authorization: Bearer $ROBYN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": {"message": "Since this morning nobody can sign in."},
    "questions": {
      "blocked": {"type": "noul", "instructions": "Is the customer blocked from working?"}
    }
  }'

Răspunsul conține, pentru fiecare întrebare, valoarea tipizată și probabilitățile. GET /v1/models listează modelele disponibile; jev-latest e un alias pentru generalistul Robyn.The response contains, for each question, the typed value and the probabilities. GET /v1/models lists available models; jev-latest is an alias for the Robyn generalist.

Tipuri de întrebăriQuestion types

TipType	RăspunsAnswer	CriteriiCriteria
`noul`	probabilitatea lui „da”, între 0 și 1probability of “yes”, 0 to 1	opțional: ce înseamnă „da”optional: what “yes” means
`choice`	una dintre opțiunile tale, cu probabilitate pe fiecareone of your options, with a probability for each	obiect: cheie → descriereobject: key → description
`score`	valoare între 0 și 1 pe scala ta, cu distribuția pe nivelurivalue 0 to 1 on your scale, with the level distribution	listă ordonată de niveluriordered list of levels

Garanția de eroareError guarantee

Adaugă "robyn": {"max_risk": 0.05} în cerere. Fiecare răspuns primește un câmp robyn:Add "robyn": {"max_risk": 0.05} to the request. Every answer gets a robyn field:

"robyn": {
  "accepted": true,          // poți acționa automat / safe to act on
  "threshold": 0.81,         // pragul calibrat / calibrated threshold
  "max_risk": 0.05, "delta": 0.05,
  "top_probability": 0.9999
}
// fără garanție posibilă / no guarantee possible:
"robyn": { "accepted": false, "threshold": null,
           "reason": "no threshold meets this bound on held-out data" }

delta e probabilitatea ca garanția să nu se respecte (implicit 5%). Fără câmpul robyn în cerere, răspunsul e identic cu formatul Jev.delta is the probability that the guarantee fails (5% by default). Without the robyn field, the response matches the Jev format exactly.

LoturiBatches

POST /v1/batches
{ "requests": [ {"custom_id": "t-001", "body": { …cerere systemone… }}, … ] }
→ { "id": "batch_…", "state": "queued", "total": 2500, "done": 0 }

GET /v1/batches/{id}            // progres / progress
GET /v1/batches/{id}/results    // un rezultat pe cerere / one result per request

Până la 10.000 de cereri pe lot. Dacă serverul repornește, lotul continuă de la prima cerere neterminată. Fiecare rezultat păstrează custom_id.Up to 10,000 requests per batch. If the server restarts, the batch resumes from the first unfinished request. Every result keeps its custom_id.

Trecerea de la Jev sau VAKYNMoving from Jev or VAKYN

Schimbi adresa de bază și cheia în SDK-ul pe care îl folosești deja.Change the base URL and key in the SDK you already use.

Rulezi aceleași cereri; formatul răspunsului rămâne același.Run the same requests; the response format stays the same.

Adaugi robyn.max_risk acolo unde vrei ca Robyn să decidă singur pragul.Add robyn.max_risk where you want Robyn to set the threshold.

Limite și eroriLimits and errors

CodCode	SemnificațieMeaning
400	Cerere invalidă (de exemplu, model necunoscut sau lot prea mare)Invalid request (for example, unknown model or batch too large)
401	Cheie lipsă sau invalidăMissing or invalid key
404	Resursă inexistentă sau a altei cheiResource not found or owned by another key
422	Câmp cu format greșit, cu locația exactăMalformed field, with its exact location
429	Prea multe cereri simultane; reîncearcă după `retry-after`Too many concurrent requests; retry after `retry-after`
503	Modelul se încarcăModel is loading

Instalare la clientOn-premises

Serverul Robyn rulează pe infrastructura ta, cu același API. Pachetul unic pentru instalare fără conexiune externă, cu amprente verificabile pentru fiecare fișier, este în dezvoltare și face parte din pilotul pentru infrastructură critică.The Robyn server runs on your infrastructure with the same API. The single air-gapped package, with verifiable fingerprints for every file, is in development and part of the critical-infrastructure pilot.

Documentația completă, SDK-urile și fișierul llms.txt pentru agenții de programare se publică odată cu serviciul găzduit.Full documentation, the SDKs and the llms.txt file for coding agents are published with the hosted service.