Anna LangChain-agentille Instagram-, TikTok- ja WhatsApp-työkalut
LangChain-agentti saa Instagramin, TikTokin, WhatsAppin ja muut kanavat työkaluina easyCoexistencen MCP-palvelimelta osoitteesta https://easycoexistence.com/api/mcp. Työkalut ladataan LangChainin MCP-asiakkaalla, MCPAdapterilla, ja FastMCP hoitaa OAuth-kirjautumisen. create_agent voi sitten julkaista ja ajastaa julkaisuja, vastata kommentteihin ja DM-viesteihin sekä lukea tilastot kunkin verkoston virallisen API:n kautta, kun allekirjoitetut tapahtumat tuovat uudet kommentit ja viestit reittiisi.
LangChainin nimi sen langchain.mcp-nimiavaruudelle, joka vaatii langchain[mcp]-paketin version 1.4.0 tai uudemman ja tuo mukanaan FastMCP:n.
Paikka, jossa FastMCP säilyttää OAuth-tokenit, ellei token_storage nimeä taustajärjestelmää; uudelleenkäynnistyksen jälkeen on kirjauduttava uudelleen.
Väliaikaisen takaisinkutsupalvelimen loopback-osoite, jonka FastMCP käynnistää selainkirjautumista varten; portti on vapaa tai callback_port.
Kuinka kauan easyCoexistencen MCP-päivitystunnus on voimassa; käyttötunnukset ovat voimassa tunnin ja jokainen päivitys antaa uuden parin.
Kuinka kauan easyCoexistence odottaa, että reittisi vastaa välitettyyn kommenttiin tai viestiin; tapahtuma lähetetään kerran eikä sitä yritetä uudelleen.
Mitä työkaluja LangChain-agentti saa easyCoexistencelta?
Yli 50, tavallisina LangChain-työkaluina, joita create_agent voi kutsua. Sosiaalisten työkalujen parametrina on account_id, joten agentti aloittaa list_social_accounts-kutsulla ja välittää saamansa tunnisteet julkaisuun, lukemiseen, kommenttiin vastaamiseen, piilottamiseen ja tilastojen lukemiseen. Yhden verkoston työkalut kantavat sen nimeä, kuten publish_tiktok_post tai upload_youtube_video, ja WhatsApp-numero alkaa list_numbers-kutsulla, joka palauttaa connection_id:n, jota send_message ja send_template käyttävät. Jokaisen työkalun kuvaus sisältää verkoston omat säännöt, joten malli oppii esimerkiksi, että TikTok-vastaus on julkinen. Julkaisun ajastaminen vaatii yhden lisäargumentin: scheduled_at asettaa julkaisun easyCoexistencen jonoon.
Miten agentti kirjautuu easyCoexistenceen?
FastMCP:n OAuth-apuvälineellä, jota MCPAdapter käyttää todennukseen. Ensimmäisellä kerralla agentti löytää easyCoexistencen valtuutuspalvelimen, rekisteröityy asiakkaaksi, avaa selaimen suostumusnäkymään, jossa näkyy sen client_name, ja vastaanottaa koodin paikalliselta takaisinkutsulta osoitteessa 127.0.0.1. Sen jälkeen käyttötunnukset uusiutuvat ilman selainta. Tunnukset ovat muistissa, ellei apuvälineelle anneta token_storage-taustajärjestelmää, joten esimerkki tallentaa ne levylle Fernet-avaimella salattuina. Suodata työkaluluettelo ennen kuin create_agent näkee sen: työkalut pitävät MCP-asiakasta hallussaan, joten agentti toimii edelleen async with -lohkon päättymisen jälkeen.
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)Miten kommentit ja DM-viestit tavoittavat LangChain-agentin?
Allekirjoituina POST-pyyntöinä reittiisi, koska MCP vastaa vain agentin tekemiin kutsuihin. Ohjaa jokainen tili reitille set_social_webhook_destination-kutsulla, jonka voit pyytää agentilta kerran tai ajaa Claudesta tai ChatGPT:stä, ja säilytä palauttamasi signing_secret. Instagram ja Facebook välittävät kommentit, maininnat ja DM-viestit, ja TikTok välittää kommentit; jokainen tapahtuma sisältää platform-, account_id- ja external_id-kentät sekä verkoston oman merkinnän. Reitti tarkistaa X-EC-Signature-otsakkeen, vastaa välittömästi, koska easyCoexistence odottaa 8 sekuntia eikä yritä uudelleen, ja antaa tapahtuman agentille taustalla. Checkpointer, jolla on thread_id jokaista DM-lähettäjää kohti, säilyttää keskustelun historian.
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}]})Mitä kukin verkosto sallii agentille?
Sen, minkä verkoston API sallii tilille. Agentin ohjeissa tämä kannattaa sanoa suoraan:
- Instagramin ja Messengerin DM:t:
send_social_dmvastaa ihmisille, jotka kirjoittivat viimeisen 24 tunnin aikana, ja Instagram rajoittaa DM:n 1 000 tavuun UTF-8-koodauksella. - Kommenttivastaukset:
reply_to_commentvastaa julkisesti, ja kun private on true, se lähettää yhden DM:n Instagram- tai Facebook-kommenttia kohden kommentista 7 päivän sisällä. - TikTok: vastaukset ovat aina julkisia ja vaativat videon tunnisteen
post_id-kenttään, eikä TikTokissa ole DM:iä. - WhatsApp:
send_messagetoimii 24 tunnin sisällä asiakkaan viimeisimmästä viestistä, jasend_templatehyväksytyllä viestipohjalla sen ulkopuolella. - Media: jokainen tiedosto on julkisessa HTTPS-linkissä; Instagram hyväksyy JPEG-kuvat ja TikTok-valokuvajulkaisut JPEG- tai WebP-muodossa.
Milloin koodin pitää kutsua verkostoja ilman agenttia?
Kun vaihe täytyy tehdä aina samalla tavalla tai kun kukaan ei ole paikalla kirjautumassa. get_social_credentials antaa agentille tilin API-perusosoitteen, sen tunnisteen verkostossa ja TikTokissa, YouTubessa ja LinkedInissä voimassa olevan tunnuksen, ja Partner API palauttaa saman pyynnöstä GET /api/v1/channels/:id?credentials=1 ec_live_-avaimella, joten Python-ajo voi kutsua TikTokia, Googlea tai LinkedIniä suoraan. Vastaukset, jotka täytyy lähettää mihin aikaan tahansa ilman agenttia, kuten kiinteä teksti avainsanalle, sopivat kommenttisääntöihin ja automaatioihin, jotka easyCoexistence ajaa itse.
Yleiset virheet
- Vastaaminen tapahtumiin, jotka tili itse aiheutti. Instagram palauttaa tilin omat DM:t kaikuna, jonka is_echo on true, ja julkiset vastauksensa kommentteina, joten suodata ne pois ennen kuin agentti näkee ne, muuten agentti vastaa itselleen.
- Agentin ajaminen ennen kuin reitti vastaa. easyCoexistence odottaa 8 sekuntia 2xx-vastausta eikä yritä uudelleen, joten käsittelijä, joka odottaa mallia, menettää tapahtuman. Vastaa ensin ja työskentele taustalla.
- reply_to_comment-kutsu TikTok-kommenttiin ilman post_id-kenttää. TikTokin vastaus nimeää videon kommentin lisäksi, joten välitä tapahtuman video_id post_id-kenttään.
- Vastausagentille annetaan julkaisutyökalut. Suodata lista nimen perusteella ennen create_agent-kutsua, jotta väärin luettu kommentti ei voi julkaista julkaisua, poistaa sitä tai muuttaa automaatiota.
easyCoexistence antaa LangChain-agenteillesi yhteyden asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa, kunkin virallisen API:n kautta: yksi MCP-palvelin OAuth-kirjautumisen takana, allekirjoitetut kommentti- ja DM-tapahtumat sekä jono, joka julkaisee jopa 90 päivää etukäteen, ja jokainen yhteys valvotaan ympäri vuorokauden. US$ 9–US$ 0,75 per yhteys kuukaudessa, ja hinta laskee, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Tarvitseeko agentti oman Meta-, TikTok- tai Google-kehitysappinsa?
Ei. Tilit yhdistetään easyCoexistencen omalla sovelluksella kussakin verkostossa hallintapaneelissa tai Partner API -yhteyslinkin kautta, ja agentti tavoittaa ne kaikki yhden easyCoexistence-kirjautumisen kautta.
Voiko agentti ajastaa julkaisuja sen sijaan, että julkaisee heti?
Kyllä. publish_instagram_post, publish_facebook_post, publish_tiktok_post ja publish_linkedin_post ottavat parametrin scheduled_at, ISO 8601 -muotoisen ajan aikavyöhykkeellä, 1 minuutista 90 päivään eteenpäin. YouTube ajastaa suoraan upload_youtube_video-työkalulla ja publish_at-kentällä.
Mitkä mallit voivat ajaa agenttia?
Mikä tahansa chat-malli, jonka create_agent voi käyttää työkalujen kanssa. MCP-työkalut eivät riipu mallista, ja mallin palveluntarjoaja laskuttaa oman käyttönsä; easyCoexistence veloittaa yhteyksittäin, ei työkalukutsuittain.
Paljonko easyCoexistence maksaa LangChain-agentille?
US$ 9–US$ 0,75 per yhteys kuukaudessa, ja hinta laskee yhteyksien lisääntyessä. Sama hinta jokaisessa verkostossa. MCP-palvelin, välitetyt tapahtumat ja Partner API sisältyvät, ja ensimmäiset 3 päivää ovat ilmaisia.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu