AI এজেন্ট

AI এজেন্ট একটি বহু-ধাপের সহকারী। সে কথোপকথন পড়ে, পরিকল্পনা করে, টুল (আপনার AI টুল, MCP টুল ও নলেজ বেস সার্চ) কল করে, ফলাফল দেখে এবং উত্তর না পাওয়া পর্যন্ত আবার মডেলকে কল করে। AI চ্যাট কমপ্লিশন তৈরি করুন নোড একবার মডেল কল করে উত্তর দেয়; AI এজেন্ট নোড উত্তর দেওয়ার আগে আপনার ঠিক করা সীমার মধ্যে থেকে একাধিকবার মডেল ও টুল কল করতে পারে।

কোনো অনুরোধে একাধিক ধাপ লাগলে এজেন্ট ব্যবহার করুন, যেমন "গ্রাহকের অর্ডার খুঁজে ডেলিভারির অবস্থা দেখো এবং নতুন তারিখ প্রস্তাব করো"। নির্দেশনা ও নলেজ বেস থেকে সরাসরি উত্তর দিতে হলে AI নোডই সহজ ও সস্তা।

মূল উপাদান

অংশ	এটি কী	কোথায় সেট করবেন
AI হারনেস	যে ইঞ্জিন এজেন্ট লুপ চালায়: MonoChat-এর নিজস্ব, একটি এজেন্ট SDK, বা হোস্টেড এজেন্ট সার্ভিস।	সেটিংস › অটোমেশন › AI হারনেস
মডেল	এজেন্ট যে AI মডেল দিয়ে চিন্তা করে: একটি প্রধান মডেল, ঐচ্ছিক ফলব্যাক মডেল ও ঐচ্ছিক ফাস্ট মডেল। হোস্টেড হারনেস নিজেদের প্রোভাইডারের মডেল ব্যবহার করে।	AI এজেন্ট নোড
টুল	AI স্কোপ, AI টুল ফাংশন ও MCP টুল।	AI এজেন্ট নোড
এক্সিকিউশন বাজেট	প্রতিটি রানের জন্য মডেল কল, টুল কল, টোকেন, সময়কাল ও পুনঃচেষ্টার সীমা।	AI এজেন্ট নোড
রান	এজেন্টের একটি এক্সিকিউশন। প্রতিটি রান AI এজেন্ট রান-এ রেকর্ড হয়।	নোড বা API দিয়ে তৈরি হয়

AI হারনেস

সেটিংস › অটোমেশন › AI হারনেস-এ সেই হারনেসগুলোর তালিকা থাকে যেগুলোতে আপনার এজেন্ট চলতে পারে: MonoChat যেগুলো সব ওয়ার্কস্পেসকে দেয় এবং আপনি নিজের ক্রেডেনশিয়াল দিয়ে যেগুলো যোগ করেন।

হারনেস	কোথায় চলে	যে মডেল ব্যবহার করে	কে যোগ করে
MonoChat Native	MonoChat-এর ভেতরে	আপনার AI মডেল	MonoChat
OpenAI Agents SDK	MonoChat-এর ভেতরে	আপনার AI মডেল	MonoChat
Claude Agent SDK	MonoChat এজেন্ট রানারে	আপনার AI মডেল	MonoChat
pi	MonoChat এজেন্ট রানারে	আপনার AI মডেল	MonoChat
OpenAI Agents API	OpenAI-এর ক্লাউডে	হারনেসের অনুমোদিত মডেল	আপনি, নিজের OpenAI API কী দিয়ে (MonoChat-ও একটি দিতে পারে)
Claude Managed Agents	Anthropic-এর ক্লাউডে	হারনেসের অনুমোদিত মডেল	আপনি, নিজের Anthropic API কী দিয়ে (MonoChat-ও একটি দিতে পারে)
Custom Endpoint	আপনার নিজের সার্ভারে	আপনার AI মডেল (ঐচ্ছিক)	আপনি, নিজের এন্ডপয়েন্ট ও সিক্রেট দিয়ে

MonoChat-এ চলা হারনেসগুলো MonoChat নিজেই দেয়; আপনার ওয়ার্কস্পেস শুধু সেই হারনেস যোগ করতে পারে যেগুলো নিজের ক্রেডেনশিয়াল নেয়। Claude Agent SDK ও pi-এর জন্য MonoChat-এর এজেন্ট রানার দরকার: যেখানে এটি সেট আপ করা নেই, সেখানে এগুলোতে রান "This harness is not available on this server." ত্রুটিতে ব্যর্থ হয়।

হারনেস যেটাই হোক, নিয়ন্ত্রণ MonoChat-এর হাতেই থাকে: আপনার AI মডেল ব্যবহারকারী হারনেসের প্রতিটি মডেল কল MonoChat-এর মধ্য দিয়ে যায় (তাই বিলিং ও বাজেট প্রযোজ্য হয়), প্রতিটি টুল কল আপনার ওয়ার্কস্পেসের ফাংশন, MCP টুল ও AI স্কোপ চালায়, এবং সব হারনেসেই বাজেট কার্যকর হয়।

হারনেস যোগ করুন

সেটিংস › অটোমেশন › AI হারনেস-এ যান এবং + (তৈরি করুন) ক্লিক করুন।
একটি নাম এবং চাইলে বিবরণ লিখুন।
হার্নেস বেছে নিন। প্রতিটি অপশনে লেখা থাকে সেটি কোথায় চলে।
ক্রেডেনশিয়াল-এর অধীনে হারনেসের প্রয়োজনীয় তথ্য দিন:
- OpenAI Agents API, Claude Managed Agents: API কী।
- Custom Endpoint: এন্ডপয়েন্ট ও API কী।
হোস্টেড হারনেসের ক্ষেত্রে অনুমোদিত মডেল পূরণ করুন: প্রোভাইডারের মডেলের নাম দিন (যেমন OpenAI বা Anthropic মডেল ID)। মডেল যোগ করুন দিয়ে সর্বোচ্চ ১০টি মডেল যোগ করা যায়। এই হারনেসের এজেন্ট শুধু এই তালিকা থেকেই বেছে নিতে পারবে।
সংরক্ষণ করুন ক্লিক করুন।

হারনেস সম্পাদনার সময় হার্নেস-এর ধরন বদলানো যায় না, এবং কী ফিল্ডে লেখা থাকে API কী (সংরক্ষিত কী রাখতে খালি রাখুন)।

Claude Managed Agents

এই ধরনের হারনেস প্রথমবার ব্যবহারের সময় MonoChat ওই Anthropic অ্যাকাউন্টে একটি এজেন্ট ও একটি এনভায়রনমেন্ট তৈরি করে এবং পরে সেগুলোই আবার ব্যবহার করে।

Custom Endpoint

Custom Endpoint হারনেস রান পাঠায় আপনার নিজের সার্ভিসে, যেমন সেলফ-হোস্টেড এজেন্টে। প্রতিটি রানের জন্য MonoChat Authorization: Bearer <API Key> হেডারসহ <Endpoint>/runs-এ একটি POST পাঠায়। বডিতে থাকে রান ID, নির্দেশনা, ইনপুট, কথোপকথনের বার্তা, বাজেট, মডেলের এলিয়াস (agent-main, agent-fallback, agent-fast) এবং এই রানের টোকেনসহ তিনটি URL:

একটি মডেল গেটওয়ে (OpenAI-সামঞ্জস্যপূর্ণ …/v1 ও Anthropic-সামঞ্জস্যপূর্ণ বেস URL), যা নোডের AI মডেল কল করে ও বাজেট কার্যকর করে,
একটি MCP সার্ভার, যা রানের টুলগুলো প্রকাশ করে,
একটি ইভেন্ট URL, যেখানে আপনার সার্ভিস ফলাফল জানায় (resultসহ completed, অথবা errorসহ failed)।

রান শেষ হলে রানের টোকেন আর কাজ করে না।

AI এজেন্ট নোড

ফ্লো ডিজাইনারে হাইব্রিড নোডের অধীনে AI এজেন্ট নোড দিয়ে ফ্লোতে এজেন্ট যোগ করুন। নোড কীভাবে যোগ ও সংযুক্ত করতে হয় তা জানতে ফ্লো দেখুন।

ফিল্ড

অংশ	ফিল্ড	বিবরণ
	নাম	ক্যানভাসে দেখানো নোডের নাম।
	AI হারনেস	আবশ্যক। যে হারনেস এজেন্ট চালায়।
	নির্দেশনা	এজেন্টের সিস্টেম নির্দেশনা: তার ভূমিকা, সুর, নিয়ম এবং কী করতে পারবে বা পারবে না।
	টাস্ক (এজেন্টের নির্দেশনায় যুক্ত হয়; ট্যাগ ব্যবহার করা যায়)	এই নোড এজেন্টকে কী করতে বলছে। এটি নির্দেশনার পরে যুক্ত হয় এবং AI নোডের প্রম্পটের মতোই ট্যাগ ব্যবহার করা যায়, যেমন গ্রাহকের তথ্য যোগ করতে।
