LangChain एजेंट को Instagram, TikTok और WhatsApp के टूल दें
LangChain एजेंट को Instagram, TikTok, WhatsApp और अन्य चैनल easyCoexistence के MCP सर्वर से टूल्स के रूप में मिलते हैं, जिसका पता https://easycoexistence.com/api/mcp है। इन्हें LangChain का MCP क्लाइंट MCPAdapter लोड करता है, और OAuth साइन-इन FastMCP चलाता है। इसके बाद create_agent पोस्ट प्रकाशित और शेड्यूल कर सकता है, कमेंट और DM का जवाब दे सकता है, और हर नेटवर्क के आधिकारिक API से इनसाइट्स पढ़ सकता है, जबकि साइन किए गए इवेंट नए कमेंट और मैसेज आपके रूट तक पहुँचाते हैं।
LangChain का langchain.mcp नेमस्पेस का लेबल, जिसके लिए langchain[mcp] 1.4.0 या उसके बाद का संस्करण चाहिए और जो FastMCP लाता है।
FastMCP OAuth टोकन कहाँ रखता है, जब तक token_storage कोई बैकएंड नहीं बताता, इसलिए रीस्टार्ट होने पर फिर से साइन इन करना होगा।
वह लूपबैक पता जिस पर FastMCP ब्राउज़र साइन-इन के लिए अस्थायी कॉलबैक सर्वर चलाता है, जो कोई खाली पोर्ट या callback_port पर होता है।
easyCoexistence MCP रिफ़्रेश टोकन कितने समय तक चलता है; एक्सेस टोकन एक घंटे तक चलते हैं, और हर रिफ़्रेश एक नई जोड़ी जारी करता है।
easyCoexistence आपके रूट के जवाब का कितनी देर इंतज़ार करता है, जो आगे भेजे गए कमेंट या DM पर एक बार भेजा जाता है और कभी दोबारा नहीं।
easyCoexistence से LangChain एजेंट को कौन से टूल मिलते हैं?
35 से ज़्यादा, सामान्य LangChain टूल्स के रूप में, जिन्हें create_agent कॉल कर सकता है। सोशल टूल्स account_id लेते हैं, इसलिए एजेंट list_social_accounts से शुरू करता है और उसके ID पोस्ट प्रकाशित करने, पढ़ने, कमेंट का जवाब देने, उन्हें छिपाने और इनसाइट्स पढ़ने वाले टूल्स को देता है। जो टूल किसी एक नेटवर्क के होते हैं, उनके नाम में वह नेटवर्क आता है, जैसे 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 DM:
send_social_dmउन लोगों को जवाब देता है जिन्होंने पिछले 24 घंटों में लिखा; Instagram एक DM को UTF-8 में 1,000 बाइट तक सीमित रखता है। - कमेंट के जवाब:
reply_to_commentसार्वजनिक रूप से जवाब देता है, या private को true करने पर हर Instagram या Facebook कमेंट पर उसके 7 दिनों के भीतर एक DM भेजता है। - TikTok: जवाब हमेशा सार्वजनिक होते हैं और
post_idके रूप में वीडियो की 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 खाते के अपने DM को is_echo true के साथ वापस भेजता है और उसके सार्वजनिक जवाब कमेंट के रूप में लौटाता है, इसलिए एजेंट के देखने से पहले उन्हें हटाएँ, वरना वह खुद को जवाब देने लगेगा।
- रूट के जवाब देने से पहले एजेंट चलाना। easyCoexistence 2xx के लिए 8 सेकंड इंतज़ार करता है और कभी दोबारा प्रयास नहीं करता, इसलिए जो हैंडलर मॉडल का इंतज़ार करता है वह इवेंट खो देता है; पहले जवाब दें, काम बैकग्राउंड में करें।
- बिना post_id के TikTok कमेंट पर 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 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित