Ultineo Reasoning

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.

Reasoning chains

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
}

Read the API documentation

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.

See the pricing

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.