Δώστε σε ένα agent του OpenAI Agents SDK tools για Instagram, TikTok και WhatsApp
Ένα agent του OpenAI Agents SDK αποκτά κανάλια Instagram, TikTok, WhatsApp και άλλα ως tools μέσω του MCPServerStreamableHttp, με προορισμό το https://easycoexistence.com/api/mcp και με τον OAuthClientProvider του MCP Python SDK ως handler ελέγχου ταυτότητας. Ένα φίλτρο tools περιορίζει τα 35+ tools στη δουλειά, το require_approval κρατά τη δημοσίευση σε αναμονή έως ότου την εγκρίνει ένας άνθρωπος, και κάθε κλήση φτάνει στο δίκτυο μέσω του επίσημου API του.
Τι παίρνει το MCPServerStreamableHttp στο params["auth"] με το MCP Python SDK v2· με v1 παίρνει ένα httpx.Auth.
Το εύρος του πακέτου mcp από το οποίο εξαρτάται το Agents SDK, που καλύπτει και τις δύο μείζονες εκδόσεις του MCP Python SDK.
Πού εμφανίζει μια εκτέλεση σε παύση τις κλήσεις tools που περιμένουν έγκριση, τις οποίες ένα RunState εγκρίνει ή απορρίπτει πριν συνεχίσει το Runner.run.
Πόσο συχνά πρέπει να αποστέλλεται στο authorization το OAuth token στο MCP tool του Responses API· το OpenAI δεν αποθηκεύει την τιμή.
Πόσες κλήσεις επιτρέπει το TikTok ανά εξουσιοδοτημένο λογαριασμό σε κάθε endpoint του Accounts API, συμπεριλαμβανομένων των απαντήσεων σε σχόλια.
Πώς ένα agent του Agents SDK συνδέεται με το easyCoexistence;
Μέσω του MCPServerStreamableHttp, με τον OAuthClientProvider του MCP Python SDK στο params["auth"]. Το Agents SDK περνά αυτόν τον handler στον HTTP client που δημιουργεί, οπότε ο provider εντοπίζει τον authorization server του easyCoexistence, καταχωρίζει το agent σας ως public client, εκτελεί μία είσοδο στον browser με PKCE και ανανεώνει τα access tokens διάρκειας μίας ώρας με το refresh token. Το παράδειγμα χρησιμοποιεί το MCP Python SDK v2, όπου ο handler πρέπει να είναι httpx2.Auth, και αυτό είναι ο provider. Ένα αντικείμενο αποθήκευσης κρατά την καταχώριση και τα tokens μεταξύ των εκτελέσεων· το αρχείο παρακάτω υποκαθιστά ένα secret store. Το create_static_tool_filter ορίζει ποια tools βλέπει το agent, και το require_approval ονομάζει εκείνα που περιμένουν έναν άνθρωπο.
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse
from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter
URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json") # a secret store in production
class SavedSignIn: # the MCP SDK's TokenStorage: registration and tokens survive restarts
def _read(self) -> dict:
return json.loads(SAVED.read_text()) if SAVED.exists() else {}
def _write(self, key: str, model) -> None:
data = self._read()
data[key] = model.model_dump(mode="json")
SAVED.write_text(json.dumps(data))
async def get_tokens(self):
t = self._read().get("tokens")
return OAuthToken(**t) if t else None
async def set_tokens(self, tokens): self._write("tokens", tokens)
async def get_client_info(self):
c = self._read().get("client")
return OAuthClientInformationFull(**c) if c else None
async def set_client_info(self, info): self._write("client", info)
async def open_sign_in(url: str) -> None:
webbrowser.open(url)
async def code_from_redirect() -> AuthorizationCodeResult:
q = parse_qs(urlparse(input("Address after sign-in: ")).query)
return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])
oauth = OAuthClientProvider(
server_url=URL,
client_metadata=OAuthClientMetadata(
client_name="Social desk agent", # shown on easyCoexistence's consent screen
redirect_uris=[AnyUrl("http://localhost:3030/callback")],
scope="mcp",
),
storage=SavedSignIn(),
redirect_handler=open_sign_in,
callback_handler=code_from_redirect,
)
PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]
def easycoexistence() -> MCPServerStreamableHttp:
return MCPServerStreamableHttp(
name="easyCoexistence",
params={"url": URL, "auth": oauth, "timeout": 60},
client_session_timeout_seconds=60, # publishing waits on the network's API
cache_tools_list=True,
tool_filter=create_static_tool_filter(allowed_tool_names=[
"list_social_accounts", "list_social_posts", "list_social_comments",
"reply_to_comment", "list_scheduled_posts", *PUBLISH,
]),
require_approval={"always": {"tool_names": PUBLISH}},
)Πώς κρατάτε τη δημοσίευση πίσω από την έγκριση ενός ανθρώπου;
Με το require_approval στον server, που σταματά την εκτέλεση πριν εκτελεστεί ένα ονομασμένο tool. Η εκτέλεση επιστρέφει τότε με interruptions αντί για τελική απάντηση: μετατρέψτε το αποτέλεσμα σε RunState, εγκρίνετε ή απορρίψτε κάθε εκκρεμή κλήση και καλέστε ξανά το Runner.run με το ίδιο agent και την ίδια κατάσταση. Με το always_approve στο False, κάθε «ναι» καλύπτει μία κλήση, οπότε το agent δεν μπορεί να επαναχρησιμοποιήσει μια έγκριση για δεύτερη ανάρτηση. Ο server μένει ανοιχτός κατά τη διακοπή, επειδή ο βρόχος τρέχει μέσα στο async with block του. Για έλεγχο που διαρκεί ώρες, το SDK μπορεί να αποθηκεύσει την κατάσταση ως JSON και να τη φορτώσει ξανά αργότερα με RunState.from_json.
from agents import Agent, Runner
RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."
async def run(task: str) -> str:
async with easycoexistence() as server:
agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
result = await Runner.run(agent, task)
while result.interruptions: # a publish tool is waiting for a decision
state = result.to_state()
for item in result.interruptions:
if await ask_a_person(item): # your review screen, chat message or queue
state.approve(item, always_approve=False)
else:
state.reject(item)
result = await Runner.run(agent, state)
return result.final_outputΠώς ένα σχόλιο στο TikTok ή ένα DM στο Instagram ξεκινά μια εκτέλεση;
Μέσω του δικού σας HTTPS route, αφού το agent ακούει μόνο όσα ζητά από τον MCP server. Το set_social_webhook_destination στοχεύει τα σχόλια, τις αναφορές και τα DMs ενός λογαριασμού προς το route και επιστρέφει ένα μυστικό υπογραφής μία φορά· οι λογαριασμοί TikTok προωθούν σχόλια. Το route ελέγχει το X-EC-Signature, ένα HMAC-SHA256 του timestamp, μιας τελείας και του ακατέργαστου body, απαντά εντός των 8 δευτερολέπτων του easyCoexistence και βάζει το γεγονός σε ουρά. Ένας worker καλεί έπειτα το Runner.run με το γεγονός ως input. Για τα DMs, μια συνεδρία με κλειδί τον λογαριασμό και τον αποστολέα κρατά τη συνομιλία σε εξέλιξη· ένα σχόλιο TikTok χρειάζεται μόνο το σχόλιο και το βίντεό του, οπότε μπορεί να τρέξει χωρίς αυτό.
Τι πρέπει να λένε οι οδηγίες του agent για κάθε δίκτυο;
Οι κανόνες που εφαρμόζει το API κάθε δικτύου στον λογαριασμό, γραμμένοι εκεί όπου τους διαβάζει το μοντέλο:
- TikTok: το
reply_to_commentδημοσιεύει δημόσια και θέλει το ID του βίντεο ωςpost_id· τοsend_social_dmαπορρίπτει λογαριασμούς TikTok. - Όγκος στο TikTok: έως 40 κλήσεις το λεπτό ανά λογαριασμό στο endpoint απαντήσεων, και πολλές σχεδόν πανομοιότυπες απαντήσεις σε σύντομο χρονικό διάστημα μπορεί να κρυφτούν ως spam.
- DMs στο Instagram: απαντήσεις μόνο σε όσους έγραψαν τις τελευταίες 24 ώρες, σε το πολύ 1.000 bytes κειμένου UTF-8.
- WhatsApp:
send_messageεντός 24 ωρών από το τελευταίο μήνυμα του πελάτη, καιsend_templateμε εγκεκριμένο template διαφορετικά. - Χρονισμός: το
scheduled_atδέχεται ISO 8601 με ζώνη ώρας, από 1 λεπτό έως 90 ημέρες μπροστά, και τοlist_scheduled_postsδείχνει την ουρά.
Μπορεί το agent να χρησιμοποιεί το HostedMCPTool ή να τρέχει χωρίς είσοδο;
Και τα δύο, με αντισταθμίσεις. Το HostedMCPTool παραδίδει τον server στο Responses API, του οποίου το MCP tool δέχεται ένα OAuth access token στο authorization και το θέλει σε κάθε αίτημα, αφού το OpenAI δεν το αποθηκεύει· ένα access token του easyCoexistence ισχύει μία ώρα, οπότε ο κώδικάς σας ανανεώνει ένα πριν από κάθε εκτέλεση. Για δουλειά χωρίς κάποιον να συνδεθεί, παραλείψτε το MCP: τα function tools που καλούν το Partner API με ένα κλειδί ec_live_ μπορούν να βάζουν σε ουρά αναρτήσεις μέσω του POST /api/v1/channels/:id/posts και να λαμβάνουν φρέσκα tokens του TikTok, του YouTube και του LinkedIn από το GET /api/v1/channels/:id?credentials=1, ενώ οι κανόνες σχολίων και τα automations απαντούν στο easyCoexistence χωρίς να τρέχει κανένα agent.
Συνηθισμένα λάθη
- Το να κρατάτε το client_session_timeout_seconds στα 5 δευτερόλεπτα για τη δημοσίευση. Η δημοσίευση περιμένει το API του δικτύου, οπότε μια αργή κλήση μπορεί να λήξει στο agent αφού το easyCoexistence έχει ήδη προωθήσει την ανάρτηση· δώστε ένα λεπτό και ελέγξτε το list_scheduled_posts πριν δοκιμάσετε ξανά.
- Η αποστολή του external_id ως account_id. Τα tools παίρνουν το account_id, δηλαδή το ID του λογαριασμού στο easyCoexistence· το external_id είναι το δικό του ID του λογαριασμού στο Instagram, TikTok ή Facebook.
- Η έγκριση διακοπών σε βρόχο χωρίς άνθρωπο μέσα. Το require_approval προστατεύει τη δημοσίευση μόνο όταν ένας άνθρωπος, ή ένας κανόνας που εμπιστεύεστε, αποφασίζει για κάθε εκκρεμή κλήση.
- Η τροφοδότηση του agent με τη δραστηριότητα του ίδιου του λογαριασμού. Το Instagram επιστρέφει τα DMs του λογαριασμού ως echoes με is_echo true και τις δημόσιες απαντήσεις του ως νέα σχόλια· φιλτράρετε και τα δύο πριν το Runner.run.
Το easyCoexistence δίνει στα agents σας του OpenAI Agents SDK πρόσβαση σε πελάτες μέσω WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλια, το καθένα μέσω του επίσημου API του: έναν MCP server που συνδέεται με OAuth, υπογεγραμμένα γεγονότα για σχόλια και DMs και ένα Partner API για δουλειές που τρέχουν χωρίς επίβλεψη, με κάθε σύνδεση να παρακολουθείται 24/7. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Χρειάζεται το agent κλειδί API από το easyCoexistence;
Όχι για το MCP. Η είσοδος με OAuth εκδίδει στο agent τα δικά του tokens· ένα κλειδί ec_live_ από το dashboard προορίζεται μόνο για κώδικα που καλεί το Partner API αντί για τον MCP server.
Μπορεί το ίδιο agent να απαντά σε μηνύματα WhatsApp;
Ναι, με τα tools του αριθμού: το list_numbers για το connection_id, το send_message εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη και το send_template έξω από αυτό το διάστημα. Ο οδηγός του OpenAI Agents SDK για WhatsApp καλύπτει τη λήψη των μηνυμάτων.
Ποιο μοντέλο χρησιμοποιεί το agent;
Αυτό που δίνετε στο Agent. Τα MCP tools λειτουργούν το ίδιο όποιο μοντέλο κι αν τρέχει το SDK, η χρήση του μοντέλου χρεώνεται από τον πάροχό του, και το easyCoexistence χρεώνει ανά σύνδεση.
Πόσο κοστίζει το easyCoexistence για ένα agent του OpenAI Agents SDK;
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, το ίδιο σε κάθε δίκτυο. Ο MCP server, τα προωθούμενα γεγονότα και το Partner API περιλαμβάνονται, και οι πρώτες 3 ημέρες είναι δωρεάν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις