API на Ultineo Reasoning
Стартирайте приложенията от каталога от своя софтуер. API използва JSON през HTTPS, удостоверява всяко извикване с ключ на проекта и отговаря на всяко извикване в един и същ формат.
Изграден около приложения, изпълнения и ключове
- Приложения
Създайте приложение от модел, неговите полета за въвеждане и инструкции, след което преглеждайте, четете и редактирайте приложенията си.
- Изпълнения и квота
Едно извикване стартира приложение с входните му данни; друго прочита изпълнението заедно с отговора. Обобщение показва оставащите токени в текущия ви период на фактуриране.
- Ключове
Ключове на проекта с права, незадължителен срок на валидност и статус, който можете да изключите.
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
}Удостоверяване и права
- Ключ от тип bearer
Изпращайте ключа на проекта си в заглавката Authorization на всяко извикване, само през HTTPS.
- Ограничен до един проект
Ключът е обвързан с един проект и никога не може да чете или записва данни на друг проект, каквото и да е запитването.
- Съхранява се като хеш
Пази се само хеш на ключа, затова ключът се показва изцяло само веднъж. Изгубеният ключ се заменя, никога не се възстановява.
Стартирайте изпълнение и прочетете отговора му
- Създаване
Посочете приложението и подайте по една стойност за всяко входно поле, с ключ името на полето, което връща приложението.
- Проследяване
Изпълненията са асинхронни: четете изпълнението отново, докато статусът му стане завършено или неуспешно. И двата са окончателни.
- Четене
Завършеното изпълнение съдържа отговора си, продължителността и броя токени за вход и изход.
Единен формат за всеки отговор
- Същите три ключа
Всеки отговор съдържа кода на състоянието, кратко заглавие и съдържанието на отговора, както при успех, така и при грешка.
- Стабилни съобщения
Съобщенията за грешка са стабилни низове на английски, които посочват липсващото право или отхвърлената стойност.
- Ограниченията на плана са ясни
Извикване, което планът не покрива или което би превишило квотата му, се отказва със собствен код на състоянието.
Получаване на ключ
Достъпът до API е включен в платените планове на Ultineo Reasoning. Все още няма самостоятелна регистрация: нашият екип отваря вашия проект и ви предоставя първия му ключ.
Свържете своя софтуер с Ultineo Reasoning
Кажете ни какво искате да автоматизирате и ние ще отворим вашия проект и неговия API ключ.
Въпроси за API
Платените планове. Безплатният план дава достъп до приложенията без API.
Не. Инструкциите принадлежат на собственика на приложението. API връща входните полета, защото именно тях попълва извикващият.
Създаването на изпълнение връща веднага статус ново. Четете изпълнението отново, докато не бъде завършено, за да получите отговора.
Да. Всеки ключ има права и незадължителен срок на валидност, а ключ никога не може да създаде друг ключ с по-широки права от своите.