Az Ultineo Reasoning API
Futtassa a katalógus alkalmazásait saját szoftveréből. Az API JSON formátumban kommunikál HTTPS-en keresztül, minden hívást projektkulccsal hitelesít, és minden hívásra ugyanabban a formátumban válaszol.
Alkalmazásokra, futtatásokra és kulcsokra építve
- Alkalmazások
Hozzon létre egy alkalmazást annak beviteli mezőiből és utasításaiból, majd listázza, olvassa és szerkessze alkalmazásait.
- Runs and usage
Egy hívás elindít egy alkalmazást a bemeneteivel, egy másik visszaolvassa a futtatást a válasszal együtt. Egy összesítő mutatja az aktuális számlázási héten felhasznált tokeneket és azok összegét.
- Kulcsok
Projektkulcsok jogosultságokkal, opcionális lejárattal és kikapcsolható állapottal.
Integráld bárhol
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Automatizálásaiban
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Az egyik választól a másikig
Egy futás válasza a következő mezővé válhat: a kód úgy láncolja össze a lépéseket, ahogy szeretné.
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.
Amit küld
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Amit visszaolsz
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Hitelesítés és jogosultságok
- Bearer kulcs
Minden hívásnál az Authorization fejlécben küldje el a projektkulcsát, kizárólag HTTPS-en keresztül.
- Egy projektre korlátozva
Egy kulcs egyetlen projekthez tartozik, és soha nem olvashatja vagy írhatja egy másik projekt adatait, bármi legyen is a kérés.
- Hash-értékként tárolva
Csak a kulcs hash-értékét tároljuk, így a kulcs teljes egészében csak egyszer jelenik meg. Az elveszett kulcsot lecseréljük, visszaállítani soha nem lehet.
Indítson futtatást, és olvassa el a válaszát
- Létrehozás
Nevezze meg az alkalmazást, és adjon meg beviteli mezőnként egy értéket, az alkalmazás által visszaadott mezőnévvel azonosítva.
- Követés
A futtatások aszinkronok: olvassa újra a futtatást, amíg az állapota kész vagy sikertelen nem lesz. Mindkettő végleges.
- Olvasás
A kész futtatás tartalmazza a válaszát, az időtartamát, valamint a bemeneti és kimeneti tokenek számát.
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.
Egységes formátum minden válaszhoz
- Mindig ugyanaz a három mező
Minden válasz tartalmazza az állapotkódot, egy rövid címet és magát a tartalmat, sikeres és hibás esetben egyaránt.
- Állandó üzenetek
A hibaüzenetek állandó angol nyelvű szövegek, amelyek megnevezik a hiányzó jogosultságot vagy az elutasított értéket.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Hogyan kaphat kulcsot
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.
Kapcsolja össze szoftverét az Ultineo Reasoning szolgáltatással
Mondja el, mit szeretne automatizálni, és mi létrehozzuk a projektjét és annak API-kulcsát.
Kérdések az API-ról
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Nem. Az utasítások az alkalmazás tulajdonosáéi. Az API a beviteli mezőket adja vissza, mert ezeket tölti ki a hívó fél.
A futtatás létrehozása azonnal visszatér az új állapottal. A választ úgy kapja meg, hogy addig olvassa újra a futtatást, amíg az el nem készül.
Igen. Minden kulcsnak saját jogosultságai és opcionális lejárata van, és egy kulcs soha nem hozhat létre a sajátjánál tágabb jogosultságú másik kulcsot.