API-ul Ultineo Reasoning
Rulați aplicațiile din catalog din propriul software. API-ul folosește JSON prin HTTPS, autentifică fiecare apel cu o cheie de proiect și răspunde la fiecare apel în același format.
Construit în jurul aplicațiilor, rulărilor și cheilor
- Aplicații
Creați o aplicație dintr-un model, câmpurile sale de intrare și instrucțiunile sale, apoi listați, citiți și editați aplicațiile dvs.
- Rulări și cotă
Un apel lansează o aplicație cu datele ei de intrare; altul citește rularea împreună cu răspunsul. Un rezumat arată tokenurile rămase în ciclul dvs. de facturare.
- Chei
Chei de proiect cu permisiuni, o expirare opțională și un status pe care îl puteți dezactiva.
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
}Autentificare și permisiuni
- O cheie de tip bearer
Trimiteți cheia proiectului în antetul Authorization al fiecărui apel, numai prin HTTPS.
- Limitată la un singur proiect
O cheie este legată de un singur proiect și nu poate citi sau scrie niciodată datele altui proiect, oricare ar fi cererea.
- Stocată ca hash
Se păstrează doar un hash al cheii, așa că o cheie este afișată integral o singură dată. O cheie pierdută este înlocuită, niciodată recuperată.
Lansați o rulare și citiți-i răspunsul
- Creare
Indicați aplicația și furnizați câte o valoare pentru fiecare câmp de intrare, cu cheia egală cu numele câmpului returnat de aplicație.
- Urmărire
Rulările sunt asincrone: citiți rularea din nou până când statusul ei este finalizat sau eșuat. Ambele sunt finale.
- Citire
O rulare finalizată conține răspunsul, durata și numărul de tokeni pentru intrare și ieșire.
Un format unitar pentru fiecare răspuns
- Aceleași trei chei
Fiecare răspuns conține codul de status, un titlu scurt și conținutul răspunsului, atât la succes, cât și la eșec.
- Mesaje stabile
Mesajele de eroare sunt șiruri stabile în engleză, care numesc permisiunea lipsă sau valoarea respinsă.
- Limitele planului sunt explicite
Un apel pe care planul nu îl acoperă sau care i-ar depăși cota este refuzat cu propriul cod de status.
Obținerea unei chei
Accesul la API vine cu planurile plătite Ultineo Reasoning. Nu există încă înregistrare self-service: echipa noastră vă deschide proiectul și vă predă prima lui cheie.
Conectați-vă software-ul la Ultineo Reasoning
Spuneți-ne ce vreți să automatizați și vă vom deschide proiectul împreună cu cheia API.
Întrebări despre API
Planurile plătite. Planul gratuit oferă acces la aplicații fără API.
Nu. Instrucțiunile aparțin proprietarului aplicației. API-ul returnează câmpurile de intrare, adică ceea ce completează apelantul.
Crearea unei rulări răspunde imediat cu statusul nou. Citiți rularea din nou până când este finalizată, pentru a obține răspunsul.
Da. Fiecare cheie are permisiuni și o expirare opțională, iar o cheie nu poate crea niciodată o altă cheie cu permisiuni mai largi decât ale sale.