Ultineo Reasoning API'si
Katalogdaki uygulamaları kendi yazılımınızdan çalıştırın. API, HTTPS üzerinden JSON kullanır, her çağrının kimliğini bir proje anahtarıyla doğrular ve her çağrıyı aynı zarf içinde yanıtlar.
Uygulamalar, çalıştırmalar ve anahtarlar etrafında kurgulandı
- Uygulamalar
Giriş alanlarından ve talimatlarından bir uygulama oluşturun, ardından uygulamalarınızı listeleyin, okuyun ve düzenleyin.
- Runs and usage
Bir çağrı, bir uygulamayı girdileriyle başlatır; diğeri çalıştırmayı yanıtıyla birlikte geri okur. Bir özet, mevcut fatura haftasında kullanılan token sayısını ve tutarını gösterir.
- Anahtarlar
Yetki kapsamları, isteğe bağlı bir son kullanma tarihi ve kapatabileceğiniz bir durumu olan proje anahtarları.
Herhangi bir yerde entegre edin
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Otomasyonlarınızda
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Bir yanıtın diğerine
Bir çalıştırmanın yanıtı, sonraki çalıştırmanın bir alanı olabilir: Kodunuz, adımları uygun gördüğü şekilde zincirler.
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.
Gönderdiğiniz
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Geri okuduğunuz
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Kimlik doğrulama ve yetki kapsamları
- Bearer anahtarı
Proje anahtarınızı her çağrının Authorization başlığında, yalnızca HTTPS üzerinden gönderin.
- Tek projeyle sınırlı
Bir anahtar tek bir projeye bağlıdır ve istek ne olursa olsun başka bir projenin verilerini asla okuyamaz veya yazamaz.
- Hash olarak saklanır
Anahtarın yalnızca bir özeti (hash) saklanır, bu nedenle anahtar tam haliyle yalnızca bir kez gösterilir. Kaybolan bir anahtar kurtarılmaz, yenisiyle değiştirilir.
Bir çalıştırma başlatın ve yanıtını okuyun
- Oluşturma
Uygulamayı belirtin ve her giriş alanı için, uygulamanın döndürdüğü alan adını anahtar olarak kullanan bir değer sağlayın.
- Takip
Çalıştırmalar eşzamansızdır: durumu tamamlandı veya başarısız olana kadar çalıştırmayı yeniden okuyun. İki durum da kesindir.
- Okuma
Tamamlanan bir çalıştırma; yanıtını, süresini ve girdi ile çıktı token sayılarını içerir.
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.
Her yanıt için tek bir zarf
- Aynı üç alan
Her yanıt, başarıda da hatada da durum kodunu, kısa bir başlığı ve yanıt içeriğini taşır.
- Değişmeyen mesajlar
Hata mesajları, eksik yetki kapsamını veya reddedilen değeri belirten, değişmeyen İngilizce metinlerdir.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Anahtar edinme
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.
Yazılımınızı Ultineo Reasoning ile entegre edin
Neyi otomatikleştirmek istediğinizi bize anlatın; projenizi ve API anahtarını açalım.
API hakkında sorular
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Hayır. Talimatlar uygulama sahibine aittir. API, çağıranın doldurduğu giriş alanlarını döndürür.
Çalıştırma oluşturma isteği hemen yeni durumla döner. Yanıtı almak için çalıştırmayı tamamlanana kadar yeniden okuyun.
Evet. Her anahtarın yetki kapsamları ve isteğe bağlı bir son kullanma tarihi vardır; bir anahtar, kendi kapsamından daha geniş kapsamlı başka bir anahtar asla oluşturamaz.