LangChain ایجنٹ کو Instagram، TikTok اور WhatsApp کے ٹولز دیں
LangChain ایجنٹ کو easyCoexistence کے MCP سرور (https://easycoexistence.com/api/mcp) سے Instagram، TikTok، WhatsApp اور دیگر چینلز بطور ٹولز ملتے ہیں، جنہیں LangChain کا MCP کلائنٹ MCPAdapter لوڈ کرتا ہے، جبکہ FastMCP OAuth سائن اِن چلاتا ہے۔ اس کے بعد create_agent پوسٹس شائع اور شیڈول کر سکتا ہے، کمنٹس اور DM کا جواب دے سکتا ہے اور ہر نیٹ ورک کے سرکاری API کے ذریعے انسائٹس پڑھ سکتا ہے، جبکہ دستخط شدہ ایونٹس نئے کمنٹس اور میسجز آپ کے روٹ تک پہنچاتے ہیں۔
LangChain کا langchain.mcp نیم اسپیس کا لیبل، جس کے لیے langchain[mcp] 1.4.0 یا بعد کا ورژن درکار ہے اور جو FastMCP ساتھ لاتا ہے۔
FastMCP OAuth ٹوکن ایسی جگہ رکھتا ہے جب تک token_storage کوئی بیک اینڈ نام نہ دے، یعنی ری اسٹارٹ کے بعد دوبارہ سائن اِن کرنا ہوگا۔
عارضی کال بیک سرور کا loopback پتہ جو FastMCP براؤزر سائن اِن کے لیے شروع کرتا ہے، کسی آزاد پورٹ یا callback_port پر۔
easyCoexistence کے MCP ری فریش ٹوکن کی مدت، ایکسیس ٹوکن ایک گھنٹہ چلتے ہیں اور ہر ری فریش نیا جوڑا جاری کرتا ہے۔
easyCoexistence کتنی دیر تک آپ کے روٹ کے جواب کا انتظار کرتا ہے جب وہ فارورڈ کیا ہوا کمنٹ یا DM بھیجتا ہے، جو ایک بار بھیجا جاتا ہے اور دوبارہ کوشش نہیں کی جاتی۔
LangChain ایجنٹ کو easyCoexistence سے کون سے ٹولز ملتے ہیں؟
35 سے زیادہ، عام LangChain ٹولز کے طور پر جنہیں create_agent کال کر سکتا ہے۔ سوشل ٹولز account_id لیتے ہیں، اس لیے ایجنٹ list_social_accounts سے شروع کرتا ہے اور اس کے IDs کو پوسٹ پبلش کرنے، کمنٹس پڑھنے اور ان کا جواب دینے، انہیں چھپانے اور انسائٹس پڑھنے والے ٹولز کو دیتا ہے۔ جو ٹولز کسی ایک نیٹ ورک سے متعلق ہیں ان کے نام میں اس کا نام ہوتا ہے، جیسے publish_tiktok_post یا upload_youtube_video، اور WhatsApp نمبر list_numbers سے شروع ہوتا ہے، جو connection_id دیتا ہے جسے send_message اور send_template لیتے ہیں۔ ہر ٹول کی تفصیل میں اس نیٹ ورک کے اپنے قواعد ہوتے ہیں، تاکہ ماڈل سیکھے کہ مثال کے طور پر TikTok کا جواب عوامی ہوتا ہے۔ پوسٹ بعد میں شیڈول کرنے کے لیے ایک اور آرگومنٹ لگتا ہے: scheduled_at پوسٹ کو easyCoexistence کی قطار میں ڈالتا ہے۔
easyCoexistence سے ایجنٹ سائن اِن کیسے کرتا ہے؟
FastMCP کے OAuth ہیلپر سے، جسے MCPAdapter تصدیق کے لیے استعمال کرتا ہے۔ پہلی بار چلانے پر یہ easyCoexistence کا اتھارائزیشن سرور دریافت کرتا ہے، خود کو کلائنٹ کے طور پر رجسٹر کرتا ہے، براؤزر میں رضامندی کی اسکرین کھولتا ہے جہاں اس کا client_name دکھایا جاتا ہے، اور 127.0.0.1 پر مقامی کال بیک سے کوڈ وصول کرتا ہے۔ اس کے بعد ایکسیس ٹوکن براؤزر کے بغیر ریفریش ہوتے ہیں۔ ٹوکن میموری میں رہتے ہیں جب تک ہیلپر کو token_storage بیک اینڈ نہ ملے، اس لیے مثال انہیں Fernet کلید سے انکرپٹ کر کے ڈسک پر رکھتی ہے۔ create_agent دیکھنے سے پہلے فہرست فلٹر کریں: ٹولز MCP کلائنٹ کو تھامے رہتے ہیں، اس لیے async with بلاک بند ہونے کے بعد بھی ایجنٹ کام کرتا رہتا ہے۔
import os
from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter
URL = "https://easycoexistence.com/api/mcp"
# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
client_name="Acme reply agent", # shown on easyCoexistence's consent screen
callback_port=8765,
token_storage=FernetEncryptionWrapper(
key_value=DiskStore(directory="~/.easycoexistence/oauth"),
fernet=Fernet(os.environ["TOKEN_KEY"]),
),
)
REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
"hide_comment", "send_social_dm"}
RULES = (
"You reply to comments and DMs for Acme, on the account_id in the event. "
"TikTok replies are public and need the video ID as post_id. "
"Never reply to the account's own messages or replies."
)
async def build_reply_agent(model: str):
async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
return create_agent(model, tools, system_prompt=RULES)کمنٹس اور DM LangChain ایجنٹ تک کیسے پہنچتے ہیں؟
دستخط شدہ POST درخواستوں کے ذریعے آپ کے کسی روٹ تک، کیونکہ MCP صرف وہی کالز جواب دیتا ہے جو ایجنٹ کرتا ہے۔ set_social_webhook_destination سے ہر اکاؤنٹ کو روٹ سے جوڑیں، جسے ایجنٹ سے ایک بار پوچھا جائے یا Claude یا ChatGPT سے چلایا جائے، اور وہ signing_secret محفوظ رکھیں جو یہ واپس دیتا ہے۔ Instagram اور Facebook کمنٹس، مینشنز اور DM فارورڈ کرتے ہیں، اور TikTok کمنٹس فارورڈ کرتا ہے؛ ہر ایونٹ میں platform، account_id، external_id اور نیٹ ورک کی اپنی انٹری ہوتی ہے۔ روٹ X-EC-Signature چیک کرتا ہے، فوراً جواب دیتا ہے، کیونکہ easyCoexistence 8 سیکنڈ انتظار کرتا ہے اور دوبارہ کوشش نہیں کرتا، اور ایونٹ پس منظر میں ایجنٹ کو دیتا ہے۔ ہر DM بھیجنے والے کے لیے thread_id والا checkpointer گفتگو کی ہسٹری محفوظ رکھتا ہے۔
import hashlib, hmac, json, time
from fastapi import BackgroundTasks, FastAPI, HTTPException, Request
app = FastAPI() # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {} # account_id -> signing_secret, kept in your database
def signed(raw: bytes, header: str, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False
mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac.encode(), v1.encode())
@app.post("/hooks/social")
async def social_event(request: Request, background: BackgroundTasks):
raw = await request.body()
event = json.loads(raw) # platform, account_id, external_id, entry
secret = SECRETS.get(event.get("account_id", ""))
if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
raise HTTPException(status_code=401)
background.add_task(reply, event) # runs after the response is sent
return {"received": True}
async def reply(event: dict) -> None:
prompt = json.dumps(event) # the agent reads the platform, the account and the entry
await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})ہر نیٹ ورک ایجنٹ کو کیا کرنے دیتا ہے؟
نیٹ ورک کا API اکاؤنٹ کو جو کچھ کرنے دیتا ہے، جسے ایجنٹ کی ہدایات میں صاف لکھا جانا چاہیے:
- Instagram اور Messenger DMs:
send_social_dmصرف ان لوگوں کو جواب دیتا ہے جنہوں نے پچھلے 24 گھنٹوں میں لکھا ہو، اور Instagram کی DM کی حد UTF-8 میں 1,000 بائٹس ہے۔ - کمنٹ کے جواب:
reply_to_commentعوامی طور پر جواب دیتا ہے، یا private کو true سیٹ کرنے پر ہر Instagram یا Facebook کمنٹ کے 7 دن کے اندر ایک DM بھیجتا ہے۔ - TikTok: جواب ہمیشہ عوامی ہوتے ہیں اور ویڈیو کا ID بطور
post_idچاہیے، جبکہ TikTok پر DM کی سہولت نہیں ہے۔ - WhatsApp:
send_messageگاہک کے آخری میسج کے 24 گھنٹوں کے اندر کام کرتا ہے، اور منظور شدہ ٹیمپلیٹ کے ساتھsend_templateاس کے باہر کام کرتا ہے۔ - میڈیا: ہر فائل ایک عوامی HTTPS لنک پر ہوتی ہے؛ Instagram JPEG تصاویر لیتا ہے، اور TikTok فوٹو پوسٹس JPEG یا WebP لیتی ہیں۔
کوڈ ایجنٹ کے بغیر نیٹ ورکس کو کب کال کرے؟
جب کوئی قدم ہر بار ایک ہی طرح ہونا ضروری ہو، یا جب وہاں کوئی شخص سائن اِن کرنے کے لیے موجود نہ ہو۔ get_social_credentials ایجنٹ کو کسی اکاؤنٹ کا API بیس، اس کا نیٹ ورک پر ID اور، TikTok، YouTube اور LinkedIn پر، وہ ٹوکن دیتا ہے جو اسی وقت درست ہو، اور Partner API ec_live_ کلید کے ساتھ GET /api/v1/channels/:id?credentials=1 سے یہی واپس دیتا ہے، تاکہ Python جاب TikTok، Google یا LinkedIn کو براہِ راست کال کر سکے۔ ایسے جوابات جو ایجنٹ کے بغیر، کسی بھی وقت جانے ضروری ہوں، جیسے کسی کی ورڈ کے لیے مقررہ متن، کمنٹ رولز اور آٹومیشنز کے ذریعے چلتے ہیں، جنہیں easyCoexistence خود چلاتا ہے۔
عام غلطیاں
- وہ ایونٹس جن کا سبب اکاؤنٹ خود ہو، ان کا جواب دینا۔ Instagram اکاؤنٹ کے اپنے DMs کو is_echo کے true ہونے کے ساتھ واپس بھیجتا ہے اور اس کے عوامی جوابات کو کمنٹس کے طور پر لوٹاتا ہے، اس لیے انہیں ایجنٹ دیکھنے سے پہلے ہٹائیں، ورنہ وہ خود کو جواب دینے لگتا ہے۔
- روٹ جواب دینے سے پہلے ایجنٹ چلانا۔ easyCoexistence 2xx جواب کا 8 سیکنڈ انتظار کرتا ہے اور دوبارہ کوشش نہیں کرتا، اس لیے جو ہینڈلر ماڈل کا انتظار کرتا ہے وہ ایونٹ کھو دیتا ہے؛ پہلے جواب دیں، پھر پس منظر میں کام کریں۔
- TikTok کمنٹ کے لیے post_id کے بغیر reply_to_comment کال کرنا۔ TikTok کا جواب کمنٹ کے ساتھ ویڈیو کو بھی نامزد کرتا ہے، اس لیے ایونٹ کا video_id بطور post_id دیں۔
- جواب دینے والے ایجنٹ کو پبلشنگ ٹولز دینا۔ create_agent سے پہلے نام کے لحاظ سے فہرست فلٹر کریں، تاکہ کسی غلط پڑھے گئے کمنٹ سے پوسٹ شائع نہ ہو، کوئی پوسٹ حذف نہ ہو یا کوئی آٹومیشن تبدیل نہ ہو۔
easyCoexistence آپ کے LangChain ایجنٹس کو WhatsApp، Instagram، Facebook، TikTok، YouTube، LinkedIn اور دیگر چینلز پر گاہکوں تک رسائی دیتا ہے، ہر ایک اپنے سرکاری API کے ذریعے: ایک OAuth سائن اِن کے پیچھے ایک MCP سرور، دستخط شدہ کمنٹ اور DM ایونٹس، اور ایک قطار جو 90 دن آگے تک پوسٹس شیڈول کرتی ہے، جبکہ ہر کنکشن 24/7 نگرانی میں رہتا ہے۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں آپ کنکشنز بڑھاتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن مفت ہیں۔
اکثر پوچھے جانے والے سوالات
کیا ایجنٹ کو اپنی Meta، TikTok یا Google ڈویلپر ایپ کی ضرورت ہے؟
نہیں۔ اکاؤنٹس easyCoexistence کی اپنی ایپ کے ذریعے ہر نیٹ ورک پر جڑتے ہیں، ڈیش بورڈ میں یا Partner API کے کنیکٹ لنک سے، اور ایجنٹ ایک easyCoexistence سائن اِن کے ذریعے سب تک پہنچتا ہے۔
کیا ایجنٹ فوری شائع کرنے کی بجائے پوسٹس شیڈول کر سکتا ہے؟
ہاں۔ publish_instagram_post، publish_facebook_post، publish_tiktok_post اور publish_linkedin_post scheduled_at لیتے ہیں، جو ایک ISO 8601 وقت ہے جس میں ٹائم زون ہو، 1 منٹ سے 90 دن آگے تک۔ YouTube upload_youtube_video اور publish_at کے ساتھ مقامی طور پر شیڈول کرتا ہے۔
کون سے ماڈلز ایجنٹ چلا سکتے ہیں؟
کوئی بھی چیٹ ماڈل جسے create_agent ٹولز کے ساتھ استعمال کر سکتا ہے۔ MCP ٹولز ماڈل پر منحصر نہیں ہیں، اور ماڈل کا فراہم کنندہ اپنے استعمال کا بل خود بھیجتا ہے؛ easyCoexistence فی کنکشن چارج کرتا ہے، فی ٹول کال کبھی نہیں۔
LangChain ایجنٹ کے لیے easyCoexistence کتنا خرچ کرتا ہے؟
فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں آپ کنکشنز بڑھاتے ہیں قیمت کم ہوتی ہے، اور ہر نیٹ ورک پر یکساں۔ MCP سرور، فارورڈ ہونے والے ایونٹس اور Partner API شامل ہیں، اور پہلے 3 دن مفت ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