Einem OpenAI-Agents-SDK-Agenten Tools für Instagram, TikTok und WhatsApp geben
Ein OpenAI-Agents-SDK-Agent erhält Instagram, TikTok, WhatsApp und weitere Kanäle als Tools über MCPServerStreamableHttp, das auf https://easycoexistence.com/api/mcp zeigt, mit dem OAuthClientProvider des MCP Python SDK als Auth-Handler. Ein Tool-Filter reduziert die 35+ Tools auf die jeweilige Aufgabe, require_approval hält Veröffentlichungen zurück, bis eine Person sie freigibt, und jeder Aufruf erreicht das Netzwerk über dessen offizielle API.
Was MCPServerStreamableHttp mit MCP Python SDK v2 in params["auth"] entgegennimmt; mit v1 ist es ein httpx.Auth.
Der Versionsbereich des mcp-Pakets, von dem das Agents SDK abhängt und der beide Hauptversionen des MCP Python SDK abdeckt.
Wo ein pausierter Lauf die Tool-Aufrufe auflistet, die auf Freigabe warten; ein RunState genehmigt oder lehnt sie ab, bevor Runner.run fortgesetzt wird.
Wie oft dem MCP-Tool der Responses API das OAuth-Token im Feld authorization übergeben werden muss; OpenAI speichert den Wert nicht.
Aufrufe, die TikTok pro autorisiertem Konto an jedem Endpoint der Accounts-API erlaubt, einschließlich Kommentar-Antworten.
Wie verbindet sich ein OpenAI-Agents-SDK-Agent mit easyCoexistence?
Über MCPServerStreamableHttp, mit dem OAuthClientProvider des MCP Python SDK in params["auth"]. Das Agents SDK übergibt diesen Handler an den HTTP-Client, den es erstellt. So findet der Provider den Autorisierungsserver von easyCoexistence, registriert Ihren Agenten als öffentlichen Client, führt einmal eine Anmeldung im Browser mit PKCE durch und erneuert die einstündigen Zugriffstoken mit dem Refresh-Token. Das Beispiel verwendet MCP Python SDK v2, wo der Handler ein httpx2.Auth sein muss, und das ist der Provider. Ein Storage-Objekt bewahrt die Registrierung und die Token zwischen den Läufen auf; die Datei unten ersetzt einen Secret-Store. create_static_tool_filter listet die Tools auf, die der Agent sehen darf, und require_approval benennt diejenigen, die auf eine Person warten.
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}},
)Wie halten Sie die Veröffentlichung hinter der Freigabe einer Person?
Mit require_approval auf dem Server, der den Lauf vor der Ausführung eines benannten Tools anhält. Der Lauf kehrt dann mit interruptions statt einer Endantwort zurück: Wandeln Sie das Ergebnis in einen RunState um, genehmigen oder lehnen Sie jeden ausstehenden Aufruf ab und rufen Sie Runner.run erneut mit demselben Agenten und dem Zustand auf. Bleibt always_approve auf False, deckt jedes Ja genau einen Aufruf ab, sodass der Agent eine Freigabe nicht für einen zweiten Post wiederverwenden kann. Der Server bleibt während der Pause geöffnet, weil die Schleife innerhalb seines async-with-Blocks läuft. Für eine Prüfung, die Stunden dauert, kann das SDK den Zustand als JSON speichern und später mit RunState.from_json wieder laden.
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_outputWie startet ein TikTok-Kommentar oder eine Instagram-DM einen Lauf?
Über Ihre eigene HTTPS-Route, denn der Agent hört nur das, was er beim MCP-Server anfordert. set_social_webhook_destination richtet die Kommentare, Erwähnungen und DMs eines Kontos auf die Route aus und gibt ein Signatur-Secret einmal zurück; TikTok-Konten leiten Kommentare weiter. Die Route prüft X-EC-Signature, einen HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body, antwortet innerhalb der 8 Sekunden von easyCoexistence und reiht das Ereignis in eine Warteschlange ein. Ein Worker ruft dann Runner.run mit dem Ereignis als Eingabe auf. Bei DMs hält eine Sitzung, die über Konto und Absender identifiziert wird, die Unterhaltung am Laufen. Ein TikTok-Kommentar braucht nur den Kommentar und sein Video, daher kann er ohne Sitzung laufen.
Was sollen die Anweisungen des Agenten zu jedem Netzwerk sagen?
Die Regeln, die die API jedes Netzwerks auf das Konto anwendet, geschrieben dort, wo das Modell sie liest:
- TikTok:
reply_to_commentveröffentlicht öffentlich und braucht die ID des Videos alspost_id;send_social_dmlehnt TikTok-Konten ab. - TikTok-Volumen: bis zu 40 Aufrufe pro Minute und Konto am Antwort-Endpoint, und viele nahezu identische Antworten in kurzer Zeit können als Spam ausgeblendet werden.
- Instagram-DMs: Antworten nur an Personen, die in den letzten 24 Stunden geschrieben haben, mit höchstens 1,000 Bytes UTF-8-Text.
- WhatsApp:
send_messageinnerhalb von 24 Stunden nach der letzten Nachricht des Kunden, und sonstsend_templatemit einem genehmigten Template. - Timing:
scheduled_atnimmt ISO 8601 mit einer Zeitzone entgegen, 1 Minute bis 90 Tage im Voraus, undlist_scheduled_postszeigt die Warteschlange.
Kann der Agent HostedMCPTool nutzen oder ohne Anmeldung laufen?
Beides, mit Abwägungen. HostedMCPTool übergibt den Server an die Responses API, deren MCP-Tool ein OAuth-Zugriffstoken im Feld authorization entgegennimmt und es bei jeder Anfrage braucht, da OpenAI es nicht speichert. Ein Zugriffstoken von easyCoexistence gilt eine Stunde, daher erneuert Ihr Code es vor jedem Lauf. Für eine Aufgabe ohne Person, die sich anmeldet, lassen Sie MCP weg: Function-Tools, die die Partner API mit einem ec_live_-Schlüssel aufrufen, können Posts über POST /api/v1/channels/:id/posts einreihen und frische TikTok-, YouTube- und LinkedIn-Token über GET /api/v1/channels/:id?credentials=1 abrufen. Kommentarregeln und Automatisierungen antworten dagegen bei easyCoexistence, ohne dass ein Agent läuft.
Häufige Fehler
- Den Wert client_session_timeout_seconds von 5 Sekunden für Veröffentlichungen beizubehalten. Eine Veröffentlichung wartet auf die API des Netzwerks, daher kann ein langsamer Aufruf im Agenten ein Timeout auslösen, nachdem easyCoexistence den Post bereits weitergereicht hat. Planen Sie eine Minute ein und prüfen Sie list_scheduled_posts, bevor Sie es erneut versuchen.
- external_id als account_id zu übergeben. Die Tools erwarten account_id, die ID des Kontos bei easyCoexistence; external_id ist die eigene ID des Kontos bei Instagram, TikTok oder Facebook.
- Interruptions in einer Schleife ohne Person zu genehmigen. require_approval schützt Veröffentlichungen nur, wenn ein Mensch oder eine Regel, der Sie vertrauen, über jeden ausstehenden Aufruf entscheidet.
- Dem Agenten die eigene Aktivität des Kontos zu füttern. Instagram liefert die DMs des Kontos als Echos mit is_echo true und seine öffentlichen Antworten als neue Kommentare zurück; filtern Sie beides heraus, bevor Sie Runner.run aufrufen.
easyCoexistence gibt Ihren OpenAI-Agents-SDK-Agenten Reichweite zu Kunden auf WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn und weiteren Kanälen, jeweils über deren offizielle API: ein MCP-Server, der sich per OAuth anmeldet, signierte Ereignisse für Kommentare und DMs und eine Partner API für Aufgaben, die ohne Aufsicht laufen, wobei jede Verbindung 24/7 überwacht wird. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit kostenloser Testphase von 3 Tagen.
Häufig gestellte Fragen
Braucht der Agent einen API-Schlüssel von easyCoexistence?
Für MCP nicht. Die OAuth-Anmeldung stellt dem Agenten eigene Token aus. Ein ec_live_-Schlüssel aus dem Dashboard ist nur für Code gedacht, der statt des MCP-Servers die Partner API aufruft.
Kann derselbe Agent auf WhatsApp-Nachrichten antworten?
Ja, mit den Tools der Nummer: list_numbers für die connection_id, send_message innerhalb von 24 Stunden nach der letzten Nachricht des Kunden und send_template außerhalb dieses Fensters. Der Leitfaden des OpenAI Agents SDK für WhatsApp behandelt den Empfang der Nachrichten.
Welches Modell verwendet der Agent?
Das Modell, das Sie dem Agenten übergeben. Die MCP-Tools funktionieren gleich, welches Modell das SDK auch ausführt. Die Nutzung des Modells wird von dessen Anbieter berechnet, und easyCoexistence berechnet pro Verbindung.
Was kostet easyCoexistence für einen OpenAI-Agents-SDK-Agenten?
US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, auf jedem Netzwerk gleich. MCP-Server, weitergeleitete Ereignisse und Partner API sind enthalten, und es gibt eine kostenlose Testphase von 3 Tagen.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am