WhatsApp-এ আপনার নিজের AI এজেন্ট আনুন: ওয়েবহুক এন্ডপয়েন্টের মাধ্যমে যেকোনো ফ্রেমওয়ার্ক (LangGraph, ADK, কাস্টম) সংযুক্ত করুন

আপনি প্রায় যেকোনো AI এজেন্ট নতুন করে না লিখেই WhatsApp-এ সংযুক্ত করতে পারেন। LangGraph, Google ADK, CrewAI বা আপনার নিজের কোড দিয়ে তৈরি আপনার এজেন্টকে একটি HTTPS এন্ডপয়েন্টের পেছনে চালান, তারপর MonoChat-এ কাস্টম প্রোভাইডার দিয়ে সেটিকে একটি AI হার্নেস হিসেবে যোগ করুন: একটি এন্ডপয়েন্ট URL ও একটি শেয়ার্ড সিক্রেট। ফ্লোতে একটি AI এজেন্ট নোড বসান, আপনার WhatsApp নম্বর সংযুক্ত করুন, আর আপনার এজেন্ট WhatsApp ও MonoChat-এর সংযুক্ত অন্য প্রতিটি চ্যানেলে গ্রাহকদের উত্তর দেবে, চারপাশে শেয়ার্ড ইনবক্স ও মানব হস্তান্তরসহ।

এই গাইডটি সেইসব টিমের জন্য, যাদের আগে থেকেই একটি এজেন্ট আছে বা যারা এটি কীভাবে কাজ করে তার ওপর পূর্ণ নিয়ন্ত্রণ চায়। এতে আছে নিজের এজেন্ট আনা কখন যুক্তিযুক্ত, আপনার এন্ডপয়েন্টের দায়িত্ব কী, MonoChat-এ সেটআপ এবং প্রোডাকশনে যে খুঁটিনাটি গুরুত্বপূর্ণ।

কেন নিজের এজেন্ট আনবেন?

বেশিরভাগ কাস্টমার মেসেজিং প্ল্যাটফর্মের সঙ্গে একটি বিল্ট-ইন AI এজেন্ট আসে। তা সুবিধাজনক, যতক্ষণ না:

• আপনার এজেন্ট আগে থেকেই তৈরি। আপনার ডেভেলপাররা একটি LangGraph গ্রাফ বা ADK মাল্টি-এজেন্ট সেটআপে মাসের পর মাস কাজ করেছেন, মূল্যায়ন ও টেস্টসহ। কোনো ভেন্ডরের বট বিল্ডারে সেটি আবার তৈরি করলে সেই কাজ ফেলে দেওয়া হয়।
• আপনার নিজের লজিক দরকার। মূল্যের নিয়ম, যোগ্যতা যাচাই, কমপ্লায়েন্স ধাপ বা এমন অভ্যন্তরীণ সিস্টেম, যেখানে শুধু আপনার কোড পৌঁছাতে পারে।
• আপনি ফ্রেমওয়ার্ক বেছে নিতে চান। ফ্রেমওয়ার্ক দ্রুত বদলায়। আজ LangGraph; আগামী বছর অন্য কিছু হতে পারে। আপনার চ্যানেল ও ইনবক্সকে তার সঙ্গে বদলাতে হওয়া উচিত নয়।
• ডেটা আপনার কাছেই থাকতে হবে। কিছু প্রতিষ্ঠান চায় এজেন্টের যুক্তি ও টুল কল তাদের নিজস্ব অবকাঠামোতে চলুক।

MonoChat-এর Agent Harness এর জন্যই তৈরি: আপনার নিজের এজেন্ট ফ্রেমওয়ার্ক আনুন এবং এর চারপাশের সবকিছু, চ্যানেল, ইনবক্স, মানুষজন, এক জায়গায় রাখুন।

কাস্টম হার্নেস কীভাবে কাজ করে

একে কাজের ভাগাভাগি ভাবুন।

MonoChat কথোপকথনের স্তর সামলায়:

• WhatsApp, Instagram, Messenger, TikTok, Telegram, ওয়েব চ্যাট, SMS ও ভয়েসের অফিসিয়াল সংযোগ (MonoChat একটি অফিসিয়াল Meta Business Partner)।
• যে ফ্লো ঠিক করে AI এজেন্ট নোডের মাধ্যমে কখন এজেন্টকে ডাকা হবে।
• শেয়ার্ড টিম ইনবক্স, যেখানে একজন মানুষ পূর্ণ ইতিহাসসহ দায়িত্ব নিতে পারেন।

আপনার এন্ডপয়েন্ট এজেন্ট সামলায়:

• MonoChat থেকে কথোপকথন গ্রহণ করা।
• আপনার এজেন্ট চালানো: তার যুক্তি, তার টুল, তার মেমোরি।
• এজেন্টের উত্তর ফেরত দেওয়া।

