Dajte OpenAI Agents SDK agentu alate za Instagram, TikTok i WhatsApp
OpenAI Agents SDK agent dobija kanale Instagram, TikTok, WhatsApp i druge kao alate preko MCPServerStreamableHttp, usmerenog na https://easycoexistence.com/api/mcp, sa OAuthClientProvider iz MCP Python SDK-a kao rukovaocem autentifikacijom. Filter alata sužava više od 35 alata na posao, require_approval zadržava objavljivanje dok osoba ne odobri, a svaki poziv ide na mrežu preko njenog zvaničnog API-ja.
Šta MCPServerStreamableHttp prima u params["auth"] uz MCP Python SDK v2; uz v1 prima httpx.Auth.
Opseg paketa mcp od kog zavisi Agents SDK, koji obuhvata obe glavne verzije MCP Python SDK-a.
Gde pauzirano pokretanje navodi pozive alata koji čekaju odobrenje, koje RunState odobrava ili odbija pre nego što Runner.run nastavi.
Koliko često se OAuth token mora slati MCP alatu Responses API-ja u authorization; OpenAI tu vrednost ne čuva.
Koliko poziva TikTok dozvoljava po ovlašćenom nalogu na svakom endpointu Accounts API-ja, uključujući odgovore na komentare.
Kako se agent iz OpenAI Agents SDK-a povezuje sa easyCoexistence?
Preko MCPServerStreamableHttp, sa OAuthClientProvider iz MCP Python SDK-a u params["auth"]. Agents SDK prosleđuje taj rukovalac HTTP klijentu koji sam pravi, pa provider pronalazi easyCoexistence-ov server za autorizaciju, registruje vašeg agenta kao javni klijent, jednom pokreće prijavu u pregledaču uz PKCE i osvežava pristupne tokene koji važe sat vremena pomoću tokena za osvežavanje. Primer koristi MCP Python SDK v2, gde rukovalac mora biti httpx2.Auth, što provider jeste. Objekat za skladištenje čuva registraciju i tokene između pokretanja; fajl ispod zamenjuje skladište tajni. create_static_tool_filter navodi alate koje agent sme da vidi, 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 držati objavljivanje pod odobrenjem osobe?
Pomoću require_approval na serveru, koji pauzira pokretanje pre nego što imenovani alat izvrši. Pokretanje tada vraća prekide umesto konačnog odgovora: pretvorite rezultat u RunState, odobrite ili odbijte svaki poziv na čekanju i ponovo pozovite Runner.run sa istim agentom i tim stanjem. Ako always_approve ostane False, svako „da“ važi za jedan poziv, pa agent ne može da iskoristi jedno odobrenje za drugu objavu. Server ostaje otvoren tokom pauze jer petlja radi unutar njegovog async with bloka. Za pregled koji traje satima, SDK može sačuvati 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 rad agenta?
Preko sopstvene HTTPS rute, jer agent čuje samo ono što zatraži od MCP servera. set_social_webhook_destination usmerava komentare, pominjanja i DM-ove naloga na rutu i jednom vraća tajni ključ za potpisivanje; TikTok nalozi prosleđuju komentare. Ruta proverava X-EC-Signature, HMAC-SHA256 nad vremenskom oznakom, tačkom i neobrađenim telom, odgovara u roku od 8 sekundi, koliko easyCoexistence dozvoljava, i stavlja događaj u red. Radni proces zatim poziva Runner.run sa događajem kao ulazom. Za DM-ove, sesija vezana za nalog i pošiljaoca održava razgovor; komentar na TikToku treba samo komentar i njegov video, pa može da radi bez nje.
Šta uputstva agenta treba da kažu o svakoj mreži?
Pravila koja API svake mreže primenjuje na nalog, napisana tamo gde ih model čita:
- TikTok:
reply_to_commentobjavljuje javno i traži ID videa kaopost_id;send_social_dmodbija TikTok naloge. - Obim na TikToku: do 40 poziva u minuti po nalogu na endpointu za odgovore, a mnogo gotovo identičnih odgovora u kratkom roku može biti sakriveno kao spam.
- DM-ovi na Instagramu: odgovori samo osobama koje su pisale u poslednja 24 sata, u najviše 1.000 bajtova UTF-8 teksta.
- WhatsApp:
send_messageu roku od 24 sata od poslednje poruke klijenta, a inačesend_templatesa odobrenim šablonom. - Zakazivanje:
scheduled_atprima ISO 8601 sa vremenskom zonom, od 1 minuta do 90 dana unapred, alist_scheduled_postsprikazuje red zakazanih objava.
Može li agent da koristi HostedMCPTool ili da radi bez prijave?
Oboje, uz kompromise. HostedMCPTool predaje server Responses API-ju, čiji MCP alat prima OAuth pristupni token u authorization i traži ga u svakom zahtevu, jer ga OpenAI ne čuva; easyCoexistence pristupni token važi sat vremena, pa vaš kod osvežava jedan pre svakog pokretanja. Za posao bez osobe koja se prijavljuje, preskočite MCP: funkcijski alati koji pozivaju Partner API sa ključem ec_live_ mogu da stavljaju objave u red preko POST /api/v1/channels/:id/posts i preuzimaju sveže tokene za TikTok, YouTube i LinkedIn preko GET /api/v1/channels/:id?credentials=1, dok pravila za komentare i automatizacije odgovaraju na easyCoexistence bez pokrenutog agenta.
Česte greške
- Zadržavanje vrednosti client_session_timeout_seconds od 5 sekundi za objavljivanje. Objavljivanje čeka API mreže, pa spor poziv može isteći u agentu nakon što je easyCoexistence već prosledio objavu; ostavite minut i proverite list_scheduled_posts pre novog pokušaja.
- Prosleđivanje external_id kao account_id. Alati prihvataju account_id, easyCoexistence-ov ID naloga; external_id je sopstveni ID naloga na Instagramu, TikToku ili Facebooku.
- Odobravanje prekida u petlji bez osobe u njoj. require_approval štiti objavljivanje samo kada čovek ili pravilo kojem verujete odlučuje o svakom pozivu na čekanju.
- Hranjenje agenta sopstvenom aktivnošću naloga. Instagram vraća DM-ove naloga kao eho sa is_echo true, a javne odgovore kao nove komentare; filtrirajte oba pre Runner.run.
easyCoexistence daje vašim agentima OpenAI Agents SDK-a doseg do klijenata na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svakom preko njegovog zvaničnog API-ja: MCP server koji se prijavljuje preko OAuth-a, potpisani događaji za komentare i DM-ove i Partner API za poslove bez nadzora, a svaka veza se nadgleda 24/7. Od US$ 9 do US$ 0.75 po vezi mesečno, uz pad cene kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Treba li agentu API ključ od easyCoexistence?
Ne za MCP. OAuth prijava izdaje agentu sopstvene tokene; ključ ec_live_ sa kontrolne table je samo za kod koji poziva Partner API umesto MCP servera.
Može li isti agent da odgovara na WhatsApp poruke?
Može, uz alate za broj: list_numbers za connection_id, send_message u roku od 24 sata od poslednje poruke klijenta i send_template posle tog roka. Vodič OpenAI Agents SDK za WhatsApp pokriva primanje poruka.
Koji model koristi agent?
Onaj koji dodelite Agent-u. MCP alati rade isto bez obzira na model koji SDK pokreće, potrošnju modela naplaćuje njegov provajder, 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 mesečno, uz pad kako dodajete veze, isto na svakoj mreži. MCP server, prosleđeni događaji i Partner API su uključeni, a prva 3 dana su besplatna.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na