মডেল	প্রধান মডেল	এজেন্ট যে মডেল ব্যবহার করে। Custom Endpoint ছাড়া সব হারনেসে আবশ্যক।
	ফলব্যাক মডেল (সফট লিমিটের পরে)	মডেল কলের সফট লিমিটে পৌঁছালে এজেন্ট যে মডেলে বদলে যায়, সাধারণত একটি সস্তা বা দ্রুত মডেল।
	ফাস্ট মডেল (হালকা ব্যাকগ্রাউন্ড কাজ)	যে মডেল হারনেস তার হালকা ব্যাকগ্রাউন্ড কলের জন্য ব্যবহার করতে পারে।
	মডেল (হারনেসের অনুমোদিত মডেলগুলোর একটি)	হোস্টেড হারনেসের ক্ষেত্রে উপরের তিনটি ফিল্ডের বদলে এটি দেখানো হয়।
এজেন্ট সেশন	কথোপকথন	বিদ্যমান এজেন্ট সেশন চালিয়ে যান (ডিফল্ট) অথবা নতুন এজেন্ট সেশন শুরু করুন। দেখুন এজেন্ট সেশন।
	টাস্ক কী (টাস্ক অনুযায়ী আলাদা এজেন্ট সেশন)	ঐচ্ছিক। একই কথোপকথনে প্রতিটি কী-এর জন্য আলাদা এজেন্ট সেশন রাখে, যেমন `booking` ও `support`।
	বার্তার ইতিহাসের সীমা	এজেন্ট কথোপকথনের কতগুলো বার্তা পাবে।
	স্পিচ-টু-টেক্সট AI মডেল	ট্রান্সক্রিপ্ট ফিচারওয়ালা একটি মডেল। কথোপকথনের ভয়েস বার্তা এজেন্টের কাছে টেক্সট হিসেবে পৌঁছায়।
টুল সেটিংস	AI স্কোপ	এজেন্ট যে নলেজ বেসে সার্চ করতে পারে। এগুলো এজেন্টকে নলেজ বেস সার্চ টুল হিসেবে দেওয়া হয়।
	AI টুল	AI টুল ধরনের যে ফাংশন এজেন্ট কল করতে পারে।
	AI MCP ক্লায়েন্ট কনটেন্ট টুল সেট করুন	যে ড্রয়ারে MCP টুল যোগ করেন সেটি খোলে। দেখুন MCP ক্লায়েন্ট।
বার্তা	মধ্যবর্তী বার্তা গ্রাহকের কাছে পাঠান	ডিফল্টে বন্ধ। চালু থাকলে এজেন্ট কাজ চলাকালীন যা লেখে (যেমন "আপনার অর্ডারটি দেখে নিচ্ছি") তা গ্রাহকের কাছে যায়; বন্ধ থাকলে তা কেবল আপনার টিম দেখতে পায় এমন হুইস্পার বার্তা হিসেবে সেশনে যুক্ত হয়।
	উত্তর পাঠান	ডিফল্টে চালু। এজেন্টের চূড়ান্ত উত্তর গ্রাহকের কাছে পাঠায়। উত্তরটি শুধু ফ্লোর ভেতরে ব্যবহার করতে চাইলে বন্ধ করুন।
এক্সিকিউশন বাজেট	সর্বোচ্চ মডেল কল	ডিফল্ট ৪।
	সফট লিমিট: মডেল কল	ঐচ্ছিক। এতগুলো মডেল কলের পরে এজেন্ট ফলব্যাক মডেলে চলে যায়। সর্বোচ্চ মডেল কল-এর চেয়ে কম হতে হবে এবং ফলব্যাক মডেল লাগবে।
	সর্বোচ্চ টুল কল	ডিফল্ট ৬। `0` হলে এজেন্ট টুল কল করার চেষ্টা করামাত্র রান বাজেট অতিক্রম করেছে হিসেবে শেষ হয়।
	সর্বোচ্চ মোট টোকেন	ডিফল্ট ২০০০০। রানের সব মডেল কলের ইনপুট ও আউটপুট টোকেন।
	সর্বোচ্চ সময়কাল (সেকেন্ড)	ডিফল্ট ৩০।
	সর্বোচ্চ পুনঃচেষ্টা	ডিফল্ট ২। ব্যর্থ মডেল কল কতবার আবার চেষ্টা করা হবে।

টিপ