দুইয়ের মাঝখানে থাকে একটি শেয়ার্ড সিক্রেট, যা দুই পক্ষই জানে, যাতে আপনার এন্ডপয়েন্ট যাচাই করতে পারে যে অনুরোধটি আপনার MonoChat অ্যাকাউন্ট থেকে এসেছে। আপনার এন্ডপয়েন্ট যে অনুরোধ ও উত্তরের ফরম্যাট বাস্তবায়ন করবে তা MonoChat ঠিক করে দেয়; সেটি এখনো না পেয়ে থাকলে আমাদের সঙ্গে কথা বলুন, আমরা আপনার ডেভেলপারদের সঙ্গে তা শেয়ার করব।

আপনার এন্ডপয়েন্টের যা করা উচিত

আপনি যে ফ্রেমওয়ার্কই ব্যবহার করুন, প্রোডাকশন-প্রস্তুত এজেন্ট এন্ডপয়েন্টের কয়েকটি কাজ থাকে।

প্রতিটি অনুরোধ যাচাই করুন

প্রতিটি কলে শেয়ার্ড সিক্রেট যাচাই করুন এবং যা মেলে না তা প্রত্যাখ্যান করুন। সিক্রেট কোডে নয়, আপনার সিক্রেট ম্যানেজার বা এনভায়রনমেন্ট ভেরিয়েবলে রাখুন এবং কখনো প্রকাশ পেলে বদলে ফেলুন।

প্রতিটি কথোপকথন আলাদা রাখুন

গ্রাহকেরা একই সময়ে লেখেন। নিশ্চিত করুন আপনার এজেন্টের স্টেট, মেমোরি ও কাজের ফাইল একটি কথোপকথনের মধ্যে সীমাবদ্ধ, যাতে এক গ্রাহকের তথ্য কখনো অন্যজনের উত্তরে ফাঁস না হয়।

চ্যাটের আকারের মেসেজে উত্তর দিন

ওয়েব অ্যাপের জন্য তৈরি এজেন্ট দীর্ঘ, ফরম্যাট করা উত্তর লিখতে থাকে। WhatsApp ফোনে পড়া হয়। আপনার এজেন্টকে ছোট মেসেজ, একবারে একটি প্রশ্ন লিখতে বলুন এবং উত্তরে ভারী Markdown রাখবেন না।

ব্যর্থ হলে জোরে ব্যর্থ হোন, নীরবে নয়

কোনো টুল টাইমআউট করলে বা আপনার মডেল প্রোভাইডার ত্রুটি দিলে অর্ধেক-শেষ উত্তরের বদলে একটি স্পষ্ট ব্যর্থতা ফেরত দিন। অনুমানযোগ্য ব্যর্থতা ফ্লোকে সঠিক কাজটি করতে দেয়, যেমন কথোপকথন একজন মানুষের কাছে হস্তান্তর করা।

দ্রুত হোন

গ্রাহকেরা কয়েক সেকেন্ডের মধ্যে উত্তর আশা করেন। যেখানে সম্ভব, দীর্ঘ সময় লাগা কাজ উত্তরের পথ থেকে দূরে রাখুন এবং আপনার টুলগুলো দ্রুত বা অ্যাসিনক্রোনাস করুন।

MonoChat-এ ধাপে ধাপে

1. HTTPS-এর পেছনে আপনার এজেন্ট ডিপ্লয় করুন

আপনার LangGraph, ADK, CrewAI বা কাস্টম এজেন্ট নিজের সার্ভার বা ক্লাউডে হোস্ট করুন, যাতে HTTPS-এর মাধ্যমে পৌঁছানো যায়। MonoChat-এর অনুরোধ ও উত্তরের ফরম্যাট এবং শেয়ার্ড-সিক্রেট যাচাই বাস্তবায়ন করুন।

2. কাস্টম প্রোভাইডার দিয়ে একটি AI হার্নেস যোগ করুন

MonoChat-এ একটি AI হার্নেস যোগ করুন, কাস্টম বেছে নিন এবং আপনার এন্ডপয়েন্ট URL ও শেয়ার্ড সিক্রেট দিন। হার্নেস একবার যোগ করে আপনি যত খুশি ফ্লোতে ব্যবহার করতে পারেন।

3. ফ্লোতে একটি AI এজেন্ট নোড যোগ করুন

যে ফ্লো আসা কথোপকথন গ্রহণ করে, তাতে একটি AI এজেন্ট নোড যোগ করুন এবং আপনার কাস্টম হার্নেস নির্বাচন করুন। ফ্লো যা সবচেয়ে ভালো করে, তার জন্য চারপাশের ফ্লো ব্যবহার করুন: অভ্যর্থনা, ভাষা বা বিষয় অনুযায়ী রাউটিং, কাজের সময় এবং একজন মানুষের কাছে যাওয়ার পথ।

4. প্রতিটি রানের জন্য বাজেট ঠিক করুন

