OpenAI Agents SDK एजेंट को Instagram, TikTok और WhatsApp के टूल दें
एक OpenAI Agents SDK एजेंट को MCPServerStreamableHttp के ज़रिए https://easycoexistence.com/api/mcp से जोड़ा जाता है, और उसका प्रमाणीकरण हैंडलर MCP Python SDK का OAuthClientProvider होता है। Instagram, TikTok, WhatsApp और अन्य चैनल टूल के रूप में मिलते हैं। एक टूल फ़िल्टर 35+ टूल को काम के हिसाब से सीमित करता है, require_approval पोस्ट प्रकाशन को किसी व्यक्ति की मंज़ूरी तक रोकता है, और हर कॉल अपने नेटवर्क तक उसके आधिकारिक एपीआई के ज़रिए पहुँचती है।
MCP Python SDK v2 के साथ MCPServerStreamableHttp params["auth"] में क्या लेता है; v1 के साथ यह httpx.Auth लेता है।
mcp पैकेज की वह रेंज जिस पर Agents SDK निर्भर है, जिसमें MCP Python SDK के दोनों मेजर वर्ज़न शामिल हैं।
रोका गया रन बताता है कि कौन सी टूल कॉल की मंज़ूरी बाकी है, जिसे RunState मंज़ूर या अस्वीकार करता है, उसके बाद Runner.run फिर शुरू होता है।
Responses एपीआई के MCP टूल को उसका OAuth टोकन authorization में कितनी बार भेजना होता है; OpenAI यह मान स्टोर नहीं करता।
TikTok हर अधिकृत खाते को TikTok Accounts एपीआई के हर एंडपॉइंट पर कितनी कॉल की अनुमति देता है, टिप्पणी के जवाब सहित।
एक Agents SDK एजेंट easyCoexistence से कैसे जुड़ता है?
MCPServerStreamableHttp के ज़रिए, जिसमें params["auth"] में MCP Python SDK का OAuthClientProvider होता है। Agents SDK यह हैंडलर उस HTTP क्लाइंट को देता है जो वह बनाता है, इसलिए प्रोवाइडर easyCoexistence का authorization server खोजता है, आपके एजेंट को सार्वजनिक क्लाइंट के रूप में रजिस्टर करता है, 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 के ज़रिए, जो किसी नामित टूल के चलने से पहले रन को रोक देता है। फिर रन अंतिम उत्तर की जगह इंटरप्शन के साथ लौटता है: परिणाम को 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_outputTikTok कमेंट या Instagram DM से रन कैसे शुरू होता है?
आपके अपने HTTPS रूट के ज़रिए, क्योंकि एजेंट केवल वही सुनता है जो वह MCP सर्वर से माँगता है। set_social_webhook_destination किसी खाते की टिप्पणियाँ, मेंशन और DM इस रूट के वेबहुक डेस्टिनेशन पर भेजता है और साइनिंग सीक्रेट एक बार लौटाता है; TikTok खाते टिप्पणियाँ आगे भेजते हैं। रूट X-EC-Signature जाँचता है, जो टाइमस्टैम्प, एक डॉट और रॉ बॉडी का HMAC-SHA256 है, easyCoexistence की 8 सेकंड की सीमा के भीतर जवाब देता है और इवेंट को कतार में डालता है। फिर एक वर्कर इवेंट को इनपुट बनाकर Runner.run कॉल करता है। DM के लिए, खाते और भेजने वाले पर आधारित सेशन बातचीत को जारी रखता है; TikTok कमेंट को केवल कमेंट और उसका वीडियो चाहिए, इसलिए वह उसके बिना भी चल सकता है।
एजेंट के निर्देशों में हर नेटवर्क के बारे में क्या लिखें?
हर नेटवर्क के एपीआई नियम जो खाते पर लागू होते हैं, उस जगह लिखे गए हैं जहाँ मॉडल उन्हें पढ़ता है:
- TikTok:
reply_to_commentसार्वजनिक रूप से पोस्ट करता है औरpost_idके रूप में वीडियो का ID माँगता है;send_social_dmTikTok खातों को अस्वीकार करता है। - TikTok की मात्रा: रिप्लाई एंडपॉइंट पर प्रति खाता प्रति मिनट 40 कॉल तक, और छोटे समय में बहुत सारे लगभग एक जैसे जवाब को स्पैम मानकर छिपाया जा सकता है।
- Instagram DM: केवल उन लोगों को जवाब जो पिछले 24 घंटों में लिखे हैं, अधिकतम 1,000 बाइट UTF-8 टेक्स्ट में।
- WhatsApp: ग्राहक के आखिरी मैसेज के 24 घंटों के भीतर
send_message, और उसके बाद अनुमोदित टेम्पलेट के साथsend_template। - समय:
scheduled_atटाइमज़ोन सहित ISO 8601 लेता है, अभी से 1 मिनट से 90 दिन आगे तक, औरlist_scheduled_postsकतार दिखाता है।
क्या एजेंट HostedMCPTool इस्तेमाल कर सकता है, या बिना लॉग इन के चल सकता है?
दोनों संभव हैं, पर इनमें ट्रेड-ऑफ़ हैं। HostedMCPTool सर्वर को Responses एपीआई को सौंपता है, जिसका MCP टूल authorization में OAuth एक्सेस टोकन लेता है और हर अनुरोध में उसकी ज़रूरत होती है, क्योंकि OpenAI उसे स्टोर नहीं करता; easyCoexistence का एक्सेस टोकन एक घंटे चलता है, इसलिए आपका कोड हर रन से पहले उसे रीफ़्रेश करता है। ऐसे काम के लिए जिसमें लॉग इन करने वाला कोई न हो, MCP छोड़ दें: ec_live_ कुंजी वाले फ़ंक्शन टूल Partner एपीआई को कॉल कर सकते हैं, POST /api/v1/channels/:id/posts से पोस्ट कतार में डाल सकते हैं और GET /api/v1/channels/:id?credentials=1 से ताज़ा TikTok, YouTube और LinkedIn टोकन ले सकते हैं, जबकि कमेंट नियम और ऑटोमेशन बिना किसी एजेंट के चले easyCoexistence पर ही जवाब देते हैं।
आम गड़बड़ियाँ
- पब्लिशिंग के लिए 5 सेकंड वाला client_session_timeout_seconds रखना। प्रकाशन नेटवर्क के एपीआई का इंतज़ार करता है, इसलिए धीमी कॉल एजेंट में टाइमआउट हो सकती है, जबकि easyCoexistence पोस्ट आगे भेज चुका होता है; एक मिनट दें, और दोबारा कोशिश से पहले list_scheduled_posts जाँचें।
- external_id को account_id के रूप में पास करना। टूल account_id लेते हैं, जो easyCoexistence का खाता ID है; external_id उस खाते का अपना ID है Instagram, TikTok या Facebook पर।
- बिना किसी व्यक्ति के लूप में इंटरप्शन मंज़ूर करना। require_approval प्रकाशन की रक्षा तभी करता है जब हर लंबित कॉल पर कोई इंसान, या कोई आप पर भरोसे वाला नियम, फैसला लेता है।
- एजेंट को खाते की अपनी गतिविधि खिलाना। Instagram खाते के DM को is_echo true के साथ इको के रूप में और उसके सार्वजनिक जवाबों को नई टिप्पणियों के रूप में लौटाता है; Runner.run से पहले दोनों को फ़िल्टर करें।
easyCoexistence आपके OpenAI Agents SDK एजेंट्स को WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn और अन्य चैनल तक पहुँच देता है, हर एक उसके आधिकारिक एपीआई के ज़रिए: OAuth से लॉग इन होने वाला MCP सर्वर, कमेंट और DM के साइन किए गए इवेंट, और बिना निगरानी चलने वाले कामों के लिए Partner एपीआई, जिसमें हर कनेक्शन 24/7 निगरानी में रहता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे आप कनेक्शन जोड़ते हैं वैसे घटता है, और पहले 3 दिन मुफ़्त हैं।
अक्सर पूछे जाने वाले सवाल
क्या एजेंट को easyCoexistence से एपीआई कुंजी चाहिए?
MCP के लिए नहीं। OAuth लॉग इन एजेंट को उसके अपने टोकन देता है; डैशबोर्ड की ec_live_ कुंजी केवल उस कोड के लिए है जो MCP सर्वर की जगह Partner एपीआई को कॉल करता है।
क्या वही एजेंट WhatsApp मैसेज का जवाब दे सकता है?
हाँ, नंबर के टूल के साथ: connection_id के लिए list_numbers, ग्राहक के आखिरी मैसेज के 24 घंटों के भीतर send_message, और उसके बाहर send_template। OpenAI Agents SDK की WhatsApp गाइड मैसेज प्राप्त करने को कवर करती है।
एजेंट कौन सा मॉडल इस्तेमाल करता है?
वह जो आप Agent को देते हैं। MCP टूल किसी भी मॉडल के साथ एक जैसे काम करते हैं, मॉडल का उपयोग उसका प्रदाता बिल करता है, और easyCoexistence कनेक्शन के हिसाब से शुल्क लेता है।
OpenAI Agents SDK एजेंट के लिए easyCoexistence की लागत कितनी है?
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन बढ़ते हैं घटता है, हर नेटवर्क पर एक जैसा। MCP सर्वर, भेजे गए इवेंट और Partner एपीआई इसमें शामिल हैं, और पहले 3 दिन मुफ़्त हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित