Dajte agentu OpenAI Agents SDK alate za Instagram, TikTok i WhatsApp
Agent OpenAI Agents SDK-a dobiva Instagram, TikTok, WhatsApp i druge kanale kao alate putem MCPServerStreamableHttp usmjerenog na https://easycoexistence.com/api/mcp, uz MCP Python SDK-ov OAuthClientProvider kao rukovatelja autentifikacijom. Filtar alata sužava više od 35+ alata na potrebni posao, require_approval zadržava objave dok ih osoba ne odobri, a svaki poziv do mreže stiže preko službenog API-ja te mreže.
Što MCPServerStreamableHttp prima u params["auth"] uz MCP Python SDK v2; uz v1 prima httpx.Auth.
Raspon verzije paketa mcp o kojem ovisi Agents SDK, koji obuhvaća obje glavne verzije MCP Python SDK-a.
Gdje pauzirano izvođenje navodi pozive alata koji čekaju odobrenje, a RunState ih odobrava ili odbija prije nego Runner.run nastavi.
Koliko se često OAuth token mora slati u authorization polju MCP alata Responses API-ja; OpenAI tu vrijednost ne pohranjuje.
Koliko poziva TikTok dopušta po ovlaštenom računu na svakom Accounts API endpointu, uključujući odgovore na komentare.
Kako se agent Agents SDK-a povezuje s easyCoexistence?
Putem MCPServerStreamableHttp, uz MCP Python SDK-ov OAuthClientProvider u params["auth"]. Agents SDK proslijeđuje taj rukovatelj HTTP klijentu koji sam izgradi, pa provider otkriva autorizacijski poslužitelj sustava easyCoexistence, registrira vašeg agenta kao javnog klijenta, jednom provodi prijavu u pregledniku s PKCE-om i osvježava pristupne tokene koji vrijede sat vremena pomoću refresh tokena. Primjer koristi MCP Python SDK v2, gdje rukovatelj mora biti httpx2.Auth, što provider i jest. Objekt za pohranu čuva registraciju i tokene između izvođenja; datoteka u nastavku zamjenjuje tajnu pohranu. create_static_tool_filter navodi alate koje agent smije vidjeti, a require_approval imenuje one koji čekaju osobu.
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}},
)Kako objave držite iza odobrenja osobe?
Pomoću require_approval na poslužitelju, koji zaustavlja izvođenje prije nego se imenovani alat izvrši. Izvođenje se tada vraća s interruptions umjesto konačnog odgovora: pretvorite rezultat u RunState, odobrite ili odbijte svaki čekajući poziv i ponovno pozovite Runner.run s istim agentom i tim stanjem. Uz always_approve na False, svako „da“ pokriva jedan poziv, pa agent ne može ponovno upotrijebiti odobrenje za drugu objavu. Poslužitelj ostaje otvoren tijekom pauze jer petlja radi unutar njegova async with bloka. Za pregled koji traje satima SDK može spremiti stanje kao JSON i kasnije ga učitati pomoću 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_outputKako komentar na TikToku ili DM na Instagramu pokreće izvođenje?
Preko vaše vlastite HTTPS rute, jer agent čuje samo ono što zatraži od MCP poslužitelja. set_social_webhook_destination usmjerava komentare, spominjanja i DM-ove računa na rutu i jednom vraća tajni ključ za potpisivanje; računi na TikToku prosljeđuju komentare. Ruta provjerava X-EC-Signature, HMAC-SHA256 od vremenske oznake, točke i sirovog tijela, odgovara unutar 8 sekundi koliko dopušta easyCoexistence i stavlja događaj u red. Radnik zatim poziva Runner.run s događajem kao ulazom. Za DM-ove sesija vezana uz račun i pošiljatelja održava razgovor; komentar na TikToku treba samo komentar i njegov video, pa može raditi i bez videa.
Što agentove upute trebaju reći o svakoj mreži?
Pravila koja API svake mreže primjenjuje na račun, zapisana tamo gdje ih model čita:
- TikTok:
reply_to_commentobjavljuje javno i traži ID videa kaopost_id;send_social_dmodbija TikTok račune. - Obujam na TikToku: do 40 poziva u minuti po računu na endpointu za odgovore, a mnogo gotovo identičnih odgovora u kratkom vremenu može biti sakriveno kao neželjena pošta.
- Instagram DM-ovi: odgovara se samo osobama koje su pisale u posljednja 24 sata, u najviše 1.000 bajtova UTF-8 teksta.
- WhatsApp:
send_messageunutar 24 sata od posljednje poruke kupca, inačesend_templates odobrenim predloškom. - Vrijeme:
scheduled_atprihvaća ISO 8601 s vremenskom zonom, od 1 minute do 90 dana unaprijed, alist_scheduled_postsprikazuje red čekanja.
Može li agent koristiti HostedMCPTool ili raditi bez prijave?
Oboje, uz kompromise. HostedMCPTool predaje poslužitelj Responses API-ju, čiji MCP alat uzima OAuth pristupni token u authorization i traži ga u svakom zahtjevu, jer OpenAI ga ne pohranjuje; pristupni token sustava easyCoexistence vrijedi sat vremena, pa ga vaš kod osvježava prije svakog izvođenja. Za posao bez nikoga tko bi se prijavio preskočite MCP: alati tipa function koji pozivaju Partner API s ključem ec_live_ mogu stavljati objave u red putem POST /api/v1/channels/:id/posts i dohvaćati svježe tokene za TikTok, YouTube i LinkedIn putem GET /api/v1/channels/:id?credentials=1, dok pravila za komentare i automatizacije odgovaraju u sustavu easyCoexistence bez pokrenutog agenta.
Uobičajene pogreške
- Zadržavanje 5-sekundnog client_session_timeout_seconds za objave. Objava čeka API mreže, pa spor poziv može isteći u agentu nakon što je easyCoexistence već proslijedio objavu; dajte minutu i provjerite list_scheduled_posts prije ponovnog pokušaja.
- Slanje external_id kao account_id. Alati uzimaju account_id, ID računa u sustavu easyCoexistence; external_id je vlastiti ID računa na Instagramu, TikToku ili Facebooku.
- Odobravanje prekida u petlji bez osobe. require_approval štiti objave samo kada osoba ili pravilo kojem vjerujete odlučuje o svakom čekajućem pozivu.
- Hranjenje agenta vlastitom aktivnošću računa. Instagram vraća DM-ove računa kao odjeke s is_echo true, a njegove javne odgovore kao nove komentare; filtrirajte oba prije Runner.run.
easyCoexistence daje vašim agentima OpenAI Agents SDK-a doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i drugim kanalima, svaki putem službenog API-ja: MCP poslužitelj koji se prijavljuje OAuth-om, potpisani događaji za komentare i DM-ove te Partner API za poslove koji rade bez stalnog nadzora, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mjesečno, cijena pada kako dodajete veze, uz besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Treba li agentu API ključ easyCoexistence?
Za MCP ne. OAuth prijava izdaje agentu vlastite tokene; ključ ec_live_ iz nadzorne ploče namijenjen je samo kodu koji poziva Partner API umjesto MCP poslužitelja.
Može li isti agent odgovarati na WhatsApp poruke?
Može, uz alate za broj: list_numbers za connection_id, send_message unutar 24 sata od posljednje poruke kupca i send_template izvan tog razdoblja. Vodič OpenAI Agents SDK za WhatsApp pokriva primanje poruka.
Koji model agent koristi?
Onaj koji dodijelite Agentu. MCP alati rade jednako uz bilo koji model koji SDK pokreće, njegovu potrošnju naplaćuje pružatelj modela, a easyCoexistence naplaćuje po vezi.
Koliko košta easyCoexistence za agenta OpenAI Agents SDK-a?
Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj, prosljeđeni događaji i Partner API dolaze uz to, a prva 3 dana su besplatna.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na