Ultineo Reasoning

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.

Reasoning chains

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
}

Read the API documentation

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.

See the pricing

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.