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 egy modellből, annak beviteli mezőiből és utasításaiból, majd listázza, olvassa és szerkessze alkalmazásait.
- Futtatások és kvóta
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 a számlázási ciklusában még megmaradt tokeneket.
- Kulcsok
Projektkulcsok jogosultságokkal, opcionális lejárattal és kikapcsolható állapottal.
Integrate it anywhere
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- In your automations
A script or an automation tool launches a run at each event: a form received, a file dropped.
- From one answer to the next
The answer of one run can become a field of the next: your code chains the steps as it sees fit.
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.
What you send
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
}What you read back
{
"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.
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.
- A csomag korlátai egyértelműek
Az a hívás, amelyet a csomag nem fed le, vagy amely túllépné a keretét, saját állapotkóddal kerül elutasításra.
Hogyan kaphat kulcsot
Az API-hozzáférés az Ultineo Reasoning fizetős csomagjaiban érhető el. Önkiszolgáló regisztráció még nincs: csapatunk létrehozza a projektjét, és átadja Önnek az első kulcsát.
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
A fizetős csomagok. Az ingyenes csomag API nélkül ad hozzáférést az alkalmazásokhoz.
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.