Δώστε σε έναν agent του LangChain εργαλεία για Instagram, TikTok και WhatsApp
Ένας agent του LangChain αποκτά Instagram, TikTok, WhatsApp και άλλα κανάλια ως εργαλεία από τον MCP server του easyCoexistence στη διεύθυνση https://easycoexistence.com/api/mcp, φορτωμένα από το MCPAdapter, τον MCP client του LangChain, ενώ το FastMCP εκτελεί τη σύνδεση μέσω OAuth. Το create_agent μπορεί έπειτα να δημοσιεύει και να προγραμματίζει αναρτήσεις, να απαντά σε σχόλια και DM και να διαβάζει insights μέσω του επίσημου API κάθε δικτύου, ενώ τα υπογεγραμμένα events φέρνουν νέα σχόλια και μηνύματα στη διαδρομή σας.
Η ετικέτα του LangChain για το namespace langchain.mcp του, το οποίο απαιτεί langchain[mcp] 1.4.0 ή νεότερο και φέρνει μαζί του το FastMCP.
Εκεί όπου το FastMCP κρατά τα OAuth tokens, εκτός αν το token_storage ορίζει backend, οπότε μια επανεκκίνηση σημαίνει νέα σύνδεση.
Η διεύθυνση loopback του προσωρινού callback server που ξεκινά το FastMCP για τη σύνδεση στον browser, σε μια ελεύθερη θύρα ή στο callback_port.
Η διάρκεια ενός refresh token του MCP του easyCoexistence· τα access tokens ισχύουν μία ώρα και κάθε ανανέωση εκδίδει νέο ζεύγος.
Η αναμονή του easyCoexistence για να απαντήσει η διαδρομή σας σε ένα προωθημένο σχόλιο ή DM· στέλνεται μία φορά και δεν επαναλαμβάνεται ποτέ.
Ποια εργαλεία παίρνει ένας agent του LangChain από το easyCoexistence;
Περισσότερα από 50, ως συνηθισμένα εργαλεία του LangChain που μπορεί να καλέσει το create_agent. Τα εργαλεία των social δικτύων παίρνουν ένα account_id, οπότε ο agent ξεκινά με το list_social_accounts και περνά τα IDs του στα εργαλεία για δημοσίευση, ανάγνωση και απάντηση σε σχόλια, απόκρυψή τους και ανάγνωση insights. Τα εργαλεία που ανήκουν σε ένα δίκτυο φέρουν το όνομά του, όπως το publish_tiktok_post ή το upload_youtube_video, ενώ ένας αριθμός WhatsApp ξεκινά από το list_numbers, το οποίο επιστρέφει το connection_id που δέχονται τα send_message και send_template. Η περιγραφή κάθε εργαλείου φέρει τους δικούς του κανόνες του δικτύου, ώστε το μοντέλο να μαθαίνει, για παράδειγμα, ότι μια απάντηση στο TikTok είναι δημόσια. Η ανάρτηση αργότερα θέλει ένα ακόμη όρισμα: το scheduled_at βάζει την ανάρτηση στην ουρά του easyCoexistence.
Πώς συνδέεται ο agent στο easyCoexistence;
Με τον βοηθητικό μηχανισμό OAuth του FastMCP, τον οποίο χρησιμοποιεί το MCPAdapter για την πιστοποίηση. Στην πρώτη εκτέλεση ανακαλύπτει τον διακομιστή εξουσιοδότησης του easyCoexistence, καταχωρεί τον εαυτό του ως client, ανοίγει τον browser στην οθόνη συναίνεσης, όπου φαίνεται το client_name του, και λαμβάνει τον κωδικό σε τοπικό callback στη διεύθυνση 127.0.0.1. Μετά από αυτό, τα access tokens ανανεώνονται χωρίς browser. Τα tokens μένουν στη μνήμη, εκτός αν ο βοηθητικός μηχανισμός πάρει ένα backend token_storage, οπότε το παράδειγμα τα κρατά στον δίσκο, κρυπτογραφημένα με ένα κλειδί Fernet. Φιλτράρετε τη λίστα πριν τη δει το create_agent: τα εργαλεία κρατούν τον MCP client, άρα ο agent συνεχίζει να λειτουργεί αφού κλείσει το μπλοκ 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 σε έναν agent του LangChain;
Ως υπογεγραμμένα αιτήματα POST σε μια δική σας διαδρομή, επειδή το MCP απαντά μόνο στις κλήσεις που κάνει ο agent. Συνδέστε κάθε λογαριασμό με τη διαδρομή μέσω του set_social_webhook_destination, που ζητά ο agent μία φορά ή εκτελείται από το Claude ή το ChatGPT, και κρατήστε το signing_secret που επιστρέφει. Το Instagram και το Facebook προωθούν σχόλια, αναφορές και DM, και το TikTok προωθεί σχόλια· κάθε event φέρει το platform, το account_id, το external_id και τη δική του καταχώρηση του δικτύου. Η διαδρομή ελέγχει το X-EC-Signature, απαντά αμέσως, καθώς το easyCoexistence περιμένει 8 δευτερόλεπτα και δεν επαναλαμβάνει, και παραδίδει το event στον agent στο παρασκήνιο. Ένας checkpointer με thread_id για κάθε αποστολέα DM κρατά το ιστορικό της συνομιλίας.
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}]})Τι επιτρέπει κάθε δίκτυο στον agent;
Όσα επιτρέπει το API του δικτύου στον λογαριασμό, κάτι που οι οδηγίες του agent πρέπει να δηλώνουν ξεκάθαρα:
- Instagram και DM στο Messenger: το
send_social_dmαπαντά σε άτομα που έγραψαν τις τελευταίες 24 ώρες, και το Instagram περιορίζει ένα DM σε 1.000 bytes UTF-8. - Απαντήσεις σε σχόλια: το
reply_to_commentαπαντά δημόσια, ή με private ορισμένο σε true στέλνει ένα DM ανά σχόλιο στο Instagram ή στο Facebook, εντός 7 ημερών από αυτό. - TikTok: οι απαντήσεις είναι πάντα δημόσιες και θέλουν το ID του βίντεο ως
post_id, και στο TikTok δεν υπάρχουν DM. - WhatsApp: το
send_messageλειτουργεί εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη, και τοsend_templateμε εγκεκριμένο πρότυπο εκτός αυτού του παραθύρου. - Πολυμέσα: κάθε αρχείο βρίσκεται σε δημόσιο σύνδεσμο HTTPS· το Instagram δέχεται εικόνες JPEG, και οι φωτογραφικές αναρτήσεις του TikTok δέχονται JPEG ή WebP.
Πότε πρέπει ο κώδικας να καλεί τα δίκτυα χωρίς τον agent;
Όταν ένα βήμα πρέπει να γίνεται πάντα με τον ίδιο τρόπο, ή όταν δεν υπάρχει κάποιος να συνδεθεί. Το get_social_credentials δίνει στον agent τη βάση του API ενός λογαριασμού, το ID του στο δίκτυο και, στο TikTok, στο YouTube και στο LinkedIn, ένα token που ισχύει τώρα, και το Partner API επιστρέφει το ίδιο από το GET /api/v1/channels/:id?credentials=1 με ένα κλειδί ec_live_, ώστε μια εργασία Python να καλεί απευθείας τα TikTok, Google ή LinkedIn. Απαντήσεις που πρέπει να φεύγουν οποτεδήποτε χωρίς τον agent, όπως σταθερό κείμενο για μια λέξη-κλειδί, ταιριάζουν στους κανόνες σχολίων και στους αυτοματισμούς, τους οποίους εκτελεί το ίδιο το easyCoexistence.
Συνηθισμένα λάθη
- Απάντηση σε events που προκάλεσε ο ίδιος ο λογαριασμός. Το Instagram επαναλαμβάνει τα δικά του DM με is_echo ίσο με true και επιστρέφει τις δημόσιες απαντήσεις του ως σχόλια, οπότε αφαιρέστε τα πριν τα δει ο agent, αλλιώς απαντά στον εαυτό του.
- Εκτέλεση του agent πριν απαντήσει η διαδρομή. Το easyCoexistence περιμένει 8 δευτερόλεπτα για ένα 2xx και δεν επαναλαμβάνει ποτέ, οπότε ένας χειριστής που περιμένει το μοντέλο χάνει το event· απαντήστε πρώτα και δουλέψτε στο παρασκήνιο.
- Κλήση του reply_to_comment για σχόλιο TikTok χωρίς post_id. Η απάντηση στο TikTok ονομάζει το βίντεο καθώς και το σχόλιο, οπότε περάστε το video_id του event ως post_id.
- Δίνοντας σε έναν agent απαντήσεων τα εργαλεία δημοσίευσης. Φιλτράρετε τη λίστα κατά όνομα πριν τη δει το create_agent, ώστε ένα λανθασμένα διαβασμένο σχόλιο να μην μπορεί να δημοσιεύσει μία ανάρτηση, να διαγράψει μία ή να αλλάξει έναν αυτοματισμό.
Το easyCoexistence δίνει στους agents του LangChain πρόσβαση σε πελάτες στο WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλια, το καθένα μέσω του επίσημου API του: έναν MCP server πίσω από μία σύνδεση OAuth, υπογεγραμμένα events σχολίων και DM, και μια ουρά που προγραμματίζει αναρτήσεις έως 90 ημέρες μπροστά, με παρακολούθηση κάθε σύνδεσης 24/7. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Χρειάζεται ο agent δική του developer εφαρμογή για Meta, TikTok ή Google;
Όχι. Οι λογαριασμοί συνδέονται μέσω της δικής της εφαρμογής του easyCoexistence σε κάθε δίκτυο, στον πίνακα ελέγχου ή μέσω συνδέσμου σύνδεσης του Partner API, και ο agent φτάνει σε όλους μέσω μίας σύνδεσης easyCoexistence.
Μπορεί ο agent να προγραμματίζει αναρτήσεις αντί να δημοσιεύει αμέσως;
Ναι. Τα publish_instagram_post, publish_facebook_post, publish_tiktok_post και publish_linkedin_post δέχονται το scheduled_at, μια ώρα σε μορφή ISO 8601 με ζώνη ώρας, από 1 λεπτό έως 90 ημέρες μπροστά. Το YouTube προγραμματίζει εγγενώς με το upload_youtube_video και το publish_at.
Ποια μοντέλα μπορούν να τρέχουν τον agent;
Κάθε μοντέλο συνομιλίας που μπορεί να χρησιμοποιήσει το create_agent με εργαλεία. Τα εργαλεία MCP δεν εξαρτώνται από το μοντέλο, και ο πάροχος του μοντέλου χρεώνει τη δική του χρήση· το easyCoexistence χρεώνει ανά σύνδεση, ποτέ ανά κλήση εργαλείου.
Πόσο κοστίζει το easyCoexistence για έναν agent του LangChain;
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και το ίδιο σε κάθε δίκτυο. Ο MCP server, τα προωθημένα events και το Partner API περιλαμβάνονται, και οι πρώτες 3 ημέρες είναι δωρεάν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις