Anna OpenAI Agents SDK -agentille Instagram-, TikTok- ja WhatsApp-työkalut
OpenAI Agents SDK -agentti saa Instagram-, TikTok-, WhatsApp- ja muut kanavat työkaluina MCPServerStreamableHttp-luokan kautta, joka osoittaa osoitteeseen https://easycoexistence.com/api/mcp. Todennuskäsittelijänä toimii MCP Python SDK:n OAuthClientProvider. Työkalusuodatin rajaa yli 35+ työkalua tehtävään, require_approval pitää julkaisut pidossa, kunnes henkilö hyväksyy ne, ja jokainen kutsu kulkee verkkoon kunkin alustan virallisen API:n kautta.
Mitä MCPServerStreamableHttp ottaa kohdassa params["auth"] MCP Python SDK v2:n kanssa; v1:n kanssa se ottaa httpx.Auth-olion.
Agents SDK:n riippuvuutena oleva mcp-paketin versioalue, joka kattaa molemmat MCP Python SDK:n pääversiot.
Mistä keskeytynyt ajo listaa hyväksyntää odottavat työkalukutsut, joita RunState hyväksyy tai hylkää ennen kuin Runner.run jatkaa.
Kuinka usein Responses API:n MCP-työkalulle on lähetettävä OAuth-token authorization-kentässä; OpenAI ei tallenna arvoa.
Kuinka monta kutsua TikTok sallii valtuutettua tiliä kohden kullakin Accounts API -päätepisteellä, kommenttivastaukset mukaan lukien.
Miten Agents SDK -agentti yhdistyy easyCoexistenceen?
MCPServerStreamableHttp-luokan kautta, ja params["auth"]-kentässä on MCP Python SDK:n OAuthClientProvider. Agents SDK välittää tämän käsittelijän rakentamalleen HTTP-asiakkaalle, joten provider löytää easyCoexistencen valtuutuspalvelimen, rekisteröi agenttisi julkisena asiakkaana, suorittaa kerran selaimessa tapahtuvan kirjautumisen PKCE:llä ja uusii tunnin mittaiset käyttötokenit refresh-tokenilla. Esimerkki käyttää MCP Python SDK v2:ta, jossa käsittelijän on oltava httpx2.Auth, ja provider on sellainen. Tallennusobjekti säilyttää rekisteröinnin ja tokenit ajojen välillä; alla oleva tiedosto korvaa salaisuuksien tallennuspaikan. create_static_tool_filter listaa työkalut, jotka agentti saa nähdä, ja require_approval nimeää ne, jotka odottavat henkilön hyväksyntää.
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}},
)Miten julkaisu pidetään henkilön hyväksynnän takana?
require_approval-asetuksella palvelimella, joka pysäyttää ajon ennen nimetyn työkalun suorittamista. Ajo palauttaa silloin keskeytykset lopullisen vastauksen sijaan: muunna tulos RunState-olioksi, hyväksy tai hylkää jokainen odottava kutsu ja kutsu Runner.run uudelleen samalla agentilla ja tilalla. Kun always_approve jätetään arvoon False, jokainen kyllä kattaa yhden kutsun, joten agentti ei voi käyttää samaa hyväksyntää toiseen julkaisuun. Palvelin pysyy auki tauon yli, koska silmukka kulkee sen async with -lohkon sisällä. Jos tarkastus kestää tunteja, SDK voi tallentaa tilan JSON-muodossa ja ladata sen myöhemmin RunState.from_json-funktiolla.
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_outputMiten TikTok-kommentti tai Instagram-yksityisviesti käynnistää ajon?
Oman HTTPS-reitin kautta, sillä agentti kuulee vain sen, mitä pyytää MCP-palvelimelta. set_social_webhook_destination ohjaa tilin kommentit, maininnat ja yksityisviestit reitille ja palauttaa allekirjoitusavaimen kerran; TikTok-tilit välittävät kommentit. Reitti tarkistaa X-EC-Signature-otsikon, HMAC-SHA256-tiivisteen aikaleimasta, pisteestä ja raakarungosta, vastaa easyCoexistencen 8 sekunnin aikarajan sisällä ja jonottaa tapahtuman. Työntekijä kutsuu sitten Runner.run-funktiota tapahtuma syötteenä. Yksityisviesteissä tili ja lähettäjä muodostavat istunnon, joka pitää keskustelun yllä. TikTok-kommentti tarvitsee vain kommentin ja sen videon, joten se voi toimia ilman istuntoa.
Mitä agentin ohjeissa pitäisi sanoa kustakin verkosta?
Säännöt, jotka kunkin verkon API soveltaa tiliin, kirjoitettuna kohtaan, jonka malli lukee:
- TikTok:
reply_to_commentjulkaisee julkisesti ja tarvitsee videon tunnuksenpost_id-kenttään;send_social_dmhylkää TikTok-tilit. - TikTok-volyymi: enintään 40 kutsua minuutissa tiliä kohden vastauspäätepisteellä, ja monta lähes samanlaista vastausta lyhyessä ajassa voidaan piilottaa roskapostina.
- Instagram-yksityisviestit: vastauksia vain ihmisille, jotka ovat kirjoittaneet viimeisen 24 tunnin aikana, enintään 1,000 tavua UTF-8-tekstiä.
- WhatsApp:
send_message24 tunnin sisällä asiakkaan viimeisimmästä viestistä, muulloinsend_templatehyväksytyllä viestipohjalla. - Ajoitus:
scheduled_athyväksyy ISO 8601 -muodon aikavyöhykkeellä, 1 minuutista 90 päivään eteenpäin, jalist_scheduled_postsnäyttää jonon.
Voiko agentti käyttää HostedMCPTool-työkalua tai toimia ilman kirjautumista?
Molempia, kompromisseineen. HostedMCPTool luovuttaa palvelimen Responses API:lle, jonka MCP-työkalu ottaa OAuth-käyttötokenin authorization-kentässä ja tarvitsee sen jokaisessa pyynnössä, koska OpenAI ei tallenna sitä; easyCoexistencen käyttötoken on voimassa tunnin, joten koodisi uusii sen ennen jokaista ajoa. Työhön, jossa ei ole ketään kirjautumassa, ohita MCP: funktiotyökalut, jotka kutsuvat Partner API:a ec_live_-avaimella, voivat jonottaa julkaisuja reitillä POST /api/v1/channels/:id/posts ja hakea tuoreet TikTokin, YouTuben ja LinkedInin tokenit reitiltä GET /api/v1/channels/:id?credentials=1, kun taas kommenttisäännöt ja automaatiot vastaavat easyCoexistencessä ilman, että agentti on käynnissä.
Yleiset virheet
- 5 sekunnin client_session_timeout_seconds-arvon jättäminen ennalleen julkaisuihin. Julkaisu odottaa verkon API:n vastausta, joten hidas kutsu voi aikakatkaistua agentissa sen jälkeen, kun easyCoexistence on jo välittänyt julkaisun eteenpäin; anna minuutti ja tarkista list_scheduled_posts ennen uutta yritystä.
- external_id:n antaminen account_id:n tilalle. Työkalut ottavat account_id:n, easyCoexistencen tunnuksen tilille; external_id on tilin oma tunnus Instagramissa, TikTokissa tai Facebookissa.
- Keskeytysten hyväksyminen silmukassa ilman ihmistä. require_approval suojaa julkaisuja vain silloin, kun ihminen tai sinun luottamasi sääntö päättää jokaisesta odottavasta kutsusta.
- Agentille tilin oman toiminnan syöttäminen. Instagram palauttaa tilin yksityisviestit kaikuina, joissa is_echo on true, ja sen julkiset vastaukset uusina kommentteina; suodata molemmat pois ennen Runner.run-kutsua.
easyCoexistence antaa OpenAI Agents SDK -agenteillesi ulottuvuuden asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa, kukin virallisen API:nsa kautta: MCP-palvelin, joka kirjautuu OAuthilla, allekirjoitetut tapahtumat kommenteille ja yksityisviesteille sekä Partner API tehtäville, jotka ajetaan ilman ihmisen valvontaa, ja jokaista yhteyttä valvotaan ympäri vuorokauden. US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa, ja hinta laskee lisättäessä yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Tarvitseeko agentti API-avaimen easyCoexistencestä?
Ei MCP:n kautta. OAuth-kirjautuminen antaa agentille omat tokenit; hallintapaneelin ec_live_-avain on tarkoitettu vain koodille, joka kutsuu Partner API:a MCP-palvelimen sijaan.
Voiko sama agentti vastata WhatsApp-viesteihin?
Kyllä, numeron työkaluilla: list_numbers antaa connection_id-tunnuksen, send_message 24 tunnin sisällä asiakkaan viimeisimmästä viestistä ja send_template sen ulkopuolella. OpenAI Agents SDK:n WhatsApp-opas kattaa viestien vastaanottamisen.
Mitä mallia agentti käyttää?
Sitä, jonka annat Agent-oliolle. MCP-työkalut toimivat samalla tavalla mallista riippumatta, mallin käytön laskuttaa sen palveluntarjoaja, ja easyCoexistence veloittaa yhteyttä kohden.
Paljonko easyCoexistence maksaa OpenAI Agents SDK -agentille?
US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa, hinnan laskiessa lisättäessä yhteyksiä, sama jokaisessa verkossa. MCP-palvelin, välitetyt tapahtumat ja Partner API kuuluvat hintaan, ja ensimmäiset 3 päivää ovat ilmaisia.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu