Daj agentowi OpenAI Agents SDK narzędzia do Instagrama, TikTok i WhatsApp
Agent OpenAI Agents SDK otrzymuje kanały Instagram, TikTok, WhatsApp i inne jako narzędzia przez MCPServerStreamableHttp, wskazany na https://easycoexistence.com/api/mcp, z OAuthClientProvider z MCP Python SDK jako obsługą uwierzytelniania. Filtr narzędzi zawęża ponad 35 narzędzi do zadania, require_approval wstrzymuje publikowanie do zatwierdzenia przez człowieka, a każde wywołanie trafia do sieci przez jej oficjalne API.
Co MCPServerStreamableHttp przyjmuje w params["auth"] w MCP Python SDK v2; w v1 przyjmuje httpx.Auth.
Zakres pakietu mcp, od którego zależy Agents SDK, obejmujący obie główne wersje MCP Python SDK.
Gdzie wstrzymany run wymienia wywołania narzędzi czekające na zatwierdzenie, które RunState zatwierdza lub odrzuca przed wznowieniem Runner.run.
Jak często narzędzie MCP w Responses API musi otrzymać swój token OAuth w authorization; OpenAI nie przechowuje tej wartości.
Ile wywołań TikTok dopuszcza na autoryzowane konto w każdym endpoincie Accounts API, łącznie z odpowiedziami na komentarze.
Jak agent Agents SDK łączy się z easyCoexistence?
Przez MCPServerStreamableHttp, z OAuthClientProvider z MCP Python SDK w params["auth"]. Agents SDK przekazuje ten handler do klienta HTTP, który sam buduje, więc provider wykrywa serwer autoryzacji easyCoexistence, rejestruje twojego agenta jako klienta publicznego, przeprowadza jedno logowanie w przeglądarce z PKCE i odświeża tokeny dostępu, ważne godzinę, tokenem odświeżania. Przykład używa MCP Python SDK v2, gdzie handler musi być httpx2.Auth, a provider nim jest. Obiekt storage przechowuje rejestrację i tokeny między uruchomieniami; poniższy plik zastępuje magazyn sekretów. create_static_tool_filter wskazuje narzędzia, które agent może widzieć, a require_approval nazywa te, które czekają na człowieka.
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}},
)Jak utrzymać publikowanie za zgodą człowieka?
Przez require_approval na serwerze, który wstrzymuje run przed wykonaniem nazwanego narzędzia. Run wraca wtedy z interruptions zamiast końcowej odpowiedzi: zamień wynik w RunState, zatwierdź lub odrzuć każde oczekujące wywołanie i ponownie wywołaj Runner.run z tym samym agentem i stanem. Gdy always_approve pozostaje False, każde „tak” obejmuje jedno wywołanie, więc agent nie może użyć zatwierdzenia do drugiego posta. Serwer pozostaje otwarty w trakcie wstrzymania, bo pętla działa wewnątrz jego bloku async with. Przy przeglądzie trwającym godzinami SDK może zapisać stan jako JSON i wczytać go później przez 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_outputJak komentarz w TikToku albo DM na Instagramie uruchamia run?
Przez własną trasę HTTPS, bo agent słyszy tylko to, o co sam poprosi serwer MCP. set_social_webhook_destination kieruje komentarze, wzmianki i DM konta na trasę i zwraca sekret podpisu jednorazowo; konta TikTok przekazują komentarze. Trasa sprawdza X-EC-Signature, czyli HMAC-SHA256 znacznika czasu, kropki i surowego ciała, odpowiada w limicie 8 sekund easyCoexistence i kolejkuje zdarzenie. Worker następnie wywołuje Runner.run ze zdarzeniem jako wejściem. Dla DM sesja kluczowana kontem i nadawcą podtrzymuje rozmowę; komentarz w TikToku potrzebuje tylko komentarza i jego filmu, więc może działać bez niego.
Co instrukcje agenta powinny mówić o każdej sieci?
Reguły, które API każdej sieci stosuje do konta, zapisane tam, gdzie czyta je model:
- TikTok:
reply_to_commentpublikuje publicznie i wymaga ID filmu jakopost_id;send_social_dmodrzuca konta TikTok. - Wolumen TikTok: do 40 wywołań na minutę na konto w endpoincie odpowiedzi; wiele niemal identycznych odpowiedzi w krótkim czasie może zostać ukryte jako spam.
- DM na Instagramie: odpowiedzi tylko osobom, które napisały w ciągu ostatnich 24 godzin, w tekście UTF-8 do 1 000 bajtów.
- WhatsApp:
send_messagew ciągu 24 godzin od ostatniej wiadomości klienta, a poza tym oknemsend_templatez zatwierdzonym szablonem. - Czas:
scheduled_atprzyjmuje ISO 8601 ze strefą czasową, od 1 minuty do 90 dni naprzód, alist_scheduled_postspokazuje kolejkę.
Czy agent może użyć HostedMCPTool albo działać bez logowania?
Oba, z kompromisami. HostedMCPTool przekazuje serwer do Responses API, którego narzędzie MCP przyjmuje token dostępu OAuth w authorization i wymaga go w każdym żądaniu, bo OpenAI go nie przechowuje; token dostępu easyCoexistence jest ważny godzinę, więc twój kod odświeża go przed każdym runem. Przy zadaniu bez osoby do zalogowania pomiń MCP: narzędzia funkcyjne wywołujące Partner API kluczem ec_live_ mogą kolejkować posty przez POST /api/v1/channels/:id/posts i pobierać świeże tokeny TikTok, YouTube i LinkedIn z GET /api/v1/channels/:id?credentials=1, a reguły komentarzy i automatyzacje odpowiadają w easyCoexistence bez działającego agenta.
Typowe błędy
- Zostawienie 5-sekundowego client_session_timeout_seconds przy publikowaniu. Publikacja czeka na API sieci, więc wolne wywołanie może przekroczyć limit czasu w agencie, zanim easyCoexistence przekaże post dalej; ustaw minutę i sprawdź list_scheduled_posts przed ponowieniem.
- Przekazywanie external_id jako account_id. Narzędzia przyjmują account_id, czyli ID konta w easyCoexistence; external_id to własne ID konta na Instagramie, TikToku lub Facebooku.
- Zatwierdzanie interruptions w pętli bez człowieka. require_approval chroni publikowanie tylko wtedy, gdy człowiek albo zaufana przez ciebie reguła decyduje o każdym oczekującym wywołaniu.
- Podawanie agentowi własnej aktywności konta. Instagram zwraca DM konta jako echa z is_echo true, a publiczne odpowiedzi jako nowe komentarze; odfiltruj jedno i drugie przed Runner.run.
easyCoexistence daje twoim agentom OpenAI Agents SDK zasięg do klientów na WhatsApp, Instagramie, Facebooku, TikToku, YouTube, LinkedIn i w kolejnych kanałach, każdym przez jego oficjalne API: serwer MCP logujący się przez OAuth, podpisane zdarzenia dla komentarzy i DM oraz Partner API do zadań działających bez nadzoru, z monitorowaniem każdego połączenia 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy agent potrzebuje klucza API od easyCoexistence?
Nie dla MCP. Logowanie OAuth wystawia agentowi własne tokeny; klucz ec_live_ z panelu służy tylko kodowi, który wywołuje Partner API zamiast serwera MCP.
Czy ten sam agent może odpowiadać na wiadomości WhatsApp?
Tak, narzędziami numeru: list_numbers daje connection_id, send_message działa w ciągu 24 godzin od ostatniej wiadomości klienta, a send_template poza tym oknem. Przewodnik OpenAI Agents SDK dla WhatsApp opisuje odbieranie wiadomości.
Którego modelu używa agent?
Tego, który podasz w obiekcie Agent. Narzędzia MCP działają tak samo, niezależnie od modelu, na którym działa SDK; zużycie modelu rozlicza jego dostawca, a easyCoexistence pobiera opłatę za połączenie.
Ile kosztuje easyCoexistence dla agenta OpenAI Agents SDK?
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, tak samo w każdej sieci. Serwer MCP, przekazywane zdarzenia i Partner API są w cenie, a pierwsze 3 dni są bezpłatne.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w