স্থায়ী নিয়মগুলো নির্দেশনা-য় এবং এই ধাপের নির্দিষ্ট কাজটি টাস্ক-এ লিখুন। এতে একটি ফ্লোর একাধিক AI এজেন্ট নোড একই নির্দেশনা ভাগ করে নিতে পারে এবং শুধু টাস্কে আলাদা হয়।

সতর্কবার্তা

হোস্টেড হারনেস সফট লিমিট সমর্থন করে না, কারণ সেগুলো ফলব্যাক মডেলে বদলাতে পারে না। এগুলোর জন্য সফট লিমিট: মডেল কল খালি রাখুন।

ফ্লো নোডে পৌঁছালে কী ঘটে

MonoChat আপনার ব্যালেন্স ও নোডের সেটিংস যাচাই করে একটি রান শুরু করে। রান প্রথমে Queued, তারপর Running হয়। ফ্লো ইনস্ট্যান্স নোডে অপেক্ষা করে।
এজেন্ট নির্দেশনা ও টাস্ক পায়, এবং ফ্লো কোনো কথোপকথনের হলে বার্তার ইতিহাসের সীমা পর্যন্ত কথোপকথনের বার্তা পায়, ভয়েস বার্তা ট্রান্সক্রাইব করা অবস্থায়।
উত্তর না পাওয়া পর্যন্ত বা কোনো সীমায় না পৌঁছানো পর্যন্ত এজেন্ট মডেল ও টুল কল করে। টুল কলের মাঝে সে যে টেক্সট লেখে তা মধ্যবর্তী বার্তা হিসেবে সামলানো হয়।
রান শেষ হলে:
- যদি তা সম্পন্ন হয়েছে এবং উত্তর পাঠান চালু থাকে, উত্তরটি গ্রাহকের কাছে পাঠানো হয়। উত্তর চ্যানেলের সীমা ছাড়ালে (WhatsApp-এ ৪০৯৬ অক্ষর) তা কয়েকটি বার্তায় ভাগ করা হয়;
- অন্যভাবে শেষ হলে আপনার টিমের জন্য সেশনে "AI agent run ended: status. error" নামে একটি হুইস্পার বার্তা যুক্ত হয়।
রান যেভাবে শেষ হয়েছে সেই আউটপুট ধরে ফ্লো চলতে থাকে।

একই এজেন্ট সেশনের রানগুলো একটি একটি করে, ক্রমানুসারে প্রসেস হয়।

আউটপুট

আউটপুট	কখন
সম্পন্ন হয়েছে	এজেন্ট একটি উত্তর দিয়ে শেষ করেছে।
বাজেট অতিক্রম করেছে	রান সর্বোচ্চ মডেল কল, সর্বোচ্চ টুল কল বা সর্বোচ্চ মোট টোকেন শেষ করে ফেলেছে।
সময় শেষ হয়েছে	রান সর্বোচ্চ সময়কাল (সেকেন্ড)-এ পৌঁছেছে।
ঘৃণা, জেলব্রেক, আত্মক্ষতি, যৌনতা, সহিংসতা	মডেল প্রোভাইডারের কনটেন্ট ফিল্টার এই বিভাগের জন্য রানটি থামিয়েছে। এগুলো AI নোডের আউটপুটের মতোই।
ব্যর্থ হলে	রান অন্য কোনো কারণে ব্যর্থ হয়েছে বা বাতিল হয়েছে। এই আউটপুটগুলো আসার আগে সংরক্ষিত নোডে কনটেন্ট-ফিল্টারে থামলেও এখানেই যায়; সেগুলো পেতে নোডটি খুলে আবার সংরক্ষণ করুন।

কমপক্ষে সম্পন্ন হয়েছে ও ব্যর্থ হলে সংযুক্ত করুন। একটি প্রচলিত পদ্ধতি হলো বাজেট অতিক্রম করেছে, সময় শেষ হয়েছে ও ব্যর্থ হলে একটি কথোপকথন অ্যাসাইন করুন নোডে পাঠানো, যাতে কোনো সহকর্মী দায়িত্ব নিতে পারেন।

এজেন্ট সেশন

এজেন্ট সেশন হলো একাধিক রান জুড়ে এজেন্টের স্মৃতি। MonoChat প্রতিটি কথোপকথন, হারনেস ও টাস্ক কী-এর জন্য একটি সক্রিয় এজেন্ট সেশন রাখে।

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

বিলিং

MonoChat-এর দেওয়া AI মডেল-এর মডেল কল যথারীতি আপনার ব্যালেন্স থেকে বিল হয়। নিজের মডেলের কল বিল করে আপনার প্রোভাইডার।
MonoChat-এর দেওয়া হারনেস প্রতি রান, প্রতি মিনিট ও প্রতি টুল কলের জন্য নিজস্ব ফি এবং হোস্টেড হারনেসের ক্ষেত্রে তার প্রোভাইডারের জানানো টোকেনের চার্জ যোগ করতে পারে। এগুলো লেনদেন-এ AI Agent Run, AI Agent Duration, AI Agent Tool Call এবং AI টোকেন ক্যাটাগরি হিসেবে দেখা যায়।
নিজের ক্রেডেনশিয়াল দিয়ে যোগ করা হারনেসে MonoChat-এর কোনো ফি নেই; তার প্রোভাইডার আপনাকে বিল করে।
ব্যালেন্স অপর্যাপ্ত হলে রান শুরু হয় না।

AI Agent Run Finished ইভেন্ট

AI Agent Run Finished একটি ইভেন্ট নোড। কোনো গ্রাহকের সাথে যুক্ত রান শেষ হলে এটি চালু হয়, রানটি ফ্লো দিয়ে শুরু হোক বা সেশনসহ API দিয়ে। অন্য ইভেন্ট নোডের মতো এতেও ঐচ্ছিক শর্ত ও টাইমআউট সেটিংস আছে। এজেন্ট রানের পরে আলাদা ফ্লো শুরু করতে এটি ব্যবহার করুন, যেমন ফলাফল লগ করতে বা কোনো টিমকে জানাতে।

কোড থেকে এজেন্ট চালু করুন

কাস্টম ফাংশন ও API ক্লায়েন্ট এই মেথড দিয়ে এজেন্ট চালাতে পারে (পারমিশন Start / Read / Cancel AI agent runs in automation):

মেথড	কী করে
`business.tenants.automation.ai.aiAgentRuns.create`	একটি রান শুরু করে। `aiAgentRunId` ও `aiAgentSessionId` ফেরত দেয়।
`business.tenants.automation.ai.aiAgentRuns.show`	একটি রান (`_id`) তার স্ট্যাটাস, ব্যবহার, ধাপ ও ফলাফলসহ ফেরত দেয়।
`business.tenants.automation.ai.aiAgentRuns.cancel`	কিউতে থাকা বা চলমান রান (`_id`) বাতিল করে।

create নেয় aiHarnessClientId, input (টাস্ক), ঐচ্ছিকভাবে sessionId (কথোপকথনে কাজ করতে), aiAgentSessionId, taskKey ও isNewSession, এবং নোডের মতো একই সেটিংসহ options: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer এবং আবশ্যক budget। API দিয়ে forwardIntermediateMessages ও willSendAnswer ডিফল্টে false থাকে।

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

রানটি অ্যাসিঙ্ক্রোনাস: পরে show দিয়ে এটি পড়ুন, অথবা AI Agent Run Finished ইভেন্ট দিয়ে এতে সাড়া দিন। sessionId ছাড়া প্রতিটি কল নতুন এজেন্ট সেশন শুরু করে, যদি না আপনি আগের কলের ফেরত দেওয়া aiAgentSessionId পাঠান; তখন এজেন্ট ওই এজেন্ট সেশনের আগের সম্পন্ন রানগুলো তার ইতিহাস হিসেবে দেখে। ফাংশন থেকে মেথড কল করার নিয়ম জানতে মেথড দেখুন।

পারমিশন

পারমিশন	যা করার অনুমতি দেয়
Read / Create / Update / Delete AI harnesses in automation	AI হারনেস পরিচালনা
Read AI agent runs in automation	AI এজেন্ট রান দেখা
Start AI agent runs in automation	`aiAgentRuns.create` কল করা
Cancel AI agent runs in automation	`aiAgentRuns.cancel` কল করা

দেখুন রোল।

AI এজেন্ট রান: প্রতিটি রান কী করেছে দেখুন
AI মডেল
MCP ক্লায়েন্ট
AI স্কোপ
ফ্লো

মূল উপাদান​

AI হারনেস​

হারনেস যোগ করুন​

Custom Endpoint​

AI এজেন্ট নোড​

ফিল্ড​

ফ্লো নোডে পৌঁছালে কী ঘটে​

আউটপুট​

এজেন্ট সেশন​

বিলিং​

AI Agent Run Finished ইভেন্ট​

কোড থেকে এজেন্ট চালু করুন​

পারমিশন​

সংশ্লিষ্ট পেজ​