Mpe wakala wako wa OpenAI Agents SDK zana za Instagram, TikTok na WhatsApp
Wakala wa OpenAI Agents SDK hupata Instagram, TikTok, WhatsApp na njia nyingine zaidi kama zana, kupitia MCPServerStreamableHttp inayoelekezwa kwa https://easycoexistence.com/api/mcp, huku OAuthClientProvider ya MCP Python SDK ikiwa kidhibiti chake cha uthibitishaji. Kichujio cha zana hupunguza zana 35+ hadi kazi husika, require_approval huzuia uchapishaji hadi mtu aidhinishe, na kila wito hufika kwenye mtandao kupitia API yake rasmi.
Kinachochukuliwa na MCPServerStreamableHttp katika params["auth"] kwa MCP Python SDK v2; kwa v1 inachukua httpx.Auth.
Safu ya toleo la kifurushi cha mcp ambacho Agents SDK inategemea, inayofunika matoleo yote mawili makuu ya MCP Python SDK.
Mahali ambapo run iliyositishwa inaorodhesha miito ya zana inayosubiri idhini, ambayo RunState huidhinisha au kuikataa kabla Runner.run haijaendelea.
Ni mara ngapi zana ya MCP ya Responses API inapaswa kutumwa tokeni yake ya OAuth katika authorization; OpenAI haihifadhi thamani hiyo.
Miito ambayo TikTok inaruhusu kwa kila akaunti iliyoidhinishwa kwenye kila endpoint ya Accounts API, pamoja na majibu ya maoni.
Wakala wa Agents SDK huunganishwaje na easyCoexistence?
Kupitia MCPServerStreamableHttp, ukiwa na OAuthClientProvider ya MCP Python SDK katika params["auth"]. Agents SDK hupitisha kidhibiti hicho kwa mteja wa HTTP ambao SDK hujenga, kwa hiyo mtoaji hugundua seva ya uthibitishaji ya easyCoexistence, husajili wakala wako kama mteja wa umma, huendesha kuingia kwenye kivinjari mara moja kwa PKCE na kuhuisha tokeni za ufikiaji zinazodumu saa moja kwa kutumia tokeni ya kuhuisha. Mfano unatumia MCP Python SDK v2, ambapo kidhibiti lazima kiwe httpx2.Auth, na mtoaji ni hivyo. Kitu cha kuhifadhi huweka usajili na tokeni kati ya run; faili lililo hapa chini linasimama mahali pa hifadhi ya siri. create_static_tool_filter huorodhesha zana ambazo wakala anaweza kuziona, na require_approval hutaja zile zinazosubiri mtu.
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}},
)Je, unawezaje kuweka uchapishaji chini ya idhini ya mtu?
Kwa require_approval kwenye seva, ambayo husitisha run kabla zana iliyotajwa haijatekelezwa. Run kisha hurudi ikiwa na vizuizi (interruptions) badala ya jibu la mwisho: geuza matokeo kuwa RunState, idhinisha au kataa kila wito unaosubiri, kisha uite Runner.run tena ukiwa na wakala yule yule na state hiyo. Kwa always_approve ikiwa False, kila ndiyo inafunika wito mmoja tu, kwa hiyo wakala hawezi kutumia tena idhini kwa chapisho la pili. Seva inabaki wazi wakati wa kusitishwa kwa sababu kitanzi kinaendeshwa ndani ya block yake ya async with. Kwa mapitio yanayochukua saa kadhaa, SDK inaweza kuhifadhi state kama JSON na kuipakia tena baadaye kwa 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_outputMaoni ya TikTok au DM ya Instagram huanzisha vipi run?
Kupitia njia yako mwenyewe ya HTTPS, kwa sababu wakala husikia tu kile anachokiomba kutoka seva ya MCP. set_social_webhook_destination huelekeza maoni, kutajwa na DM za akaunti kwenye njia hiyo na hurudisha siri ya kutia sahihi mara moja; akaunti za TikTok husambaza maoni. Njia hiyo huangalia X-EC-Signature, HMAC-SHA256 ya timestamp, nukta, na mwili ghafi, hujibu ndani ya sekunde 8 za easyCoexistence na kuweka tukio kwenye foleni. Kisha mfanyakazi huita Runner.run na tukio kama ingizo. Kwa DM, kipindi kinachotambuliwa kwa akaunti na mtumaji huendeleza mazungumzo; maoni ya TikTok yanahitaji maoni yenyewe na video yake pekee, kwa hiyo yanaweza kuendeshwa bila moja.
Wakala apaswe kuambiwa nini kuhusu kila mtandao katika maagizo yake?
Kanuni ambazo API ya kila mtandao huzitumia kwa akaunti, zilizoandikwa mahali modeli inapozisoma:
- TikTok:
reply_to_commenthuchapisha hadharani na inahitaji ID ya video kamapost_id;send_social_dmhukataa akaunti za TikTok. - Kiasi cha TikTok: hadi miito 40 kwa dakika kwa kila akaunti kwenye endpoint ya majibu, na majibu mengi yanayofanana karibu kwa muda mfupi yanaweza kufichwa kama barua taka.
- DM za Instagram: majibu kwa watu waliotuma ujumbe ndani ya saa 24 zilizopita pekee, katika maandishi ya UTF-8 yasiyozidi baiti 1,000.
- WhatsApp:
send_messagendani ya saa 24 tangu ujumbe wa mwisho wa mteja, nasend_templateyenye kiolezo kilichoidhinishwa vinginevyo. - Muda:
scheduled_atinapokea ISO 8601 yenye saa za eneo, dakika 1 hadi siku 90 mbele, nalist_scheduled_postshuonyesha foleni.
Je, wakala anaweza kutumia HostedMCPTool, au kufanya kazi bila kuingia?
Vyote viwili, lakini kwa mabadilishano. HostedMCPTool hukabidhi seva kwa Responses API, ambayo zana yake ya MCP inachukua tokeni ya ufikiaji ya OAuth katika authorization na inaihitaji katika kila ombi, kwa sababu OpenAI haiihifadhi; tokeni ya ufikiaji ya easyCoexistence hudumu saa moja, kwa hiyo msimbo wako huihuisha kabla ya kila run. Kwa kazi isiyo na mtu wa kuingia, ruka MCP: zana za kazi zinazoita Partner API kwa ufunguo wa ec_live_ zinaweza kuweka machapisho kwenye foleni kupitia POST /api/v1/channels/:id/posts na kupata tokeni mpya za TikTok, YouTube na LinkedIn kutoka GET /api/v1/channels/:id?credentials=1, wakati kanuni za maoni na mifumo otomatiki hujibu kwenye easyCoexistence bila wakala kuendeshwa.
Makosa ya kawaida
- Kuendelea kutumia client_session_timeout_seconds ya sekunde 5 kwa uchapishaji. Uchapishaji husubiri API ya mtandao, kwa hiyo wito wa polepole unaweza kuisha muda kwenye wakala baada ya easyCoexistence kuwa tayari imelipeleka chapisho kwa mtandao; ruhusu dakika moja, na angalia list_scheduled_posts kabla ya kujaribu tena.
- Kutuma external_id kama account_id. Zana zinachukua account_id, kitambulisho cha easyCoexistence cha akaunti; external_id ni kitambulisho cha akaunti yenyewe kwenye Instagram, TikTok au Facebook.
- Kuidhinisha vizuizi kwa kitanzi bila mtu ndani yake. require_approval inalinda uchapishaji tu pale mtu, au kanuni unayoiamini, anapoamua kila wito unaosubiri.
- Kumlisha wakala shughuli za akaunti yake yenyewe. Instagram hurudisha DM za akaunti kama mwangwi (echoes) zenye is_echo true na maoni yake ya hadharani kama maoni mapya; chuja zote mbili kabla ya Runner.run.
easyCoexistence inawapa wakala wako wa OpenAI Agents SDK ufikiaji wa wateja kwenye WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn na njia nyingine zaidi, kila moja kupitia API yake rasmi: seva ya MCP inayoingia kwa OAuth, matukio yaliyotiwa sahihi kwa maoni na DM, na Partner API kwa kazi zinazoendeshwa bila mtu, huku kila muunganisho ukifuatiliwa 24/7. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unavyoongeza muunganisho, na siku 3 za kwanza ni bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, wakala anahitaji ufunguo wa API kutoka easyCoexistence?
Si kwa MCP. Kuingia kwa OAuth humpa wakala tokeni zake mwenyewe; ufunguo wa ec_live_ kutoka dashboard ni kwa msimbo unaoita Partner API badala ya seva ya MCP.
Je, wakala huyo huyo anaweza kujibu ujumbe wa WhatsApp?
Ndiyo, kwa zana za nambari hiyo: list_numbers kwa connection_id, send_message ndani ya saa 24 tangu ujumbe wa mwisho wa mteja, na send_template nje ya muda huo. Mwongozo wa OpenAI Agents SDK wa WhatsApp unaeleza jinsi ya kupokea ujumbe.
Ni modeli gani wakala anatumia?
Ile unayompa Agent. Zana za MCP hufanya kazi kwa njia ile ile bila kujali modeli ambayo SDK inaendesha; matumizi ya modeli hulipwa kwa mtoaji wake, na easyCoexistence hutoza kwa kila muunganisho.
easyCoexistence inagharimu kiasi gani kwa wakala wa OpenAI Agents SDK?
US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unavyoongeza muunganisho, sawa kwa kila mtandao. Seva ya MCP, matukio yanayosambazwa na Partner API vimejumuishwa, na siku 3 za kwanza ni bila malipo.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye