API সংযোগ

যেকোনো HTTP API-কে এমন একটি ফাংশনে পরিণত করুন, যা আপনার এজেন্ট কথোপকথনের মাঝখানে কল করতে পারে: একটি cURL কমান্ড পেস্ট করুন, আর উইজার্ড টুলের সংজ্ঞা, প্যারামিটার এবং অথেন্টিকেশন তৈরি করবে।

API সংযোগ হলো কাস্টম HTTP ফাংশন, যা আপনার এজেন্টরা কথোপকথনের সময় কল করতে পারে — অর্ডার খোঁজা, টিকিট তৈরি করা, আপনার নিজস্ব ব্যাকএন্ড থেকে অ্যাকাউন্টের স্ট্যাটাস আনা। আপনি সংযোগ → API (/dashboard/api-connections) এর অধীনে একবার এন্ডপয়েন্ট নির্ধারণ করেন; যেসব এজেন্টের সঙ্গে সংযোগটি যুক্ত আছে, তারা কথোপকথনের প্রয়োজনে এটি কল করতে পারে।

এটি তৈরির দুটি উপায় আছে: উইজার্ড বিশ্লেষণ করতে পারে এমন কিছু পেস্ট করুন, অথবা সংযোগটি ম্যানুয়ালি সেট আপ করুন।

দ্রুত উপায়: পেস্ট করুন এবং বিশ্লেষণ করুন#

1. নতুন API সংযোগে ক্লিক করুন

   ডায়ালগটি উইজার্ডে খুলবে। বক্সে একটি নমুনা cURL কমান্ড, OpenAPI/Swagger স্পেক, Postman এক্সপোর্ট, TypeScript ইন্টারফেস, অথবা Zod স্কিমা পেস্ট করুন।

2. বিশ্লেষণ করুন-এ ক্লিক করুন

   ThunderPhone আপনার পেস্ট থেকে সম্পূর্ণ সংযোগটি অনুমান করে — URL, মেথড, হেডার এবং পাওয়া কোয়েরি প্যারামিটার ও অনুরোধের বডি থেকে তৈরি একটি প্যারামিটার স্কিমা। আপনি পেস্ট করা হেডারগুলো (প্রমাণীকরণ হেডারসহ) এন্ডপয়েন্ট কনফিগারেশনে যোগ করা হয়।

3. হাইলাইট করা ফিল্ডগুলো নিশ্চিত করুন

   অনুমানকৃত কনফিগারেশনটি পর্যালোচনার জন্য অনুমান করা ফিল্ডগুলো হাইলাইট করে খুলবে। নাম, বিবরণ ও প্যারামিটারের ধরন সামঞ্জস্য করুন, যাতে এজেন্ট বুঝতে পারে কখন এবং কীভাবে ফাংশনটি কল করতে হবে — বিবরণটি মডেল পড়ে।

4. যাচাই ও সংরক্ষণ

   সংরক্ষণের আগে আপনার এন্ডপয়েন্টে একটি লাইভ পরীক্ষামূলক অনুরোধ চালানো হয়। অনুরোধ ব্যর্থ হলে সংযোগটি সংরক্ষিত হবে না — URL, প্রমাণীকরণ হেডার বা বডি ঠিক করে আবার চেষ্টা করুন। সফল হলে সংযোগটি যাচাইকৃত ব্যাজসহ সংরক্ষিত হয়।

আপনার পেস্টে উইজার্ড অনুরোধের URL খুঁজে না পেলে, তা জানাবে — একটি পূর্ণ http(s) এন্ডপয়েন্ট অন্তর্ভুক্ত করে আবার চেষ্টা করুন।

ম্যানুয়াল সেট আপ#

উইজার্ডে ম্যানুয়ালি সেট আপ করুন → এ ক্লিক করুন (অথবা ফিরে যেতে AI-কে এটি অনুমান করতে দেবেন? উইজার্ড ব্যবহার করুন → এ ক্লিক করুন)। ম্যানুয়াল বিল্ডারে দুটি এডিটর আছে:

• ভিজ্যুয়াল — প্রদর্শন নাম, ফাংশনের নাম, অনুরোধের URL, মেথড (POST, GET, PUT, PATCH, DELETE), কাস্টম হেডার এবং প্যারামিটার স্কিমার জন্য ফর্ম ফিল্ড (প্রপার্টি যোগ করুন এজেন্ট দিতে পারে এমন প্রতিটি আর্গুমেন্টের জন্য)।
• JSON — সরাসরি একটি টুল স্পেক পেস্ট বা সূক্ষ্মভাবে সামঞ্জস্য করার জন্য কাঁচা JSON হিসেবে একই সংজ্ঞা।

একটি পরীক্ষামূলক অনুরোধ প্যানেল (ঐচ্ছিক) আপনাকে সংরক্ষণের আগে কনফিগার করা অনুরোধটি চালাতে দেয় এবং স্ট্যাটাস, ল্যাটেন্সি ও প্রতিক্রিয়ার একটি প্রিভিউ দেখায়। যাচাই ও সংরক্ষণ সবসময় এই পরীক্ষা চালায় এবং শুধু সফল হলে সংরক্ষণ করে।

আপনার সংযোগগুলো পরিচালনা করুন#

প্রতিটি সংযোগের সারি তার যাচাইয়ের স্ট্যাটাস — যাচাইকৃত, অপরীক্ষিত, অথবা ত্রুটি — তার ফাংশনের নাম এবং কোন এজেন্টগুলো এটি ব্যবহার করে তা দেখায়। সারির অ্যাকশন মেনু থেকে আপনি করতে পারেন:

• সম্পাদনা — কনফিগারেশন আবার খুলুন।
• ক্লোন — প্রারম্ভিক বিন্দু হিসেবে এটির একটি অনুলিপি তৈরি করুন (অনুলিপিটি অপরীক্ষিত হিসেবে শুরু হয়)।
• রিভিশন ইতিহাস — আগের সংস্করণগুলো দেখুন এবং একটি এডিটরে পুনরুদ্ধার করুন।
• স্থানান্তর — আপনি যে অন্য প্রতিষ্ঠানের সদস্য, সেখানে সংযোগটি কপি বা সরান। সরালে এটি এখান থেকে মুছে যাবে; এটি ব্যবহার করা এজেন্টগুলোর পুনরায় কনফিগারেশনের প্রয়োজন হতে পারে।
• মুছুন — স্থায়ী; সংযোগটি ব্যবহারকারী এজেন্টগুলোর পুনরায় কনফিগারেশন করতে হবে।

এটি একটি এজেন্টের সঙ্গে যুক্ত করুন#

বিল্ডারের API সংযোগ বিভাগে একটি এজেন্টের সঙ্গে সংযোগটি যোগ করুন (একটি এজেন্ট তৈরি করুন)। তালিকাটি দেখায় কোন এজেন্টগুলো প্রতিটি সংযোগ ব্যবহার করে, তাই একটি পরিবর্তন কী প্রভাবিত করে তা আপনি এক নজরেই বুঝতে পারবেন।

পরবর্তী ধাপ#