Ultineo Reasoning-এর API
ক্যাটালগের অ্যাপ্লিকেশনগুলো আপনার নিজের সফটওয়্যার থেকে চালান। API HTTPS-এর মাধ্যমে JSON ব্যবহার করে, প্রতিটি কল একটি প্রকল্প কী দিয়ে প্রমাণীকরণ করে এবং প্রতিটি কলের উত্তর একই কাঠামোয় দেয়।
অ্যাপ, রান ও কী-কে ঘিরে তৈরি
- অ্যাপ
একটি মডেল, তার ইনপুট ফিল্ড এবং নির্দেশনা থেকে একটি অ্যাপ তৈরি করুন, তারপর আপনার অ্যাপগুলোর তালিকা দেখুন, পড়ুন ও সম্পাদনা করুন।
- রান ও কোটা
একটি কল ইনপুটসহ একটি অ্যাপ চালু করে; আরেকটি কল উত্তরসহ রানটি আবার পড়ে। একটি সারাংশে আপনার বিলিং চক্রে বাকি থাকা টোকেন দেখানো হয়।
- API কী
অনুমতির পরিসর, ঐচ্ছিক মেয়াদ এবং বন্ধ করা যায় এমন একটি স্ট্যাটাসসহ প্রকল্পের কী।
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 কী পাওয়া
API অ্যাক্সেস Ultineo Reasoning-এর পেইড প্ল্যানগুলোর সঙ্গে আসে। এখনো নিজে নিজে সাইন আপ করার ব্যবস্থা নেই: আমাদের টিম আপনার প্রকল্প খুলে দেয় এবং আপনাকে তার প্রথম কী দেয়।
আপনার সফটওয়্যারকে Ultineo Reasoning-এর সঙ্গে যুক্ত করুন
আপনি কী স্বয়ংক্রিয় করতে চান তা আমাদের জানান, আমরা আপনার প্রকল্প ও তার API কী খুলে দেব।
API নিয়ে প্রশ্ন
পেইড প্ল্যানগুলো। ফ্রি প্ল্যানে API ছাড়া অ্যাপ্লিকেশনগুলো ব্যবহার করা যায়।
না। নির্দেশনাগুলো অ্যাপ্লিকেশনের মালিকের। API ইনপুট ফিল্ডগুলো ফেরত দেয়, যা একজন কলার পূরণ করেন।
রান তৈরি করলে সঙ্গে সঙ্গে নতুন স্ট্যাটাসসহ উত্তর ফেরে। উত্তর পেতে রানটি শেষ না হওয়া পর্যন্ত আবার পড়ুন।
হ্যাঁ। প্রতিটি কী-তে অনুমতির পরিসর ও ঐচ্ছিক মেয়াদ থাকে, এবং কোনো কী কখনো নিজের চেয়ে বড় পরিসরের আরেকটি কী তৈরি করতে পারে না।