اپنا AI ایجنٹ WhatsApp پر لائیں: ویب ہک اینڈ پوائنٹ کے ذریعے کوئی بھی فریم ورک (LangGraph، ADK، کسٹم) جوڑیں

آپ تقریباً کسی بھی AI ایجنٹ کو دوبارہ لکھے بغیر WhatsApp سے جوڑ سکتے ہیں۔ اپنا ایجنٹ، جو LangGraph، Google ADK، CrewAI یا آپ کے اپنے کوڈ سے بنا ہو، HTTPS اینڈ پوائنٹ کے پیچھے چلائیں، پھر اسے MonoChat میں کسٹم فراہم کنندہ کے ساتھ AI ہارنیس کے طور پر شامل کریں: ایک اینڈ پوائنٹ URL اور ایک مشترکہ سیکریٹ۔ فلو میں AI Agent نوڈ رکھیں، اپنا WhatsApp نمبر جوڑیں، اور آپ کا ایجنٹ WhatsApp اور MonoChat سے جڑے ہر دوسرے چینل پر کسٹمرز کو جواب دیتا ہے، مشترکہ ان باکس اور انسانی ہینڈ اوور کے ساتھ۔

یہ گائیڈ ان ٹیموں کے لیے ہے جن کے پاس پہلے سے ایجنٹ ہے، یا جو اس کے کام کرنے کے طریقے پر مکمل کنٹرول چاہتی ہیں۔ اس میں بتایا گیا ہے کہ اپنا ایجنٹ لانا کب معقول ہے، آپ کے اینڈ پوائنٹ کی ذمہ داریاں کیا ہیں، MonoChat میں سیٹ اپ، اور پروڈکشن میں اہم تفصیلات۔

اپنا ایجنٹ کیوں لائیں؟

زیادہ تر کسٹمر میسجنگ پلیٹ فارمز ایک بلٹ اِن AI ایجنٹ کے ساتھ آتے ہیں۔ یہ اس وقت تک آسان ہے جب تک:

• آپ کا ایجنٹ پہلے سے بنا ہوا ہے۔ آپ کے ڈیولپرز نے LangGraph گراف یا ADK ملٹی ایجنٹ سیٹ اپ پر مہینے لگائے، ایویلیوایشنز اور ٹیسٹس کے ساتھ۔ اسے کسی وینڈر کے بوٹ بلڈر میں دوبارہ بنانا اس کام کو ضائع کرنا ہے۔
• آپ کو اپنی منطق چاہیے۔ قیمتوں کے اصول، اہلیت کی جانچ، کمپلائنس کے مراحل یا اندرونی سسٹمز جن تک صرف آپ کا کوڈ پہنچ سکتا ہے۔
• آپ فریم ورک خود چننا چاہتے ہیں۔ فریم ورکس تیزی سے بدلتے ہیں۔ آج LangGraph ہے؛ اگلے سال کچھ اور ہو سکتا ہے۔ آپ کے چینلز اور ان باکس کو اس کے ساتھ بدلنا نہیں چاہیے۔
• ڈیٹا آپ کے پاس رہنا ضروری ہے۔ کچھ ادارے چاہتے ہیں کہ ایجنٹ کی سوچ اور ٹول کالز ان کے اپنے انفراسٹرکچر پر چلیں۔

MonoChat کا Agent Harness اسی کے لیے بنا ہے: اپنا ایجنٹ فریم ورک لائیں اور اس کے گرد سب کچھ، چینلز، ان باکس، لوگ، ایک جگہ رکھیں۔

کسٹم ہارنیس کیسے کام کرتا ہے

اسے کام کی تقسیم سمجھیں۔

MonoChat گفتگو کی پرت سنبھالتا ہے:

• WhatsApp، Instagram، Messenger، TikTok، Telegram، ویب چیٹ، SMS اور وائس کے آفیشل کنکشنز (MonoChat Meta کا آفیشل Business Partner ہے)۔
• وہ فلو جو AI Agent نوڈ کے ذریعے طے کرتا ہے کہ ایجنٹ کو کب بلایا جائے۔
• مشترکہ ٹیم ان باکس، جہاں کوئی شخص مکمل ہسٹری کے ساتھ ذمہ داری سنبھال سکتا ہے۔

آپ کا اینڈ پوائنٹ ایجنٹ سنبھالتا ہے:

• MonoChat سے گفتگو وصول کرنا۔
• آپ کا ایجنٹ چلانا: اس کی سوچ، اس کے ٹولز، اس کی میموری۔
• ایجنٹ کا جواب واپس کرنا۔

