OpenAI Agents SDK एजेन्टलाई Instagram, TikTok र WhatsApp का उपकरण दिनुहोस्
OpenAI Agents SDK एजेन्टले https://easycoexistence.com/api/mcp मा MCPServerStreamableHttp मार्फत जडान गरेर Instagram, TikTok, WhatsApp र अन्य च्यानलहरू उपकरणका रूपमा पाउँछ, जसको प्रमाणीकरण ह्यान्डलर MCP Python SDK को OAuthClientProvider हो। उपकरण फिल्टरले 35+ उपकरणलाई कामअनुसार सीमित पार्छ, require_approval ले व्यक्तिले स्वीकृत नगरेसम्म प्रकाशन रोक्छ, र प्रत्येक कल आधिकारिक API मार्फत नेटवर्कमा पुग्छ।
MCP Python SDK v2 सँग MCPServerStreamableHttp ले params["auth"] मा के लिन्छ; v1 सँग यसले httpx.Auth लिन्छ।
Agents SDK ले निर्भर गर्ने mcp प्याकेजको दायरा, जसले MCP Python SDK का दुवै प्रमुख संस्करण समेट्छ।
रोकिएको रनले स्वीकृतिको पर्खाइमा रहेका उपकरण कलहरू कहाँ सूचीबद्ध गर्छ, जसलाई RunState ले Runner.run पुनः चल्नु अघि स्वीकृत वा अस्वीकृत गर्छ।
Responses API को MCP उपकरणलाई authorization मा OAuth टोकन कति पटक पठाउनुपर्छ; OpenAI ले मान भण्डारण गर्दैन।
प्रत्येक Accounts API एन्डपोइन्टमा प्रति अधिकृत खाता TikTok ले अनुमति दिने कलहरू, टिप्पणीको जवाफसमेत।
Agents SDK एजेन्टले easyCoexistence सँग कसरी जडान हुन्छ?
MCPServerStreamableHttp मार्फत, MCP Python SDK को OAuthClientProvider लाई 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_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सार्वजनिक रूपमा पोस्ट गर्छ रpost_idका रूपमा भिडियोको ID चाहिन्छ;send_social_dmले TikTok खातालाई अस्वीकार गर्छ। - 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 API लाई दिन्छ, जसको MCP उपकरणले authorization मा OAuth पहुँच टोकन लिन्छ र प्रत्येक अनुरोधमा त्यो चाहिन्छ, किनभने OpenAI ले त्यो भण्डारण गर्दैन; easyCoexistence पहुँच टोकन एक घण्टा टिक्छ, त्यसैले तपाईंको कोडले प्रत्येक रनअघि एउटा नवीकरण गर्छ। जसले साइन-इन गर्ने कोही छैन, त्यस्तो कामका लागि MCP छोड्नुहोस्: ec_live_ कुञ्जीसँग Partner API लाई कल गर्ने फङ्सन उपकरणहरूले POST /api/v1/channels/:id/posts मार्फत पोस्ट कतारमा राख्न सक्छन् र GET /api/v1/channels/:id?credentials=1 बाट ताजा TikTok, YouTube र LinkedIn का टोकन ल्याउन सक्छन्, जबकि टिप्पणी नियम र स्वचालनहरूले easyCoexistence मा कुनै एजेन्ट नचली जवाफ दिन्छन्।
सामान्य गल्तीहरू
- प्रकाशनका लागि client_session_timeout_seconds लाई 5-second मा छोड्नु। प्रकाशनले नेटवर्कको API को पर्खाइ गर्छ, त्यसैले ढिलो कलले easyCoexistence ले पोस्ट अगाडि बढाइसकेपछि एजेन्टमा टाइमआउट हुन सक्छ; एक मिनेट दिनुहोस्, र फेरि प्रयास गर्नुअघि list_scheduled_posts जाँच्नुहोस्।
- account_id का सट्टा external_id पठाउनु। उपकरणहरूले account_id लिन्छन्, जुन easyCoexistence ले खातालाई दिएको ID हो; external_id भनेको Instagram, TikTok वा Facebook मा खाताको आफ्नै ID हो।
- कुनै व्यक्ति नभएको लुपमा interruptions स्वीकृत गर्नु। 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, र त्योभन्दा बाहिर send_template। WhatsApp का लागि OpenAI Agents SDK गाइडले म्यासेज प्राप्त गर्ने कुरा समेट्छ।
एजेन्टले कुन मोडेल प्रयोग गर्छ?
तपाईंले Agent लाई दिएको मोडेल। MCP उपकरणहरू SDK ले चलाउने जुनसुकै मोडेलमा उस्तै काम गर्छन्, मोडेलको प्रयोग यसको प्रदायकले बिल गर्छ, र easyCoexistence ले प्रति जडान शुल्क लिन्छ।
OpenAI Agents SDK एजेन्टका लागि easyCoexistence को मूल्य कति हो?
प्रति जडान प्रति महिना US$ 9 देखि US$ 0.75 सम्म, जडान थप्दै जाँदा घट्दै, हरेक नेटवर्कमा उस्तै। MCP सर्भर, फर्वार्ड गरिएका घटनाहरू र Partner API यसमै समावेश छन्, र पहिलो 3 दिन निःशुल्क छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको