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)۔ زیادہ سے زیادہ 10 ماڈلز کے لیے ماڈل شامل کریں استعمال کریں۔ اس ہارنیس کے ایجنٹس صرف اسی فہرست میں سے انتخاب کر سکتے ہیں۔
محفوظ کریں پر کلک کریں۔

ہارنیس میں ترمیم کرتے وقت ہارنیس کی قسم تبدیل نہیں ہو سکتی، اور کلید کا فیلڈ 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) اور اس رن کے ٹوکن کے ساتھ تین URLs شامل ہوتے ہیں:

ایک ماڈل گیٹ وے (OpenAI سے مطابقت رکھنے والے …/v1 اور Anthropic سے مطابقت رکھنے والے بیس URLs) جو نوڈ کے AI ماڈلز کو کال کرتا ہے اور بجٹ نافذ کرتا ہے،
ایک MCP سرور جو رن کے ٹولز فراہم کرتا ہے،
ایک ایونٹس URL جہاں آپ کی سروس نتیجہ رپورٹ کرتی ہے (completed کے ساتھ result، یا failed کے ساتھ error)۔

رن ختم ہوتے ہی اس کا ٹوکن کام کرنا بند کر دیتا ہے۔

AI ایجنٹ نوڈ

فلو ڈیزائنر میں ہائبرڈ نوڈز کے تحت AI ایجنٹ نوڈ سے فلو میں ایجنٹ شامل کریں۔ نوڈز شامل کرنے اور جوڑنے کے طریقے کے لیے فلوز دیکھیں۔

فیلڈز

سیکشن	فیلڈ	تفصیل
	نام	کینوس پر دکھایا جانے والا نوڈ کا نام۔
	AI ہارنسز	لازمی۔ وہ ہارنیس جو ایجنٹ چلاتا ہے۔
	ہدایات	ایجنٹ کی سسٹم ہدایات: اس کا کردار، لہجہ، اصول اور یہ کہ وہ کیا کر سکتا ہے یا نہیں۔
	ٹاسک (ایجنٹ کی ہدایات میں شامل ہوتا ہے؛ ٹیگز استعمال کیے جا سکتے ہیں)	یہ نوڈ ایجنٹ سے کیا کروانا چاہتا ہے۔ یہ ہدایات کے بعد شامل ہوتا ہے اور AI نوڈ کے پرومپٹ والے ٹیگز استعمال کر سکتا ہے، مثلاً کسٹمر کا ڈیٹا شامل کرنے کے لیے۔
ماڈلز	مرکزی ماڈل	وہ ماڈل جو ایجنٹ استعمال کرتا ہے۔ Custom Endpoint کے سوا ہر ہارنیس کے لیے لازمی۔
	متبادل ماڈل (سافٹ لمٹ کے بعد)	وہ ماڈل جس پر ایجنٹ ماڈل کالز کی سافٹ لمٹ تک پہنچ کر منتقل ہو جاتا ہے، عموماً سستا یا تیز ماڈل۔
	تیز ماڈل (ہلکے بیک گراؤنڈ کام)	وہ ماڈل جسے ہارنیس اپنی ہلکی بیک گراؤنڈ کالز کے لیے استعمال کر سکتا ہے۔
	ماڈل (ہارنیس کے مجاز ماڈلز میں سے ایک)	ہوسٹڈ ہارنیس کے لیے اوپر کے تین فیلڈز کی جگہ دکھایا جاتا ہے۔
ایجنٹ گفتگو	گفتگو	موجودہ ایجنٹ گفتگو جاری رکھیں (ڈیفالٹ) یا نئی ایجنٹ گفتگو شروع کریں۔ ایجنٹ سیشنز دیکھیں۔
	ٹاسک کی (ہر ٹاسک کے لیے الگ ایجنٹ گفتگو)	اختیاری۔ ایک ہی گفتگو میں ہر کلید کے لیے الگ ایجنٹ گفتگو رکھتا ہے، مثلاً `booking` اور `support`۔
	پیغامات کی ہسٹری کی حد	ایجنٹ کو گفتگو کے کتنے پیغامات ملتے ہیں۔
	اسپیچ ٹو ٹیکسٹ AI ماڈلز	ٹرانسکرپٹ والا ماڈل۔ گفتگو کے وائس پیغامات ایجنٹ تک متن کی شکل میں پہنچتے ہیں۔
ٹول کی ترتیبات	AI اسکوپس	وہ نالج بیسز جن میں ایجنٹ تلاش کر سکتا ہے۔ یہ ایجنٹ کو نالج بیس سرچ ٹول کے طور پر دیے جاتے ہیں۔
	AI ٹول	AI ٹول قسم کے وہ فنکشنز جنہیں ایجنٹ کال کر سکتا ہے۔
	AI MCP کلائنٹ کنٹینٹ ٹولز سیٹ کریں	وہ ڈرار کھولتا ہے جہاں آپ MCP ٹولز شامل کرتے ہیں۔ MCP کلائنٹس دیکھیں۔
