Ultineo Reasoning:n API
Aja katalogin sovelluksia omasta ohjelmistostasi. API käyttää JSONia HTTPS:n yli, todentaa jokaisen kutsun projektiavaimella ja vastaa jokaiseen kutsuun samassa muodossa.
Rakennettu sovellusten, ajojen ja avainten ympärille
- Sovellukset
Luo sovellus sen syötekentistä ja ohjeista, ja listaa, lue ja muokkaa sitten sovelluksiasi.
- Runs and usage
Yksi kutsu käynnistää sovelluksen syötteineen, toinen lukee ajon takaisin vastauksineen. Yhteenveto näyttää kuluvalla laskutusviikolla käytetyt tokenit ja niiden summan.
- Avaimet
Projektiavaimet käyttöoikeuksineen, valinnaisine voimassaoloaikoineen ja tiloineen, jonka voit kytkeä pois päältä.
Yhdistä se mihin tahansa
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Automaatioissasi
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Vastauksesta toiseen
Yhden ajon vastaus voi muodostua seuraavan kentäksi: koodisi kytkee vaiheet toisiinsa haluamallaan tavalla.
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.
Mitä lähetät
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Mikä luet uudelleen
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Todennus ja käyttöoikeudet
- Bearer-avain
Lähetä projektiavaimesi jokaisen kutsun Authorization-otsakkeessa, vain HTTPS-yhteyden kautta.
- Rajattu yhteen projektiin
Avain on sidottu yhteen projektiin, eikä se voi koskaan lukea tai kirjoittaa toisen projektin tietoja, oli pyyntö mikä tahansa.
- Tallennettu tiivisteenä
Avaimesta tallennetaan vain tiiviste, joten avain näytetään kokonaan vain kerran. Kadonnut avain korvataan, sitä ei koskaan palauteta.
Käynnistä ajo ja lue sen vastaus
- Luo
Nimeä sovellus ja anna yksi arvo kutakin syötekenttää kohden, avaimena sovelluksen palauttama kentän nimi.
- Seuraa
Ajot ovat asynkronisia: lue ajo uudelleen, kunnes sen tila on valmis tai epäonnistunut. Kumpikin tila on lopullinen.
- Lue
Valmis ajo sisältää vastauksensa, kestonsa sekä syötteen ja tulosteen tokenimäärät.
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.
Yksi vakiomuoto jokaiselle vastaukselle
- Aina samat kolme kenttää
Jokainen vastaus sisältää tilakoodin, lyhyen otsikon ja varsinaisen sisällön, niin onnistuessa kuin virhetilanteessa.
- Pysyvät ilmoitukset
Virheilmoitukset ovat pysyviä englanninkielisiä merkkijonoja, jotka nimeävät puuttuvan käyttöoikeuden tai hylätyn arvon.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Näin saat avaimen
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.
Yhdistä ohjelmistosi Ultineo Reasoning:hin
Kerro meille, mitä haluat automatisoida, niin avaamme projektisi ja sen API-avaimen.
Kysymyksiä API:sta
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Ei. Ohjeet kuuluvat sovelluksen omistajalle. API palauttaa syötekentät, koska juuri ne kutsuja täyttää.
Ajon luominen palaa heti uuden tilan kanssa. Saat vastauksen lukemalla ajon uudelleen, kunnes se on valmis.
Kyllä. Jokaisella avaimella on omat käyttöoikeutensa ja valinnainen voimassaoloaika, eikä avain voi koskaan luoda toista avainta, jolla on laajemmat käyttöoikeudet kuin sillä itsellään.