LangChain ఏజెంట్కు Instagram, TikTok, WhatsApp టూల్స్ ఇవ్వండి
LangChain ఏజెంట్కు Instagram, TikTok, WhatsApp మరియు మరిన్ని ఛానెళ్లు easyCoexistence యొక్క MCP సర్వర్ నుండి https://easycoexistence.com/api/mcp వద్ద టూల్స్గా అందుతాయి. ఇవి LangChain యొక్క MCP క్లయింట్ అయిన MCPAdapter ద్వారా లోడ్ అవుతాయి, OAuth సైన్-ఇన్ను FastMCP నిర్వహిస్తుంది. ఆ తర్వాత create_agent ప్రతి నెట్వర్క్ యొక్క అధికారిక API ద్వారా పోస్ట్లను పబ్లిష్ చేయగలదు, షెడ్యూల్ చేయగలదు, కామెంట్లకు మరియు DMలకు రిప్లై ఇవ్వగలదు, ఇన్సైట్స్ చదవగలదు, అయితే సైన్ చేసిన ఈవెంట్లు కొత్త కామెంట్లు మరియు మెసేజ్లను మీ రూట్కు తీసుకువస్తాయి.
LangChain తన langchain.mcp నేమ్స్పేస్ కోసం ఇచ్చిన లేబుల్; దీనికి langchain[mcp] 1.4.0 లేదా ఆ తర్వాతి వెర్షన్ అవసరం, మరియు ఇది FastMCP ను కూడా తీసుకువస్తుంది.
token_storage బ్యాకెండ్ను పేర్కొనకపోతే FastMCP OAuth టోకెన్లను మెమరీలో ఉంచుతుంది; అంటే రీస్టార్ట్ అయితే మళ్లీ సైన్ ఇన్ చేయాలి.
బ్రౌజర్ సైన్-ఇన్ కోసం FastMCP ప్రారంభించే తాత్కాలిక కాల్బ్యాక్ సర్వర్ యొక్క లూప్బ్యాక్ చిరునామా; ఇది ఖాళీగా ఉన్న పోర్ట్లో లేదా callback_port లో ఉంటుంది.
easyCoexistence MCP రిఫ్రెష్ టోకెన్ ఎంతకాలం చెల్లుతుందో; యాక్సెస్ టోకెన్లు ఒక గంట చెల్లుతాయి, ప్రతి రిఫ్రెష్కు కొత్త జత జారీ అవుతుంది.
మీ రూట్ ఫార్వర్డ్ చేసిన కామెంట్ లేదా DMకు స్పందించేందుకు easyCoexistence ఎంతసేపు వేచి ఉంటుందో; ఒకసారి మాత్రమే పంపుతుంది, ఎప్పుడూ మళ్లీ ప్రయత్నించదు.
LangChain ఏజెంట్కు easyCoexistence నుండి ఏ టూల్స్ అందుతాయి?
create_agent కాల్ చేయగల సాధారణ LangChain టూల్స్గా 50కి పైగా అందుతాయి. సోషల్ టూల్స్ account_id ను తీసుకుంటాయి, కాబట్టి ఏజెంట్ ముందుగా list_social_accounts తో మొదలుపెట్టి, దాని IDలను పబ్లిష్, చదవడం, కామెంట్లకు రిప్లై, వాటిని దాచడం మరియు ఇన్సైట్స్ కోసం పంపుతుంది. publish_tiktok_post లేదా upload_youtube_video వంటి ఒక నెట్వర్క్కు చెందిన టూల్స్ ఆ నెట్వర్క్ పేరును కలిగి ఉంటాయి; WhatsApp నంబర్ list_numbers తో మొదలవుతుంది, ఇది send_message మరియు send_template తీసుకునే connection_id ను ఇస్తుంది. ప్రతి టూల్ వివరణలో ఆ నెట్వర్క్ యొక్క స్వంత నియమాలు ఉంటాయి, కాబట్టి ఉదాహరణకు TikTok రిప్లై ఎల్లప్పుడూ బహిరంగంగానే ఉంటుందని మోడల్ తెలుసుకుంటుంది. పోస్ట్ చేయడానికి మరో ఆర్గ్యుమెంట్ అవసరం: scheduled_at పోస్ట్ను easyCoexistence క్యూలో ఉంచుతుంది.
ఏజెంట్ easyCoexistence లో ఎలా సైన్ ఇన్ అవుతుంది?
MCPAdapter ప్రామాణీకరణకు ఉపయోగించే FastMCP యొక్క OAuth సహాయకంతో. మొదటి రన్లో అది 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 గా సెట్ చేస్తే, కామెంట్ వచ్చిన 7 రోజుల్లోపు, ప్రతి Instagram లేదా Facebook కామెంట్కు ఒక 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 ఖాతా యొక్క స్వంత DMలను 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 ను తీసుకుంటాయి; ఇది 1 నిమిషం నుండి 90 రోజుల వరకు ముందుగా ఉండే టైమ్జోన్తో కూడిన ISO 8601 సమయం. 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 పర్యవేక్షణ
ధృవీకరించిన తేదీ