پیغامات	درمیانی پیغامات کسٹمر کو بھیجیں	ڈیفالٹ میں بند۔ ایجنٹ کام کے دوران جو لکھتا ہے (مثلاً "میں آپ کا آرڈر چیک کرتا ہوں") وہ آن ہونے پر کسٹمر کو بھیجا جاتا ہے؛ آف ہونے پر وہ سیشن میں وسپر پیغام کے طور پر شامل ہوتا ہے جسے صرف آپ کی ٹیم دیکھتی ہے۔
	جواب بھیجیں	ڈیفالٹ میں آن۔ ایجنٹ کا حتمی جواب کسٹمر کو بھیجتا ہے۔ جواب کو صرف فلو کے اندر استعمال کرنے کے لیے اسے بند کریں۔
عمل درآمد کا بجٹ	ماڈل کالز کی زیادہ سے زیادہ تعداد	ڈیفالٹ 4۔
	سافٹ لمٹ: ماڈل کالز	اختیاری۔ اتنی ماڈل کالز کے بعد ایجنٹ متبادل ماڈل پر منتقل ہو جاتا ہے۔ ماڈل کالز کی زیادہ سے زیادہ تعداد سے کم ہونی چاہیے اور متبادل ماڈل ضروری ہے۔
	ٹول کالز کی زیادہ سے زیادہ تعداد	ڈیفالٹ 6۔ `0` ہونے پر ایجنٹ جیسے ہی ٹول کال کرنے کی کوشش کرتا ہے، رن بجٹ سے تجاوز ہو گیا پر ختم ہو جاتا ہے۔
	کل ٹوکنز کی زیادہ سے زیادہ تعداد	ڈیفالٹ 20000۔ رن کی تمام ماڈل کالز کے ان پٹ اور آؤٹ پٹ ٹوکنز۔
	زیادہ سے زیادہ دورانیہ (سیکنڈ)	ڈیفالٹ 30۔
	زیادہ سے زیادہ کوششیں	ڈیفالٹ 2۔ ناکام ماڈل کال کو کتنی بار دوبارہ آزمایا جاتا ہے۔

ٹپ

مستقل اصول ہدایات میں لکھیں اور اس مرحلے کا مخصوص کام ٹاسک میں۔ اس طرح فلو میں کئی AI ایجنٹ نوڈز ایک ہی ہدایات شیئر کر سکتے ہیں اور صرف اپنے ٹاسک میں مختلف ہوتے ہیں۔

انتباہ

ہوسٹڈ ہارنیسز سافٹ لمٹ کو سپورٹ نہیں کرتے، کیونکہ وہ متبادل ماڈل پر منتقل نہیں ہو سکتے۔ ان کے لیے سافٹ لمٹ: ماڈل کالز خالی چھوڑیں۔

فلو نوڈ تک پہنچے تو کیا ہوتا ہے

MonoChat آپ کا بیلنس اور نوڈ کی ترتیبات چیک کرتا ہے اور رن شروع کرتا ہے۔ رن پہلے قطار میں ہوتا ہے، پھر چل رہا ہے۔ فلو انسٹینس نوڈ پر انتظار کرتا ہے۔
ایجنٹ کو ہدایات اور ٹاسک ملتے ہیں، اور اگر فلو کسی گفتگو سے وابستہ ہو تو پیغامات کی ہسٹری کی حد تک گفتگو کے پیغامات بھی، وائس پیغامات کی ٹرانسکرپشن کے ساتھ۔
ایجنٹ جواب ملنے یا کوئی حد آنے تک ماڈلز اور ٹولز کو کال کرتا ہے۔ ٹول کالز کے درمیان وہ جو متن لکھتا ہے اسے درمیانی پیغام کے طور پر ہینڈل کیا جاتا ہے۔
رن ختم ہونے پر:
- اگر وہ مکمل ہوا اور جواب بھیجیں آن ہے تو جواب کسٹمر کو بھیج دیا جاتا ہے۔ چینل کی حد سے لمبے جوابات کئی پیغامات میں تقسیم ہو جاتے ہیں (WhatsApp پر 4096 حروف)؛
- اگر وہ کسی اور طرح ختم ہوا تو آپ کی ٹیم کے لیے سیشن میں وسپر پیغام "AI agent run ended: status. error" شامل کر دیا جاتا ہے۔
فلو اسی آؤٹ پٹ پر آگے بڑھتا ہے جو رن کے اختتام سے مطابقت رکھتا ہو۔

ایک ہی ایجنٹ گفتگو کے رنز ایک وقت میں ایک، ترتیب سے چلتے ہیں۔

آؤٹ پٹس

