Instrumente pentru agentul OpenAI Agents SDK: Instagram, TikTok și WhatsApp
Un agent OpenAI Agents SDK primește canalele Instagram, TikTok, WhatsApp și altele ca instrumente, prin MCPServerStreamableHttp îndreptat spre https://easycoexistence.com/api/mcp, cu OAuthClientProvider din MCP Python SDK drept handler de autentificare. Un filtru de instrumente restrânge cele peste 35 de instrumente la sarcina respectivă, require_approval ține publicarea în așteptare până o aprobă o persoană, iar fiecare apel ajunge în rețea prin API-ul oficial al rețelei respective.
Ce primește MCPServerStreamableHttp în params["auth"] la MCP Python SDK v2; la v1 primește un httpx.Auth.
Intervalul pachetului mcp de care depinde Agents SDK, care acoperă ambele versiuni majore ale MCP Python SDK.
Unde o rulare întreruptă listează apelurile de instrumente care așteaptă aprobare, pe care un RunState le aprobă sau le respinge înainte ca Runner.run să reia.
De câte ori trebuie trimis token-ul OAuth în authorization către instrumentul MCP din Responses API; OpenAI nu păstrează valoarea.
Câte apeluri permite TikTok pe cont autorizat, la fiecare endpoint din Accounts API, inclusiv răspunsurile la comentarii.
Cum se conectează un agent Agents SDK la easyCoexistence?
Prin MCPServerStreamableHttp, cu OAuthClientProvider din MCP Python SDK în params["auth"]. Agents SDK transmite acest handler clientului HTTP pe care îl construiește, astfel că provider-ul descoperă serverul de autorizare al easyCoexistence, înregistrează agentul dumneavoastră ca client public, parcurge o singură autentificare în browser cu PKCE și reîmprospătează token-urile de acces, valabile o oră, cu ajutorul token-ului de reîmprospătare. Exemplul folosește MCP Python SDK v2, unde handler-ul trebuie să fie un httpx2.Auth, iar provider-ul este unul. Un obiect de stocare păstrează înregistrarea și token-urile între rulări; fișierul de mai jos ține locul unui depozit securizat de secrete. create_static_tool_filter listează instrumentele pe care agentul le poate vedea, iar require_approval numește cele care așteaptă o persoană.
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}},
)Cum păstrați publicarea sub aprobarea unei persoane?
Cu require_approval pe server, care oprește rularea înainte ca un instrument numit să se execute. Rularea revine atunci cu întreruperi, în loc de un răspuns final: transformați rezultatul într-un RunState, aprobați sau respingeți fiecare apel în așteptare și apelați din nou Runner.run cu același agent și cu starea. Dacă always_approve rămâne False, fiecare da acoperă un singur apel, astfel că agentul nu poate refolosi o aprobare pentru o a doua postare. Serverul rămâne deschis pe durata pauzei, pentru că bucla rulează în blocul async with. Pentru o revizuire care durează ore, SDK-ul poate salva starea ca JSON și o poate încărca mai târziu cu 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_outputCum pornește o rulare un comentariu TikTok sau un DM de pe Instagram?
Prin propria dumneavoastră rută HTTPS, deoarece agentul aude doar ce cere de la serverul MCP. set_social_webhook_destination direcționează comentariile, mențiunile și DM-urile unui cont către rută și returnează o singură dată un secret de semnare; conturile TikTok trimit comentariile. Ruta verifică X-EC-Signature, un HMAC-SHA256 calculat pe marcajul temporal, un punct și corpul brut, răspunde în limita de 8 secunde a easyCoexistence și pune evenimentul în coadă. Un worker apelează apoi Runner.run cu evenimentul ca input. Pentru DM-uri, o sesiune identificată după cont și expeditor menține conversația; un comentariu TikTok are nevoie doar de comentariu și de videoclipul lui, așa că poate rula chiar și fără el.
Ce trebuie să spună instrucțiunile agentului despre fiecare rețea?
Regulile pe care le aplică API-ul fiecărei rețele contului, scrise acolo unde le citește modelul:
- TikTok:
reply_to_commentpostează public și are nevoie de ID-ul videoclipului capost_id;send_social_dmrefuză conturile TikTok. - Volumul TikTok: până la 40 de apeluri pe minut pe cont, la endpoint-ul de răspuns, iar multe răspunsuri aproape identice trimise într-un interval scurt pot fi ascunse ca spam.
- DM-urile Instagram: se răspunde doar persoanelor care au scris în ultimele 24 de ore, în cel mult 1.000 de octeți de text UTF-8.
- WhatsApp:
send_messageîn 24 de ore de la ultimul mesaj al clientului, iar altfelsend_templatecu un template aprobat. - Programarea:
scheduled_atacceptă ISO 8601 cu fus orar, cu între 1 minut și 90 de zile în avans, iarlist_scheduled_postsarată coada.
Poate agentul să folosească HostedMCPTool sau să ruleze fără autentificare?
Amândouă, cu compromisuri. HostedMCPTool predă serverul Responses API, al cărui instrument MCP primește un token de acces OAuth în authorization și îl cere în fiecare cerere, deoarece OpenAI nu îl stochează; un token de acces easyCoexistence este valabil o oră, așa că dumneavoastră codul îl reîmprospătează înainte de fiecare rulare. Pentru o sarcină fără nimeni care să se autentifice, renunțați la MCP: instrumentele funcție care apelează Partner API cu o cheie ec_live_ pot pune în coadă postări prin POST /api/v1/channels/:id/posts și pot prelua token-uri proaspete de TikTok, YouTube și LinkedIn din GET /api/v1/channels/:id?credentials=1, iar regulile de comentarii și automatizările răspund pe easyCoexistence fără ca un agent să ruleze.
Greșeli frecvente
- Păstrarea timeout-ului client_session_timeout_seconds de 5 secunde pentru publicare. O publicare așteaptă API-ul rețelei, deci un apel lent poate expira în agent după ce easyCoexistence a trimis deja postarea mai departe; lăsați un minut și verificați list_scheduled_posts înainte de a încerca din nou.
- Trecerea lui external_id drept account_id. Instrumentele cer account_id, ID-ul easyCoexistence al contului; external_id este ID-ul propriu al contului pe Instagram, TikTok sau Facebook.
- Aprobarea întreruperilor în buclă, fără nicio persoană. require_approval protejează publicarea doar atunci când o persoană sau o regulă de încredere decide la fiecare apel în așteptare.
- Hrănirea agentului cu propria activitate a contului. Instagram returnează DM-urile contului ca ecouri cu is_echo true și răspunsurile sale publice ca noi comentarii; filtrați pe amândouă înainte de Runner.run.
easyCoexistence oferă agenților dumneavoastră OpenAI Agents SDK acces la clienți pe WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, fiecare prin API-ul său oficial: un server MCP care se autentifică prin OAuth, evenimente semnate pentru comentarii și DM-uri și un Partner API pentru sarcinile care rulează nesupravegheate, cu fiecare conexiune monitorizată 24/7. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, iar primele 3 zile sunt gratuite.
Întrebări frecvente
Are agentul nevoie de o cheie API de la easyCoexistence?
Nu, pentru MCP. Autentificarea OAuth îi emite agentului propriile token-uri; o cheie ec_live_ din dashboard-ul easyCoexistence este necesară doar pentru codul care apelează Partner API în loc de serverul MCP.
Același agent poate răspunde la mesajele WhatsApp?
Da, cu instrumentele numărului: list_numbers pentru connection_id, send_message în 24 de ore de la ultimul mesaj al clientului și send_template în afara acestui interval. Ghidul OpenAI Agents SDK pentru WhatsApp acoperă primirea mesajelor.
Ce model folosește agentul?
Cel pe care îl dați obiectului Agent. Instrumentele MCP funcționează la fel, indiferent de modelul pe care îl rulează SDK-ul; consumul modelului este facturat de furnizorul lui, iar easyCoexistence taxează pe conexiune.
Cât costă easyCoexistence pentru un agent OpenAI Agents SDK?
De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, la fel pe fiecare rețea. Serverul MCP, evenimentele redirecționate și Partner API sunt incluse, iar primele 3 zile sunt gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la