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