LangChain ایجنٹ کو WhatsApp نمبر دیں

LangChain ایجنٹ WhatsApp کے ٹولز کیسے لوڈ کرتا ہے؟

MCPAdapter کے ذریعے، جو LangChain کا MCP کلائنٹ ہے اور کسی MCP سرور کے ٹولز کو عام LangChain ٹولز کی طرح create_agent کو دیتا ہے۔ اس کے لیے langchain[mcp] کا ورژن 1.4.0 یا اس سے نیا چاہیے اور یہ بیٹا ہے۔

تصدیق FastMCP کے سپرد ہے۔ کلائنٹ پر auth="oauth" دینے سے مکمل OAuth 2.1 فلو چلتا ہے: ڈسکوری، ڈائنامک کلائنٹ رجسٹریشن، براؤزر ری ڈائریکٹ اور ٹوکن ایکسچینج۔ EasyCoexistence کا MCP سرور یہی چاہتا ہے، اس لیے کوئی کلید بنانے یا پیسٹ کرنے کی ضرورت نہیں۔ ڈیفالٹ طور پر ٹوکن میموری میں رہتے ہیں اور ہر رن میں براؤزر والا مرحلہ دہرانا پڑتا ہے؛ ٹوکن اسٹور والا FastMCP OAuth پرووائیڈر انہیں رنز کے درمیان محفوظ رکھتا ہے۔

لوڈ ہونے کے بعد ایجنٹ کو ٹولز ان کی تفصیل کے ساتھ نظر آتے ہیں: پہلے list_numbers، کیونکہ باقی ہر ٹول اسی سے connection_id لیتا ہے، پھر send_message، send_template، list_templates، get_number_health اور باقی ٹولز۔

from fastmcp.client import Client
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

async def build_agent(model: str):
    async with MCPAdapter(Client(URL, auth="oauth")) as adapter:
        tools = await adapter.list_tools()
        return create_agent(model, tools)

آنے والا WhatsApp میسج ایجنٹ تک کیسے پہنچتا ہے؟

ویب ہک کے ذریعے، کیونکہ MCP یہ نہیں کر سکتا۔ پروٹوکول درخواست اور جواب پر چلتا ہے، اس لیے جب کوئی کسٹمر لکھتا ہے تو سرور کلائنٹ کو جگا نہیں سکتا۔

نمبر کی ویب ہک منزل اپنی ایپلیکیشن کے کسی روٹ پر رکھیں اور URL پاتھ میں لمبا بے ترتیب سیکرٹ شامل کریں۔ روٹ Meta کی تصدیق والی GET کا جواب خام چیلنج سے دیتا ہے، ہر POST قبول کرتا ہے، فوراً 200 لوٹاتا ہے اور کام قطار میں لگا دیتا ہے۔ پھر ایک ورکر پے لوڈ سے بھیجنے والے کا نمبر اور متن لے کر ایجنٹ کو چلاتا ہے۔ بھیجنے والے کا نمبر ہی تھریڈ آئی ڈی بنتا ہے تاکہ میموری ہر کسٹمر کی الگ رہے۔

سیکرٹ کی جانچ URL میں کریں، X-Hub-Signature-256 ہیڈر پر نہیں۔ Meta اس Tech Provider کے ایپ سیکرٹ سے سائن کرتا ہے جو کبھی شیئر نہیں ہوتا، اس لیے کسٹمر وہ ہیڈر ویلیڈیٹ نہیں کر سکتا۔

ایجنٹ کو MCP سے بھیجنا چاہیے یا Cloud API سے؟

دونوں کام کرتے ہیں، اور فرق یہ ہے کہ اصول کس کے پاس ہیں۔ MCP ٹولز اپنی تفصیل میں WhatsApp کے اصول رکھتے ہیں، جیسے send_message صرف 24 گھنٹے کی ونڈو کے اندر چلتا ہے اور send_template اس شخص تک پہنچنے کا راستہ ہے جس نے لکھا نہ ہو۔ ان تفصیلات کو پڑھ کر ماڈل زیادہ تر درست ٹول چنتا ہے، اور جہاں ایجنٹ آزادانہ فیصلہ کرتا ہے وہاں یہی کام آتا ہے۔

جب ایجنٹ کا کام محدود ہو، مثلاً ہمیشہ اسی کو جواب دینا جس نے ابھی لکھا ہے، تو اپنا سادہ ٹول زیادہ آسان رہتا ہے جو نمبر کے ٹوکن کے ساتھ Cloud API کے messages اینڈ پوائنٹ پر پوسٹ کرے۔ تب ونڈو کی جانچ آپ کے اپنے کوڈ میں ہوتی ہے، اور جس اصول کا ٹوٹنا ناقابلِ قبول ہو اس کی جگہ وہی ہے۔ ونڈو کے باہر آزاد متن بھیجیں تو ایرر کوڈ 131047 آتا ہے اور کسٹمر کو کچھ نظر نہیں آتا۔

عام غلطیاں

• MCP سے آنے والے میسج ملنے کی توقع رکھنا۔ ویب ہک روٹ کے بغیر ایجنٹ کو کسٹمر کی کوئی خبر نہیں ملتی۔
• OAuth ٹوکن سرور پر میموری میں چھوڑ دینا۔ ہر ری اسٹارٹ پر براؤزر سائن ان مانگا جاتا ہے؛ ٹوکن اسٹور سے انہیں محفوظ رکھیں۔
• تمام کسٹمرز کے لیے ایک ہی تھریڈ استعمال کرنا۔ ایجنٹ کی میموری بھیجنے والے کے نمبر پر رکھیں۔

اکثر پوچھے جانے والے سوالات

مزید پڑھیں