API Ultineo Reasoning
Spúšťajte aplikácie z katalógu zo svojho vlastného softvéru. API komunikuje v JSON cez HTTPS, každé volanie overuje kľúčom projektu a na každé volanie odpovedá v rovnakom formáte.
Postavené na aplikáciách, behoch a kľúčoch
- Aplikácie
Vytvorte aplikáciu z modelu, jej vstupných polí a pokynov a potom svoje aplikácie vypisujte, čítajte a upravujte.
- Behy a kvóta
Jedno volanie spustí aplikáciu s jej vstupmi, ďalšie načíta beh späť aj s odpoveďou. Súhrn ukazuje tokeny, ktoré vám zostávajú v aktuálnom fakturačnom období.
- Kľúče
Kľúče projektu s oprávneniami, voliteľnou platnosťou a stavom, ktorý môžete vypnúť.
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
}Overovanie a oprávnenia
- Kľúč typu bearer
Pri každom volaní posielajte kľúč projektu v hlavičke Authorization, a to výhradne cez HTTPS.
- Obmedzený na jeden projekt
Kľúč je viazaný na jeden projekt a nikdy nemôže čítať ani zapisovať údaje iného projektu, nech je požiadavka akákoľvek.
- Uložený ako hash
Uchováva sa iba hash kľúča, takže sa kľúč celý zobrazí len raz. Stratený kľúč sa nahradí, nikdy sa neobnovuje.
Spustite beh a prečítajte si jeho odpoveď
- Vytvoriť
Uveďte aplikáciu a zadajte jednu hodnotu pre každé vstupné pole, označenú názvom poľa, ktorý vracia aplikácia.
- Sledovať
Behy sú asynchrónne: načítavajte beh znova, kým jeho stav nie je dokončený alebo neúspešný. Oba stavy sú konečné.
- Načítať
Dokončený beh obsahuje svoju odpoveď, trvanie a počty tokenov na vstupe a výstupe.
Jednotný formát pre každú odpoveď
- Vždy rovnaké tri polia
Každá odpoveď obsahuje stavový kód, krátky názov a samotný obsah, pri úspechu aj pri chybe.
- Stále hlásenia
Chybové hlásenia sú stále anglické reťazce, ktoré uvádzajú chýbajúce oprávnenie alebo odmietnutú hodnotu.
- Limity plánu sú jasné
Volanie, ktoré plán nepokrýva alebo ktoré by prekročilo jeho kvótu, sa odmietne s vlastným stavovým kódom.
Ako získať kľúč
Prístup k API je súčasťou platených plánov Ultineo Reasoning. Samoobslužná registrácia zatiaľ nie je k dispozícii: náš tím založí váš projekt a odovzdá vám jeho prvý kľúč.
Prepojte svoj softvér s Ultineo Reasoning
Povedzte nám, čo chcete automatizovať, a my založíme váš projekt a jeho kľúč API.
Otázky k API
Platené plány. Bezplatný plán dáva prístup k aplikáciám bez API.
Nie. Inštrukcie patria vlastníkovi aplikácie. API vracia vstupné polia, pretože práve tie vypĺňa volajúci.
Vytvorenie behu sa vráti okamžite s novým stavom. Odpoveď získate tak, že beh načítavate znova, kým nie je dokončený.
Áno. Každý kľúč má svoje oprávnenia a voliteľnú platnosť a kľúč nikdy nemôže vytvoriť iný kľúč so širšími oprávneniami, než má sám.