প্রতিটি AI এজেন্ট নোড প্রতি রানে বাজেট সীমা সাপোর্ট করে। আপনার নিজের কোডে আপনি আগে থেকে যেসব সীমা কার্যকর করেন, তার পাশাপাশি এগুলোকে নিরাপত্তা জাল হিসেবে ব্যবহার করুন।

5. WhatsApp ও অন্যান্য চ্যানেল সংযুক্ত করুন

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

6. টেস্ট করুন, তারপর লাইভ হোন

আসল গ্রাহকদের মেসেজ ফ্লোর মধ্য দিয়ে আবার চালান। টুল কল, উত্তরের সময়, টোন ও হস্তান্তর যাচাই করুন। লাইভ ট্রাফিকের প্রথম কয়েক দিন ঘনিষ্ঠভাবে নজর রাখুন, তারপর এজেন্টকে যা করার অনুমতি দেওয়া হয়েছে তা বাড়ান।

ফ্রেমওয়ার্কের নোট

LangGraph। নোড ও এজের একটি গ্রাফ সাপোর্টের যাত্রার জন্য (ট্রায়াজ, লুকআপ, সমাধান, এসক্যালেট) স্বাভাবিকভাবেই মানানসই। কম্পাইল করা গ্রাফটিকে একটি ছোট HTTP সার্ভিসে মুড়ে নিন, প্রতিটি অনুরোধে কথোপকথনের স্টেট লোড করুন এবং চূড়ান্ত মেসেজ ফেরত দিন।

Google ADK। ADK-এর মাল্টি-এজেন্ট ট্রি, বিশেষজ্ঞ সাব-এজেন্টসহ একজন কোঅর্ডিনেটর, সাপোর্ট, সেলস ও বিলিং টিমের সঙ্গে ভালো মেলে। আপনার এন্ডপয়েন্টের মাধ্যমে রুট এজেন্ট এক্সপোজ করুন এবং ADK-কে ভেতরে রাউট করতে দিন।

CrewAI। ভূমিকাভিত্তিক এজেন্টের ক্রু, গবেষণা তারপর উত্তরের মতো স্পষ্ট হস্তান্তরযুক্ত কাজে ভালো কাজ করে। চ্যাটের জন্য ক্রু ছোট রাখুন: প্রতিটি বাড়তি এজেন্ট বিলম্ব বাড়ায়।

আপনার নিজের কোড। একটি মডেল API ও কয়েকটি ফাংশনসহ সাধারণ লুপই প্রায়ই যথেষ্ট। আপনি সম্পূর্ণ নিয়ন্ত্রণ রাখেন, আর MonoChat দেয় চ্যানেল ও ইনবক্স।

হস্তান্তর: ফ্লোতে ঠিক করুন

ফ্লোতে ঠিক করুন কোন কথোপকথন একজন মানুষের কাছে যাবে এবং কোন টিম সেগুলো পাবে, আর আপনার এজেন্টকে এমনভাবে লিখুন যে সাহায্য করতে না পারলে সে আন্দাজ না করে গ্রাহককে সৎভাবে তা বলে। এরপর ফ্লো পূর্ণ ইতিহাসসহ কথোপকথন শেয়ার্ড ইনবক্সে সঠিক টিমের কাছে হস্তান্তর করে। WhatsApp-এর Business Messaging Policy-ও আশা করে যে স্বয়ংক্রিয় উত্তরে একজন মানুষের কাছে যাওয়ার স্পষ্ট পথ থাকবে।

আপনার এজেন্টকেও আপনার ব্যবসার ভেতরে রাখুন। 2026 সালের 15 জানুয়ারি থেকে WhatsApp সাধারণ উদ্দেশ্যের AI অ্যাসিস্ট্যান্টকে প্ল্যাটফর্মের বাইরে রাখে; আপনার নিজের গ্রাহকদের সেবা দেওয়া এজেন্ট ঠিক আছে। আমাদের WhatsApp AI চ্যাটবট নীতি গাইড নিয়মটি ব্যাখ্যা করে।

কখন নিজে তৈরি করবেন না

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

• আপনার MonoChat AI মডেলে MonoChat-এর বিল্ট-ইন হার্নেস।
• MonoChat-এর ভেতরে চালানো OpenAI Agents SDK (গাইড)।
• MonoChat-এর এজেন্ট রানারে চালানো Claude Agent SDK বা Pi (Claude গাইড)।
• হোস্টেড এজেন্ট: আপনার নিজের কী দিয়ে OpenAI Agents API বা Claude Managed Agents।

প্রতিটি অপশন একই AI এজেন্ট নোড ব্যবহার করে বলে আপনি একটি দিয়ে শুরু করে পরে আপনার চ্যানেল বা হস্তান্তরে হাত না দিয়ে নিজের এজেন্টে যেতে পারেন। Agent Harness পেজে সেগুলোর তুলনা করুন।