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 din câmpurile sale de intrare și instrucțiunile sale, apoi listați, citiți și editați aplicațiile dvs.
- Runs and usage
Un apel lansează o aplicație cu datele ei de intrare; altul citește rularea împreună cu răspunsul. Un rezumat arată tokenurile folosite în săptămâna de facturare curentă și suma lor.
- Chei
Chei de proiect cu permisiuni, o expirare opțională și un status pe care îl puteți dezactiva.
Intreaga-l oriunde
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- În automatizările dvs.
A script or an automation tool launches a run at each event: a form received, a file dropped.
- De la o rețină la alta
Răspunsul unei rulare poate deveni un câmp al următoarei: codul tău lanțează pașii cum dorește.
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.
Ce trimiteți
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Ce ai citit înapoi
{
"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.
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.
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ă.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Obținerea unei chei
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.
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
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
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.