ان کے درمیان ایک مشترکہ سیکریٹ ہے، ایسی ویلیو جو دونوں فریق جانتے ہیں، تاکہ آپ کا اینڈ پوائنٹ تصدیق کر سکے کہ درخواست آپ کے MonoChat اکاؤنٹ سے آ رہی ہے۔ MonoChat وہ درست درخواست اور جواب کا فارمیٹ طے کرتا ہے جو آپ کا اینڈ پوائنٹ نافذ کرتا ہے؛ اگر وہ آپ کے پاس ابھی نہیں ہے تو ہم سے بات کریں اور ہم اسے آپ کے ڈیولپرز کے ساتھ شیئر کریں گے۔

آپ کے اینڈ پوائنٹ کو کیا کرنا چاہیے

آپ جو بھی فریم ورک استعمال کریں، پروڈکشن کے لیے تیار ایجنٹ اینڈ پوائنٹ کے چند کام ہوتے ہیں۔

ہر درخواست کی تصدیق کریں

ہر کال پر مشترکہ سیکریٹ چیک کریں اور جو میچ نہ کرے اسے مسترد کریں۔ سیکریٹ کو اپنے سیکریٹس مینیجر یا ماحولیاتی متغیرات میں رکھیں، کوڈ میں نہیں، اور اگر وہ کبھی ظاہر ہو جائے تو اسے تبدیل کر دیں۔

ہر گفتگو کو الگ رکھیں

کسٹمرز بیک وقت لکھتے ہیں۔ یقینی بنائیں کہ آپ کے ایجنٹ کی حالت، میموری اور کوئی بھی ورکنگ فائلیں ایک گفتگو تک محدود ہوں، تاکہ ایک کسٹمر کی تفصیلات کبھی دوسرے کے جواب میں نہ جا پہنچیں۔

چیٹ کے سائز کے میسجز میں جواب دیں

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

صاف ناکام ہوں، خاموشی سے نہیں

اگر کوئی ٹول ٹائم آؤٹ ہو جائے یا آپ کا ماڈل فراہم کنندہ ایرر دے تو ادھورا جواب دینے کے بجائے واضح ناکامی لوٹائیں۔ قابل پیش گوئی ناکامی فلو کو درست کام کرنے دیتی ہے، مثلاً گفتگو کسی شخص کے حوالے کر دینا۔

تیز رہیں

کسٹمرز سیکنڈوں میں جواب کی توقع کرتے ہیں۔ جہاں ممکن ہو لمبے چلنے والے کام کو جواب کے راستے سے باہر رکھیں، اور اپنے ٹولز کو تیز یا ایسنکرونس بنائیں۔

MonoChat میں مرحلہ وار

1. اپنا ایجنٹ HTTPS کے پیچھے ڈیپلائے کریں

اپنا LangGraph، ADK، CrewAI یا کسٹم ایجنٹ اپنے سرور یا کلاؤڈ پر ہوسٹ کریں، جو HTTPS پر قابل رسائی ہو۔ MonoChat کا درخواست اور جواب کا فارمیٹ اور مشترکہ سیکریٹ کی جانچ نافذ کریں۔

2. کسٹم فراہم کنندہ کے ساتھ AI ہارنیس شامل کریں

MonoChat میں AI ہارنیس شامل کریں، کسٹم منتخب کریں اور اپنا اینڈ پوائنٹ URL اور مشترکہ سیکریٹ درج کریں۔ آپ ہارنیس ایک بار شامل کرتے ہیں اور جتنے چاہیں فلوز میں استعمال کر سکتے ہیں۔

3. فلو میں AI Agent نوڈ شامل کریں

جس فلو میں آنے والی گفتگو آتی ہے اس میں AI Agent نوڈ شامل کریں اور اپنا کسٹم ہارنیس منتخب کریں۔ اس کے گرد کے فلو کو اس کام کے لیے استعمال کریں جس میں فلوز بہترین ہیں: خوش آمدید، زبان یا موضوع کے مطابق روٹنگ، کام کے اوقات، اور کسی شخص تک راستہ۔

4. ہر رن کے لیے بجٹ طے کریں

ہر AI Agent نوڈ ہر رن کے لیے بجٹ کی حدیں سپورٹ کرتا ہے۔ انہیں ان حدوں کے ساتھ حفاظتی جال کے طور پر استعمال کریں جو آپ اپنے کوڈ میں پہلے ہی نافذ کرتے ہیں۔

5. WhatsApp اور دیگر چینلز جوڑیں

اپنا WhatsApp Business نمبر جوڑیں، پھر وہی فلو اپنے دیگر چینلز سے جوڑیں۔ ہر چینل کے لیے اضافی انٹیگریشن کا کوئی کام نہیں: آپ کا اینڈ پوائنٹ گفتگو دیکھتا ہے، چینل APIs نہیں۔

6. ٹیسٹ کریں، پھر لائیو کریں

حقیقی کسٹمر میسجز کو فلو سے دوبارہ گزاریں۔ ٹول کالز، جواب کے وقت، لہجہ اور ہینڈ اوور چیک کریں۔ لائیو ٹریفک کے پہلے دنوں پر گہری نظر رکھیں، پھر ایجنٹ کو جو کرنے کی اجازت ہے اسے وسیع کریں۔

فریم ورک کے نوٹس

LangGraph۔ نوڈز اور ایجز کا گراف سپورٹ کے سفر (ٹرائیج، لک اپ، حل، ایسکلیشن) کے لیے فطری طور پر موزوں ہے۔ کمپائل شدہ گراف کو چھوٹی HTTP سروس میں لپیٹیں، ہر درخواست پر گفتگو کی حالت لوڈ کریں اور آخری میسج واپس کریں۔

Google ADK۔ ADK کے ملٹی ایجنٹ ٹری، یعنی کوآرڈینیٹر کے ساتھ ماہر سب ایجنٹس، سپورٹ، سیلز اور بلنگ ٹیموں سے اچھی طرح ملتے ہیں۔ روٹ ایجنٹ کو اپنے اینڈ پوائنٹ کے ذریعے ایکسپوز کریں اور ADK کو اندرونی روٹنگ کرنے دیں۔

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

آپ کا اپنا کوڈ۔ ماڈل API اور چند فنکشنز کے ساتھ سادہ لوپ اکثر کافی ہوتا ہے۔ آپ کے پاس مکمل کنٹرول رہتا ہے، اور MonoChat آپ کو چینلز اور ان باکس دیتا ہے۔

ہینڈ اوور: اسے فلو میں طے کریں

فلو میں طے کریں کہ کون سی گفتگو کسی شخص کے پاس جاتی ہے اور کون سی ٹیم اسے وصول کرتی ہے، اور اپنا ایجنٹ ایسے لکھیں کہ جب وہ مدد نہ کر سکے تو اندازے لگانے کے بجائے کسٹمر کو دیانتداری سے بتا دے۔ فلو پھر گفتگو کو مکمل ہسٹری کے ساتھ مشترکہ ان باکس میں درست ٹیم کے حوالے کر دیتا ہے۔ WhatsApp کی Business Messaging Policy بھی توقع کرتی ہے کہ خودکار جوابات انسان تک واضح راستہ دیں۔

اپنے ایجنٹ کو اپنے کاروبار کے اندر بھی رکھیں۔ 15 جنوری 2026 سے WhatsApp عمومی مقصد کے AI اسسٹنٹس کو پلیٹ فارم سے باہر رکھتا ہے؛ جو ایجنٹس آپ کے اپنے کسٹمرز کی خدمت کریں وہ ٹھیک ہیں۔ ہماری WhatsApp AI چیٹ بوٹ پالیسی گائیڈ اس اصول کی وضاحت کرتی ہے۔

اپنا ایجنٹ کب نہ بنائیں

کسٹم ایجنٹ سب سے لچکدار آپشن ہے اور وہی ہے جسے آپ خود برقرار رکھتے ہیں۔ اگر آپ شروع سے آغاز کر رہے ہیں تو بلٹ اِن آپشن آپ کو زیادہ تیزی سے لائیو کر دیتا ہے اور کچھ ہوسٹ نہیں کرنا پڑتا:

• MonoChat کا بلٹ اِن ہارنیس آپ کے MonoChat AI ماڈلز پر۔
• OpenAI Agents SDK، MonoChat کے اندر چلتا ہے (گائیڈ)۔
• Claude Agent SDK یا Pi، MonoChat کے ایجنٹ رنر پر چلتے ہیں (Claude گائیڈ)۔
• ہوسٹڈ ایجنٹس: OpenAI Agents API یا Claude Managed Agents، آپ کی اپنی کلید کے ساتھ۔

چونکہ ہر آپشن وہی AI Agent نوڈ استعمال کرتا ہے، آپ ایک سے شروع کر کے بعد میں اپنے ایجنٹ پر جا سکتے ہیں، اپنے چینلز یا ہینڈ اوور کو چھوئے بغیر۔ ان کا موازنہ Agent Harness کے صفحے پر کریں۔