כלים ל-Instagram, ל-TikTok ול-WhatsApp עבור סוכן OpenAI Agents SDK
סוכן OpenAI Agents SDK מקבל את Instagram, TikTok, WhatsApp ועוד ערוצים ככלים, דרך MCPServerStreamableHttp שמופנה אל https://easycoexistence.com/api/mcp, כאשר OAuthClientProvider של MCP Python SDK משמש כמטפל האימות שלו. מסנן כלים מצמצם את 35+ הכלים למשימה, require_approval מחזיק את הפרסום עד שאדם מאשר, וכל קריאה מגיעה לרשת דרך ה-API הרשמי שלה.
מה ש-MCPServerStreamableHttp מקבל ב-params["auth"] עם MCP Python SDK v2; עם v1 הוא מקבל httpx.Auth.
טווח הגרסאות של חבילת mcp שעליה נשען Agents SDK, שמכסה את שתי הגרסאות המרכזיות של MCP Python SDK.
היכן ריצה מושהית מפרטת את קריאות הכלים הממתינות לאישור, ש-RunState מאשר או דוחה, לפני ש-Runner.run ממשיך.
באיזו תדירות צריך לשלוח את אסימון ה-OAuth ב-authorization לכלי ה-MCP של Responses API; OpenAI אינו שומר את הערך.
כמות הקריאות ש-TikTok מתירה לכל חשבון מאושר בכל נקודת הקצה של Accounts API, כולל מענה לתגובות.
איך סוכן Agents SDK מתחבר ל-easyCoexistence?
דרך MCPServerStreamableHttp, כש-OAuthClientProvider של MCP Python SDK מוגדר ב-params["auth"]. ה-Agents SDK מעביר את המטפל הזה ללקוח ה-HTTP שהוא בונה, כך שהמטפל מגלה את שרת האימות של easyCoexistence, רושם את הסוכן שלכם כלקוח ציבורי, מריץ כניסה אחת בדפדפן עם PKCE ומרענן את אסימוני הגישה, שתקפים שעה, בעזרת אסימון הרענון. הדוגמה משתמשת ב-MCP Python SDK v2, שבו המטפל חייב להיות httpx2.Auth, וזה מה שהמטפל הוא. אובייקט אחסון שומר את הרישום והאסימונים בין הרצות; הקובץ שלהלן משמש תחליף לכספת סודות. create_static_tool_filter מפרט את הכלים שהסוכן רואה, ו-require_approval מציין אילו מהם ממתינים לאישור של אדם.
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}},
)איך שומרים על פרסום מאחורי אישור של אדם?
באמצעות require_approval בשרת, שמשהה את הריצה לפני שכלי בעל שם מסוים מופעל. הריצה חוזרת אז עם interruptions במקום תשובה סופית: הופכים את התוצאה ל-RunState, מאשרים או דוחים כל קריאה ממתינה, וקוראים שוב ל-Runner.run עם אותו סוכן ואותו מצב. כש-always_approve נשאר False, כל אישור חל על קריאה אחת בלבד, כך שהסוכן לא יכול לעשות שימוש חוזר באישור לפוסט שני. השרת נשאר פתוח לאורך ההשהיה, כי הלולאה רצה בתוך הבלוק async with. לסקירה שנמשכת שעות, ה-SDK יכול לשמור את המצב כ-JSON ולטעון אותו מחדש מאוחר יותר עם 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_outputאיך תגובה ב-TikTok או הודעת DM ב-Instagram מפעילה ריצה?
דרך נתיב HTTPS משלכם, כי הסוכן שומע רק את מה שהוא מבקש משרת MCP. set_social_webhook_destination מפנה תגובות, אזכורים והודעות DM של חשבון אל הנתיב ומחזיר סוד חתימה פעם אחת בלבד; חשבונות TikTok מעבירים תגובות. הנתיב בודק את X-EC-Signature, HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי, מגיב בתוך 8 שניות של easyCoexistence ומכניס את האירוע לתור. אחר כך עובד ברקע קורא ל-Runner.run עם האירוע כקלט. בהודעות DM, סשן שמפתחו הוא החשבון והשולח שומר על השיחה; תגובה ב-TikTok צריכה רק את התגובה ואת הסרטון שלה, ולכן יכולה לרוץ בלי סשן.
מה כדאי שההוראות של הסוכן יגידו על כל רשת?
הכללים ש-API של כל רשת מחיל על החשבון, כתובים במקום שהמודל קורא אותם:
- TikTok:
reply_to_commentמפרסם בפומבי ודורש את מזהה הסרטון כ-post_id;send_social_dmמסרב לחשבונות TikTok. - נפח ב-TikTok: עד 40 קריאות בדקה לחשבון בנקודת המענה, ותשובות רבות כמעט זהות בזמן קצר עלולות להיות מסומנות כספאם ומוסתרות.
- הודעות DM ב-Instagram: תשובות רק לאנשים שכתבו בתוך 24 השעות האחרונות, עד 1,000 בייט של טקסט UTF-8.
- WhatsApp:
send_messageבתוך 24 שעות מההודעה האחרונה של הלקוח, ו-send_templateעם תבנית מאושרת בשאר המקרים. - תזמון:
scheduled_atמקבל ISO 8601 עם אזור זמן, בין דקה אחת לבין 90 ימים קדימה, ו-list_scheduled_postsמציג את התור.
האם הסוכן יכול להשתמש ב-HostedMCPTool, או לרוץ בלי כניסה?
שניהם אפשריים, עם פשרות. HostedMCPTool מעביר את השרת ל-Responses API, שכלי ה-MCP שלו מקבל אסימון גישה של OAuth ב-authorization ודורש אותו בכל בקשה, כי OpenAI אינו שומר אותו; אסימון הגישה של easyCoexistence תקף שעה, לכן הקוד שלכם מרענן אותו לפני כל ריצה. למשימה שאין בה מי שייכנס, מוותרים על MCP: כלי פונקציה שקוראים ל-Partner API עם מפתח ec_live_ יכולים להכניס פוסטים לתור דרך POST /api/v1/channels/:id/posts ולמשוך אסימוני TikTok, YouTube ו-LinkedIn טריים מ-GET /api/v1/channels/:id?credentials=1, בעוד כללי תגובות ואוטומציות עונים ב-easyCoexistence בלי שסוכן כלשהו פועל.
טעויות נפוצות
- השארת client_session_timeout_seconds על 5 שניות לפרסום. פרסום ממתין ל-API של הרשת, כך שקריאה איטית עלולה לחרוג מהזמן בסוכן אחרי ש-easyCoexistence כבר העביר את הפוסט הלאה; הקציבו דקה, ובדקו את list_scheduled_posts לפני ניסיון נוסף.
- העברת external_id כ-account_id. הכלים מקבלים account_id, המזהה של החשבון ב-easyCoexistence; external_id הוא המזהה של החשבון עצמו ב-Instagram, TikTok או Facebook.
- אישור השהיות בלולאה בלי אדם בה. require_approval מגן על הפרסום רק כאשר אדם, או כלל שאתם סומכים עליו, מחליט על כל קריאה ממתינה.
- הזנת הסוכן בפעילות של החשבון שלו. Instagram מחזיר את ההודעות הישירות של החשבון כהדים עם is_echo true ואת התגובות הציבוריות שלו כתגובות חדשות; סננו את שניהם לפני Runner.run.
easyCoexistence נותנת לסוכני OpenAI Agents SDK שלכם גישה ללקוחות ב-WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ועוד ערוצים, כל אחד דרך ה-API הרשמי שלו: שרת MCP שנכנס עם OAuth, אירועים חתומים לתגובות ולהודעות DM, ו-Partner API לעבודות שרצות בלי מפעיל, כאשר כל חיבור מנוטר 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים. 3 הימים הראשונים בחינם.
שאלות נפוצות
האם הסוכן צריך מפתח API מ-easyCoexistence?
לא עבור MCP. הכניסה דרך OAuth מנפיקה לסוכן אסימונים משלו; מפתח ec_live_ מהלוח בקרה מיועד רק לקוד שקורא ל-Partner API במקום לשרת MCP.
האם אותו סוכן יכול להשיב להודעות WhatsApp?
כן, עם כלי המספר: list_numbers לקבלת connection_id, send_message בתוך 24 שעות מההודעה האחרונה של הלקוח ו-send_template מעבר לכך. המדריך של OpenAI Agents SDK ל-WhatsApp מכסה קבלת ההודעות.
איזה מודל הסוכן משתמש בו?
כלי ה-MCP פועלים אותו דבר, בלי קשר למודל שה-SDK מריץ; השימוש במודל מחויב על ידי הספק שלו, ו-easyCoexistence גובה לפי חיבור.
כמה עולה easyCoexistence לסוכן OpenAI Agents SDK?
US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, זהה בכל רשת. שרת MCP, האירועים המועברים וה-Partner API כלולים במחיר, ו-3 הימים הראשונים הם בחינם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-