„Ultineo Reasoning“ API
Paleiskite katalogo programas iš savo programinės įrangos. API naudoja JSON per HTTPS, kiekvieną užklausą autentifikuoja projekto raktu ir į kiekvieną užklausą atsako tuo pačiu formatu.
Sukurta aplink programėles, vykdymus ir raktus
- Programėlės
Sukurkite programėlę iš jos įvesties laukų ir instrukcijų, tada peržiūrėkite, skaitykite ir redaguokite savo programėles.
- Runs and usage
Viena užklausa paleidžia programėlę su jos įvesties duomenimis; kita nuskaito vykdymą su atsakymu. Suvestinėje matyti per einamąją atsiskaitymo savaitę panaudoti žetonai ir jų suma.
- Raktai
Projektų raktai su teisėmis, pasirenkamu galiojimo terminu ir būsena, kurią galite išjungti.
Integruokite jį bet kur
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Automatizavimuose
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Nuo vieno atsakymo iki kito
Vieno paleidimo atsakymas gali tapti kito lauku: jūsų kodas sujunga žingsnius taip, kaip jis mato tinkama.
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
Ką siunčiate
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Ką perskaityti atgal
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Autentifikavimas ir teisės
- Bearer raktas
Siųskite savo projekto raktą kiekvienos užklausos Authorization antraštėje, tik per HTTPS.
- Apribotas vienu projektu
Raktas susietas su vienu projektu ir niekada negali skaityti ar rašyti kito projekto duomenų, kad ir kokia būtų užklausa.
- Saugomas kaip maiša
Saugoma tik rakto maiša, todėl visas raktas parodomas vieną kartą. Pamestas raktas pakeičiamas, bet niekada neatkuriamas.
Paleiskite vykdymą ir perskaitykite jo atsakymą
- Sukūrimas
Nurodykite programą ir kiekvienam įvesties laukui pateikite po vieną reikšmę, kurios raktas yra programos grąžinamas lauko pavadinimas.
- Stebėjimas
Vykdymai yra asinchroniniai: skaitykite vykdymą, kol jo būsena bus baigtas arba nepavykęs. Abi būsenos galutinės.
- Nuskaitymas
Baigtame vykdyme yra jo atsakymas, trukmė ir įvesties bei išvesties žetonų skaičius.
The runs your software started, one by one
Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.
Vieningas formatas kiekvienam atsakymui
- Tie patys trys raktai
Kiekviename atsakyme yra būsenos kodas, trumpas pavadinimas ir atsakymo turinys – tiek sėkmės, tiek nesėkmės atveju.
- Pastovūs pranešimai
Klaidų pranešimai yra pastovios eilutės anglų kalba, nurodančios trūkstamą teisę arba atmestą reikšmę.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Rakto gavimas
API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.
Prijunkite savo programinę įrangą prie „Ultineo Reasoning“
Papasakokite, ką norite automatizuoti, ir mes atidarysime jūsų projektą bei jo API raktą.
Klausimai apie API
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Ne. Instrukcijos priklauso programos savininkui. API grąžina įvesties laukus, nes būtent juos užpildo kviečiantysis.
Sukūrus vykdymą, iškart grąžinama būsena naujas. Norėdami gauti atsakymą, skaitykite vykdymą, kol jis bus baigtas.
Taip. Kiekvienas raktas turi teises ir pasirenkamą galiojimo terminą, o raktas niekada negali sukurti kito rakto su platesnėmis teisėmis nei jo paties.