Bigyan ng Instagram, TikTok, at WhatsApp na tools ang OpenAI Agents SDK agent
Nakakakuha ang isang OpenAI Agents SDK agent ng Instagram, TikTok, WhatsApp, at iba pang channel bilang tools sa pamamagitan ng MCPServerStreamableHttp na nakaturo sa https://easycoexistence.com/api/mcp, na may OAuthClientProvider ng MCP Python SDK bilang auth handler. Pinapaliit ng tool filter ang 35+ tools para sa trabaho, pinipigilan ng require_approval ang pag-publish hanggang may taong mag-apruba, at dumadaan ang bawat tawag sa network sa opisyal nitong API.
Ano ang tinatanggap ng MCPServerStreamableHttp sa params["auth"] sa MCP Python SDK v2; sa v1, isang httpx.Auth ang tinatanggap nito.
Ang saklaw ng mcp package na kinakailangan ng Agents SDK, na sumasaklaw sa parehong major version ng MCP Python SDK.
Kung saan nakalista ng pausadong run ang mga tool call na naghihintay ng approval, na inaaprubahan o tinatanggihan ng RunState bago mag-resume ang Runner.run.
Gaano kadalas dapat ipadala ang OAuth token sa authorization ng MCP tool ng Responses API; hindi ito tinatago ng OpenAI.
Mga tawag na pinapayagan ng TikTok bawat naka-authorize na account sa bawat Accounts API endpoint, kasama ang mga reply sa comment.
Paano kumokonekta ang isang Agents SDK agent sa easyCoexistence?
Sa pamamagitan ng MCPServerStreamableHttp, na may OAuthClientProvider ng MCP Python SDK sa params["auth"]. Ipinapasa ng Agents SDK ang handler na iyon sa HTTP client na binubuo nito, kaya natutuklasan ng provider ang authorization server ng easyCoexistence, nire-register ang inyong agent bilang public client, nagpapatakbo ng isang browser sign-in gamit ang PKCE, at nire-refresh ang mga access token na tumatagal ng isang oras gamit ang refresh token. Ginagamit ng halimbawa ang MCP Python SDK v2, kung saan kailangang httpx2.Auth ang handler, at ganoon nga ang provider. Pinananatili ng storage object ang registration at mga token sa pagitan ng mga run; ang file sa ibaba ang pumapalit sa secret store. Inililista ng create_static_tool_filter ang mga tool na maaaring makita ng agent, at tinutukoy ng require_approval ang mga naghihintay ng approval ng isang tao.
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}},
)Paano pinapanatili ang pag-publish sa likod ng approval ng isang tao?
Gamit ang require_approval sa server, na humihinto sa run bago isagawa ang isang pinangalanang tool. Ang run ay bumabalik na may interruptions sa halip na final answer: gawing RunState ang resulta, aprubahan o tanggihan ang bawat nakabinbing tawag, at tawagin muli ang Runner.run gamit ang parehong agent at state. Kapag naka-False ang always_approve, bawat yes ay sumasakop sa isang tawag lamang, kaya hindi magagamit muli ng agent ang approval para sa pangalawang post. Nananatiling bukas ang server habang naka-pause dahil tumatakbo ang loop sa loob ng async with block nito. Para sa review na inaabot ng oras, maaaring i-store ng SDK ang state bilang JSON at i-load ito ulit gamit ang 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_outputPaano nagsisimula ang isang run mula sa TikTok comment o Instagram DM?
Sa pamamagitan ng sarili ninyong HTTPS route, dahil nakikinig lamang ang agent sa hinihingi nito sa MCP server. Itinuturo ng set_social_webhook_destination ang mga comment, mention, at DM ng isang account sa route at ibinabalik ang signing secret nang isang beses; ipinapasa ng mga TikTok account ang mga comment. Sinusuri ng route ang X-EC-Signature, isang HMAC-SHA256 ng timestamp, isang tuldok, at ang raw body, sumasagot sa loob ng 8 segundo ng easyCoexistence, at ipinipila ang event. Pagkatapos, tinatawag ng isang worker ang Runner.run gamit ang event bilang input. Para sa mga DM, pinapanatili ng session na naka-key sa account at sa nagpadala ang usapan; ang TikTok comment ay kailangan lamang ng comment at ng video nito, kaya maaari itong tumakbo nang walang session.
Ano ang dapat sabihin ng instructions ng agent tungkol sa bawat network?
Ang mga patakarang ipinapatupad ng API ng bawat network sa account, nakasulat sa lugar na binabasa ng model:
- TikTok: nagpo-post sa publiko ang
reply_to_commentat kailangan ang ID ng video bilangpost_id; tinatanggihan ngsend_social_dmang mga TikTok account. - Dami ng TikTok: hanggang 40 tawag kada minuto bawat account sa reply endpoint, at maaaring itago bilang spam ang maraming halos magkakatulad na reply sa maikling panahon.
- Instagram DM: sumasagot lamang sa mga taong sumulat sa nakaraang 24 na oras, sa hanggang 1,000 byte ng UTF-8 na text.
- WhatsApp:
send_messagesa loob ng 24 na oras mula sa huling mensahe ng customer, atsend_templatena may aprubadong template kung hindi. - Timing: tumatanggap ang
scheduled_atng ISO 8601 na may timezone, mula 1 minuto hanggang 90 araw sa hinaharap, at ipinapakita nglist_scheduled_postsang queue.
Puwede bang gamitin ng agent ang HostedMCPTool, o tumakbo nang walang sign-in?
Parehong puwede, na may kapalit. Ibinibigay ng HostedMCPTool ang server sa Responses API, na ang MCP tool nito ay tumatanggap ng OAuth access token sa authorization at kailangan ito sa bawat request, dahil hindi ito tinatago ng OpenAI; ang access token ng easyCoexistence ay tumatagal ng isang oras, kaya dapat i-refresh ng inyong code ang isa bago ang bawat run. Para sa trabahong walang taong mag-sign in, laktawan ang MCP: maaaring magpila ng post ang mga function tool na tumatawag sa Partner API gamit ang ec_live_ key sa pamamagitan ng POST /api/v1/channels/:id/posts at kumuha ng bagong token ng TikTok, YouTube at LinkedIn mula sa GET /api/v1/channels/:id?credentials=1, habang ang mga patakaran sa comment at automation ay sumasagot sa easyCoexistence nang walang tumatakbong agent.
Mga karaniwang pagkakamali
- Pagpapanatili ng 5-second client_session_timeout_seconds para sa pag-publish. Naghihintay ang publish sa API ng network, kaya maaaring mag-timeout ang mabagal na tawag sa agent matapos maipasa ng easyCoexistence ang post; maglaan ng isang minuto, at tingnan ang list_scheduled_posts bago subukan ulit.
- Paggamit ng external_id bilang account_id. Ang mga tool ay tumatanggap ng account_id, ang ID ng easyCoexistence para sa account; ang external_id ay ang sariling ID ng account sa Instagram, TikTok, o Facebook.
- Pag-aapruba ng interruptions nang paulit-ulit nang walang taong kasali. Pinoprotektahan lamang ng require_approval ang pag-publish kapag may taong, o isang patakarang pinagkakatiwalaan ninyo, na nagdedesisyon sa bawat nakabinbing tawag.
- Pagpapakain sa agent ng sariling aktibidad ng account. Ibinabalik ng Instagram ang mga DM ng account bilang echo na may is_echo true at ang mga pampublikong reply nito bilang bagong comment; i-filter ang dalawa bago ang Runner.run.
Binibigyan ng easyCoexistence ng abot sa mga customer ang ninyong mga OpenAI Agents SDK agent sa WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn, at iba pang channel, bawat isa sa pamamagitan ng opisyal nitong API: isang MCP server na nag-sign in gamit ang OAuth, mga naka-sign na event para sa comment at DM, at isang Partner API para sa mga trabahong tumatakbo nang walang tao, habang pinagmo-monitor ang bawat koneksyon 24/7. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at may free trial na 3 araw.
Mga madalas itanong
Kailangan ba ng agent ng API key mula sa easyCoexistence?
Hindi para sa MCP. Ang OAuth sign-in ang nagbibigay sa agent ng sarili nitong token; ang ec_live_ key mula sa dashboard ay para lamang sa code na tumatawag sa Partner API sa halip na sa MCP server.
Puwede bang sumagot ang parehong agent sa mga mensahe sa WhatsApp?
Oo, gamit ang tools ng numero: list_numbers para sa connection_id, send_message sa loob ng 24 na oras mula sa huling mensahe ng customer, at send_template sa labas nito. Tinatalakay ng OpenAI Agents SDK guide para sa WhatsApp kung paano tatanggapin ang mga mensahe.
Aling model ang ginagamit ng agent?
Ang model na itinakda ninyo sa Agent. Gumagana ang mga MCP tool sa anumang model na pinapatakbo ng SDK, sinisingil ng provider nito ang paggamit ng model, at naniningil ang easyCoexistence kada koneksyon.
Magkano ang halaga ng easyCoexistence para sa OpenAI Agents SDK agent?
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, pareho sa bawat network. Kasama ang MCP server, ang mga naipasang event, at ang Partner API, at may free trial na 3 araw.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong