Ultineo Reasoning-এর API
ক্যাটালগের অ্যাপ্লিকেশনগুলো আপনার নিজের সফটওয়্যার থেকে চালান। API HTTPS-এর মাধ্যমে JSON ব্যবহার করে, প্রতিটি কল একটি প্রকল্প কী দিয়ে প্রমাণীকরণ করে এবং প্রতিটি কলের উত্তর একই কাঠামোয় দেয়।
অ্যাপ, রান ও কী-কে ঘিরে তৈরি
- অ্যাপ
ইনপুট ফিল্ড এবং নির্দেশনা থেকে একটি অ্যাপ তৈরি করুন, তারপর আপনার অ্যাপগুলোর তালিকা দেখুন, পড়ুন ও সম্পাদনা করুন।
- Runs and usage
একটি কল ইনপুটসহ একটি অ্যাপ চালু করে; আরেকটি কল উত্তরসহ রানটি আবার পড়ে। একটি সারাংশে চলতি বিলিং সপ্তাহে ব্যবহৃত টোকেন ও সেগুলোর মূল্য দেখানো হয়।
- 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-এর মাধ্যমে।
- একটি প্রকল্পের মধ্যে সীমিত
একটি কী একটিমাত্র প্রকল্পের সঙ্গে যুক্ত এবং অনুরোধ যা-ই হোক, অন্য কোনো প্রকল্পের ডেটা কখনো পড়তে বা লিখতে পারে না।
- হ্যাশ হিসেবে সংরক্ষিত
কী-এর শুধু একটি হ্যাশ রাখা হয়, তাই একটি কী পুরোপুরি একবারই দেখানো হয়। হারানো কী পুনরুদ্ধার করা হয় না, বদলে দেওয়া হয়।
একটি রান চালু করুন এবং তার উত্তর পড়ুন
- তৈরি করুন
অ্যাপ্লিকেশনের নাম দিন এবং প্রতিটি ইনপুট ফিল্ডের জন্য একটি করে মান দিন, অ্যাপ্লিকেশন যে ফিল্ড-নাম ফেরত দেয় সেই নাম অনুযায়ী।
- অনুসরণ করুন
রান অ্যাসিঙ্ক্রোনাস: স্ট্যাটাস সম্পন্ন বা ব্যর্থ না হওয়া পর্যন্ত রানটি আবার পড়ুন। দুটিই চূড়ান্ত।
- পড়ুন
সম্পন্ন রানে থাকে তার উত্তর, তার সময়কাল এবং ইনপুট ও আউটপুটের টোকেন সংখ্যা।
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.
প্রতিটি উত্তরের জন্য একই কাঠামো
- সবসময় একই তিনটি ফিল্ড
সফল হোক বা ব্যর্থ, প্রতিটি উত্তরে থাকে স্ট্যাটাস কোড, একটি সংক্ষিপ্ত শিরোনাম এবং রেসপন্স।
- স্থির বার্তা
ত্রুটির বার্তাগুলো স্থির ইংরেজি স্ট্রিং, যা অনুপস্থিত অনুমতির পরিসর বা প্রত্যাখ্যাত মানের নাম উল্লেখ করে।
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
API কী পাওয়া
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.
আপনার সফটওয়্যারকে Ultineo Reasoning-এর সঙ্গে যুক্ত করুন
আপনি কী স্বয়ংক্রিয় করতে চান তা আমাদের জানান, আমরা আপনার প্রকল্প ও তার API কী খুলে দেব।
API নিয়ে প্রশ্ন
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
না। নির্দেশনাগুলো অ্যাপ্লিকেশনের মালিকের। API ইনপুট ফিল্ডগুলো ফেরত দেয়, যা একজন কলার পূরণ করেন।
রান তৈরি করলে সঙ্গে সঙ্গে নতুন স্ট্যাটাসসহ উত্তর ফেরে। উত্তর পেতে রানটি শেষ না হওয়া পর্যন্ত আবার পড়ুন।
হ্যাঁ। প্রতিটি কী-তে অনুমতির পরিসর ও ঐচ্ছিক মেয়াদ থাকে, এবং কোনো কী কখনো নিজের চেয়ে বড় পরিসরের আরেকটি কী তৈরি করতে পারে না।