API на Ultineo Reasoning
Стартирайте приложенията от каталога от своя софтуер. API използва JSON през HTTPS, удостоверява всяко извикване с ключ на проекта и отговаря на всяко извикване в един и същ формат.
Изграден около приложения, изпълнения и ключове
- Приложения
Създайте приложение от неговите полета за въвеждане и инструкции, след което преглеждайте, четете и редактирайте приложенията си.
- Runs and usage
Едно извикване стартира приложение с входните му данни; друго прочита изпълнението заедно с отговора. Обобщение показва използваните токени в текущата седмица на фактуриране и тяхната сума.
- Ключове
Ключове на проекта с права, незадължителен срок на валидност и статус, който можете да изключите.
Интегрирайте го навсякъде
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- В автоматизациите ви
A script or an automation tool launches a run at each event: a form received, a file dropped.
- От един отговор до следващия
Резултатът от едно изпълнение може да стане поле на следващото: вашият код свързва стъпките според предпочитанията си.
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.
Какво изпращате
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Какво четеш на глас
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Удостоверяване и права
- Ключ от тип bearer
Изпращайте ключа на проекта си в заглавката Authorization на всяко извикване, само през HTTPS.
- Ограничен до един проект
Ключът е обвързан с един проект и никога не може да чете или записва данни на друг проект, каквото и да е запитването.
- Съхранява се като хеш
Пази се само хеш на ключа, затова ключът се показва изцяло само веднъж. Изгубеният ключ се заменя, никога не се възстановява.
Стартирайте изпълнение и прочетете отговора му
- Създаване
Посочете приложението и подайте по една стойност за всяко входно поле, с ключ името на полето, което връща приложението.
- Проследяване
Изпълненията са асинхронни: четете изпълнението отново, докато статусът му стане завършено или неуспешно. И двата са окончателни.
- Четене
Завършеното изпълнение съдържа отговора си, продължителността и броя токени за вход и изход.
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.
Единен формат за всеки отговор
- Същите три ключа
Всеки отговор съдържа кода на състоянието, кратко заглавие и съдържанието на отговора, както при успех, така и при грешка.
- Стабилни съобщения
Съобщенията за грешка са стабилни низове на английски, които посочват липсващото право или отхвърлената стойност.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Получаване на ключ
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.
Свържете своя софтуер с Ultineo Reasoning
Кажете ни какво искате да автоматизирате и ние ще отворим вашия проект и неговия API ключ.
Въпроси за API
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Не. Инструкциите принадлежат на собственика на приложението. API връща входните полета, защото именно тях попълва извикващият.
Създаването на изпълнение връща веднага статус ново. Четете изпълнението отново, докато не бъде завършено, за да получите отговора.
Да. Всеки ключ има права и незадължителен срок на валидност, а ключ никога не може да създаде друг ключ с по-широки права от своите.