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
Bir modelden, giriş alanlarından ve talimatlarından bir uygulama oluşturun, ardından uygulamalarınızı listeleyin, okuyun ve düzenleyin.
- Çalıştırmalar ve kota
Bir çağrı, bir uygulamayı girdileriyle başlatır; diğeri çalıştırmayı yanıtıyla birlikte geri okur. Bir özet, fatura döneminizde kalan token sayısını gösterir.
- Anahtarlar
Yetki kapsamları, isteğe bağlı bir son kullanma tarihi ve kapatabileceğiniz bir durumu olan proje anahtarları.
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
}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.
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.
- Plan sınırları açıktır
Planın kapsamadığı veya kotasını aşacak bir çağrı, kendine özgü bir durum koduyla reddedilir.
Anahtar edinme
API erişimi ücretli Ultineo Reasoning planlarıyla birlikte gelir. Henüz self servis kayıt yoktur: ekibimiz projenizi açar ve ilk anahtarını size teslim eder.
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
Ücretli planlar. Ücretsiz plan, uygulamalara API olmadan erişim sağlar.
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.