LangChain এজেন্টকে Instagram, TikTok ও WhatsApp-এর টুল দিন
LangChain এজেন্ট easyCoexistence-এর MCP সার্ভার (https://easycoexistence.com/api/mcp) থেকে WhatsApp, Instagram, TikTok ও আরও চ্যানেল টুল হিসেবে পায়। এগুলো 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-এর জন্য; পাঠানো হয় একবার, আর কখনো আবার চেষ্টা করা হয় না।
কোন টুলগুলো LangChain এজেন্ট easyCoexistence থেকে পায়?
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-এ সর্বোচ্চ 1,000 বাইট UTF-8 নেয়। - কমেন্টের উত্তর:
reply_to_commentপ্রকাশ্যে উত্তর দেয়, আর private-কে true সেট করলে Instagram বা Facebook কমেন্ট প্রতি একটি DM পাঠায়, কমেন্টের 7 দিনের মধ্যে। - TikTok: উত্তর সবসময় প্রকাশ্য হয় এবং ভিডিওর ID
post_idহিসেবে লাগে, আর TikTok-এ কোনো DM নেই। - WhatsApp: গ্রাহকের শেষ মেসেজের 24 ঘণ্টার মধ্যে
send_messageকাজ করে, আর তার বাইরে অনুমোদিত টেমপ্লেট সহ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-এর connect লিংকের মাধ্যমে, আর এজেন্ট সবগুলোতে একটি 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 পর্যবেক্ষণ
যাচাই করা হয়েছে