آؤٹ پٹ	کب
مکمل	ایجنٹ نے جواب کے ساتھ کام مکمل کیا۔
بجٹ سے تجاوز ہو گیا	رن نے ماڈل کالز کی زیادہ سے زیادہ تعداد، ٹول کالز کی زیادہ سے زیادہ تعداد یا کل ٹوکنز کی زیادہ سے زیادہ تعداد ختم کر دی۔
وقت ختم ہو گیا	رن زیادہ سے زیادہ دورانیہ (سیکنڈ) تک پہنچ گیا۔
نفرت انگیز، جیل بریک، خود کو نقصان، جنسی، تشدد	ماڈل فراہم کنندہ کے کنٹینٹ فلٹر نے اس زمرے کی وجہ سے رن روک دیا۔ یہ وہی آؤٹ پٹس ہیں جو AI نوڈ میں ہیں۔
ناکامی کی صورت میں	رن کسی اور وجہ سے ناکام ہوا، یا منسوخ کر دیا گیا۔ ان آؤٹ پٹس کے آنے سے پہلے محفوظ کیے گئے نوڈز پر کنٹینٹ فلٹر سے رکنا بھی یہیں آتا ہے؛ انہیں حاصل کرنے کے لیے ایسے نوڈ کو کھول کر محفوظ کریں۔

کم از کم مکمل اور ناکامی کی صورت میں کو جوڑیں۔ عام طریقہ یہ ہے کہ بجٹ سے تجاوز ہو گیا، وقت ختم ہو گیا اور ناکامی کی صورت میں کو گفتگو تفویض کریں نوڈ پر بھیجا جائے تاکہ کوئی ساتھی ذمہ داری سنبھال لے۔

ایجنٹ سیشنز

ایجنٹ گفتگو رنز کے درمیان ایجنٹ کی یادداشت ہے۔ MonoChat ہر گفتگو، ہارنیس اور ٹاسک کلید کے لیے ایک فعال ایجنٹ گفتگو رکھتا ہے۔

موجودہ ایجنٹ گفتگو جاری رکھیں اسے دوبارہ استعمال کرتا ہے، اس لیے ایجنٹ وہیں سے آگے بڑھتا ہے جہاں رکا تھا۔ ہوسٹڈ ہارنیسز پر فراہم کنندہ کی اپنی گفتگو بھی جاری رہتی ہے۔
نئی ایجنٹ گفتگو شروع کریں فعال گفتگو بند کر کے نئے سرے سے آغاز کرتا ہے، مثلاً نئے موضوع کے شروع میں۔
ٹاسک کی ایک ہی گفتگو میں آزاد سیشنز کو ساتھ ساتھ رکھتی ہے۔

بلنگ

MonoChat کے فراہم کردہ AI ماڈلز پر ماڈل کالز معمول کے مطابق آپ کے بیلنس سے چارج ہوتی ہیں۔ آپ کے اپنے ماڈلز پر کالز کا بل آپ کا فراہم کنندہ بناتا ہے۔
MonoChat کا فراہم کردہ ہارنیس ہر رن، ہر منٹ اور ہر ٹول کال کی اپنی فیس، اور ہوسٹڈ ہارنیس کے لیے اس کے فراہم کنندہ کے رپورٹ کردہ ٹوکنز شامل کر سکتا ہے۔ یہ لین دین میں AI Agent Run، AI Agent Duration، AI Agent Tool Call اور AI ٹوکن کیٹیگریز کے طور پر نظر آتے ہیں۔
آپ کی اپنی اسناد سے شامل کیے گئے ہارنیس پر MonoChat کی کوئی فیس نہیں؛ اس کا فراہم کنندہ آپ کو بل کرتا ہے۔
بیلنس ناکافی ہو تو رن شروع نہیں ہوتا۔

AI ایجنٹ رن ختم ہونے کا ایونٹ

AI ایجنٹ کا رن ختم ہو گیا ایک ایونٹ نوڈ ہے۔ جب کسٹمر سے وابستہ رن ختم ہوتا ہے تو یہ فائر ہوتا ہے، چاہے رن فلو نے شروع کیا ہو یا 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 },
    },
  },
})

رن غیر ہم وقتی (asynchronous) ہے: اسے بعد میں show سے پڑھیں، یا AI ایجنٹ کا رن ختم ہو گیا ایونٹ سے اس پر ردعمل دیں۔ sessionId کے بغیر ہر کال نئی ایجنٹ گفتگو شروع کرتی ہے، جب تک آپ پچھلی کال کی واپس کی ہوئی aiAgentSessionId نہ دیں؛ تب ایجنٹ اس ایجنٹ گفتگو کے پچھلے مکمل رنز کو اپنی ہسٹری کے طور پر دیکھتا ہے۔ فنکشن سے میتھڈز کال کرنے کے لیے Method دیکھیں۔

اجازتیں

اجازت	کس چیز کی اجازت دیتی ہے
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 ایجنٹ رن ختم ہونے کا ایونٹ​

کوڈ سے ایجنٹ شروع کریں​

اجازتیں​

متعلقہ​