Ipe wakala wa LangChain zana za Instagram, TikTok na WhatsApp
Wakala wa LangChain hupata Instagram, TikTok, WhatsApp na chaneli nyingine kama zana kutoka seva ya MCP ya easyCoexistence kwenye https://easycoexistence.com/api/mcp, zikipakiwa na MCPAdapter, mteja wa MCP wa LangChain, huku FastMCP ikiendesha kuingia kwa OAuth. create_agent kisha inaweza kuchapisha na kuratibu machapisho, kujibu maoni na DM, na kusoma takwimu kupitia API rasmi ya kila mtandao, huku matukio yaliyosainiwa yakileta maoni na ujumbe mpya kwenye njia yako.
Jina la LangChain kwa nafasi yake ya majina langchain.mcp, inayohitaji langchain[mcp] 1.4.0 au mpya zaidi, na inajumuisha FastMCP.
Mahali ambapo FastMCP huhifadhi token za OAuth isipokuwa token_storage itaje backend, kwa hiyo kuanzisha upya kunamaanisha kuingia tena.
Anwani ya loopback ya seva ya muda ya callback ambayo FastMCP huanzisha kwa kuingia kwenye kivinjari, kwenye bandari huru au callback_port.
Muda wa refresh token ya easyCoexistence MCP; access token huishi saa moja, na kila kuonyesha upya hutoa jozi mpya.
Muda ambao easyCoexistence husubiri njia yako ijibu maoni au DM iliyotumwa; hutumwa mara moja tu na haijaribiwi tena.
Ni zana zipi wakala wa LangChain hupata kutoka easyCoexistence?
Zaidi ya 50, kama zana za kawaida za LangChain ambazo create_agent inaweza kuziita. Zana za mitandao ya kijamii huchukua account_id, kwa hiyo wakala huanza na list_social_accounts na kupitisha vitambulisho vyake kwa zana za kuchapisha, kusoma, kujibu maoni, kuyaficha na kusoma takwimu. Zana zinazomilikiwa na mtandao mmoja hubeba jina lake, kama publish_tiktok_post au upload_youtube_video, na nambari ya WhatsApp huanza kutoka list_numbers, ambayo hurudisha connection_id ambayo send_message na send_template huchukua. Maelezo ya kila zana yana sheria za mtandao husika, hivyo modeli hujifunza, kwa mfano, kwamba jibu la TikTok ni la umma. Kuchapisha baadaye huchukua hoja moja zaidi: scheduled_at huweka chapisho kwenye foleni ya easyCoexistence.
Wakala huingiaje kwenye easyCoexistence?
Kwa msaidizi wa OAuth wa FastMCP, ambao MCPAdapter hutumia kwa uthibitishaji. Katika mara ya kwanza, hugundua seva ya idhini ya easyCoexistence, hujisajili kama mteja, hufungua kivinjari kwenye skrini ya idhini, ambapo client_name yake inaonekana, na kupokea msimbo kwenye callback ya ndani kwenye 127.0.0.1. Baada ya hapo, access token huonyeshwa upya bila kivinjari. Token huhifadhiwa kwenye kumbukumbu isipokuwa msaidizi apate backend ya token_storage, kwa hiyo mfano huu huziweka diskini, zikisimbwa kwa ufunguo wa Fernet. Chuja orodha kabla create_agent haijaiona: zana hushikilia mteja wa MCP, hivyo wakala unaendelea kufanya kazi baada ya kizuizi cha async with kufungwa.
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)Maoni na DM hufikaje kwa wakala wa LangChain?
Kama maombi ya POST yaliyosainiwa kwenda kwenye njia yako, kwa sababu MCP hujibu tu simu ambazo wakala hufanya. Elekeza kila akaunti kwenye njia kwa set_social_webhook_destination, ukimwomba wakala mara moja au ukiiendesha kutoka Claude au ChatGPT, na uhifadhi signing_secret inayorudishwa. Instagram na Facebook husambaza maoni, kutajwa na DM, na TikTok husambaza maoni; kila tukio hubeba platform, account_id, external_id na ingizo lake la mtandao husika. Njia hukagua X-EC-Signature, hujibu papo hapo, kwa sababu easyCoexistence husubiri sekunde 8 na haijaribu tena, kisha hukabidhi tukio kwa wakala chinichini. Checkpointer yenye thread_id kwa kila mtumaji wa DM huhifadhi historia ya mazungumzo.
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}]})Kila mtandao unamruhusu wakala kufanya nini?
Kile API ya mtandao inachoruhusu akaunti, ambacho maelekezo ya wakala yanapaswa kukisema waziwazi:
- DM za Instagram na Messenger:
send_social_dmhujibu watu walioandika ndani ya saa 24 zilizopita, na Instagram hupunguza DM hadi baiti 1,000 za UTF-8. - Majibu ya maoni:
reply_to_commenthujibu hadharani, au private ikiwa true hutuma DM moja kwa kila maoni ya Instagram au Facebook ndani ya siku 7 tangu yaliandikwa. - TikTok: majibu daima ni ya umma na yanahitaji ID ya video kama
post_id, na hakuna DM kwenye TikTok. - WhatsApp:
send_messagehufanya kazi ndani ya saa 24 tangu ujumbe wa mwisho wa mteja, nasend_templateyenye kiolezo kilichoidhinishwa nje ya muda huo. - Midia: kila faili liko kwenye kiungo cha umma cha HTTPS; Instagram hupokea picha za JPEG, na machapisho ya picha ya TikTok hupokea JPEG au WebP.
Lini msimbo uite mitandao bila wakala?
Wakati hatua inapaswa kutokea kwa njia ile ile kila wakati, au bila mtu wa kuingia. get_social_credentials humpa wakala msingi wa API wa akaunti, kitambulisho chake kwenye mtandao na, kwenye TikTok, YouTube na LinkedIn, token inayofanya kazi sasa, na Partner API hurudisha vilevile kutoka GET /api/v1/channels/:id?credentials=1 kwa ufunguo wa ec_live_, hivyo kazi ya Python inaweza kuita TikTok, Google au LinkedIn moja kwa moja. Majibu yanayopaswa kutumwa wakati wowote bila wakala, kama maandishi yaliyowekwa kwa neno kuu, yanafaa kwa sheria za maoni na otomatiki, ambazo easyCoexistence huziendesha yenyewe.
Makosa ya kawaida
- Kujibu matukio yaliyosababishwa na akaunti yenyewe. Instagram hurudisha DM za akaunti kwa is_echo kuwa true na hurudisha majibu yake ya umma kama maoni, kwa hiyo yaondoe kabla wakala hajayaona, la sivyo atajijibu mwenyewe.
- Kuendesha wakala kabla njia haijajibu. easyCoexistence husubiri sekunde 8 kwa 2xx na haijaribu tena, kwa hiyo kidhibiti kinachosubiri modeli hupoteza tukio; jibu kwanza, fanya kazi chinichini.
- Kuita reply_to_comment kwa maoni ya TikTok bila post_id. Jibu la TikTok linataja video pamoja na maoni, kwa hiyo pitisha video_id ya tukio kama post_id.
- Kumpa wakala wa majibu zana za kuchapisha. Chuja orodha kwa jina kabla create_agent, ili maoni yaliyosomwa vibaya yasiweze kuchapisha chapisho, kulifuta au kubadilisha otomatiki.
easyCoexistence huwapa mawakala wako wa LangChain uwezo wa kufikia wateja kwenye WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn na chaneli nyingine nyingi, kila moja kupitia API yake rasmi: seva moja ya MCP nyuma ya kuingia kwa OAuth, matukio yaliyosainiwa ya maoni na DM, na foleni inayoweza kuchapisha hadi siku 90 mbele, huku kila muunganisho ukifuatiliwa 24/7. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na siku 3 za kwanza ni bure.
Maswali yanayoulizwa mara kwa mara
Je, wakala anahitaji programu yake ya msanidi ya Meta, TikTok au Google?
Hapana. Akaunti huunganishwa kupitia programu rasmi ya easyCoexistence kwenye kila mtandao, kwenye dashboard au kupitia kiungo cha kuunganisha cha Partner API, na wakala anazifikia zote kupitia kuingia mmoja wa easyCoexistence.
Je, wakala anaweza kupanga machapisho badala ya kuchapisha mara moja?
Ndiyo. publish_instagram_post, publish_facebook_post, publish_tiktok_post na publish_linkedin_post huchukua scheduled_at, muda wa ISO 8601 wenye saa za eneo kutoka dakika 1 hadi siku 90 mbele. YouTube hupanga yenyewe kwa upload_youtube_video na publish_at.
Ni modeli zipi zinaweza kuendesha wakala?
Modeli yoyote ya mazungumzo ambayo create_agent inaweza kutumia pamoja na zana. Zana za MCP hazitegemei modeli, na mtoa huduma wa modeli hutoza matumizi yake; easyCoexistence hutoza kwa kila muunganisho, si kwa kila wito wa zana.
easyCoexistence inagharimu kiasi gani kwa wakala wa LangChain?
Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na ni sawa kwenye kila mtandao. Seva ya MCP, matukio yaliyosambazwa na Partner API vimejumuishwa, na siku 3 za kwanza ni bure.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye