OpenAI Agents SDK کے ایجنٹ کو Instagram، TikTok اور WhatsApp کے ٹولز دیں
OpenAI Agents SDK کا ایجنٹ MCPServerStreamableHttp کے ذریعے https://easycoexistence.com/api/mcp سے جڑ کر Instagram، TikTok، WhatsApp اور دیگر چینلز کو ٹولز کے طور پر حاصل کرتا ہے، جبکہ اس کا auth ہینڈلر MCP Python SDK کا OAuthClientProvider ہے۔ ٹول فلٹر 35 سے زیادہ ٹولز کو کام کے مطابق محدود کرتا ہے، require_approval پبلشنگ کو کسی شخص کی منظوری تک روکے رکھتا ہے، اور ہر کال اپنے سرکاری API کے ذریعے نیٹ ورک تک پہنچتی ہے۔
MCP Python SDK v2 کے ساتھ MCPServerStreamableHttp params["auth"] میں کیا لیتا ہے؛ v1 کے ساتھ یہ httpx.Auth لیتا ہے۔
وہ mcp پیکج رینج جس پر Agents SDK انحصار کرتا ہے، جو MCP Python SDK کے دونوں بڑے ورژنز کا احاطہ کرتی ہے۔
وہ جگہ جہاں روکا گیا رن منظوری کے منتظر ٹول کالز کی فہرست دکھاتا ہے، جنہیں RunState منظور یا مسترد کرتا ہے، اس سے پہلے کہ Runner.run دوبارہ شروع ہو۔
Responses API کے MCP ٹول کو اپنا OAuth ٹوکن authorization میں کتنی بار بھیجنا ضروری ہے؛ OpenAI یہ قدر محفوظ نہیں کرتا۔
TikTok ہر مجاز اکاؤنٹ کے لیے ہر Accounts API اینڈ پوائنٹ پر کتنی کالز کی اجازت دیتا ہے، جن میں کمنٹ کے جوابات بھی شامل ہیں۔
Agents SDK کا ایجنٹ easyCoexistence سے کیسے جڑتا ہے؟
MCPServerStreamableHttp کے ذریعے، جس کے params["auth"] میں MCP Python SDK کا OAuthClientProvider ہوتا ہے۔ Agents SDK یہ ہینڈلر اس HTTP کلائنٹ کو دیتا ہے جو وہ بناتا ہے، چنانچہ provider easyCoexistence کا authorization سرور تلاش کرتا ہے، آپ کے ایجنٹ کو ایک public کلائنٹ کے طور پر رجسٹر کرتا ہے، PKCE کے ساتھ ایک بار براؤزر سائن ان چلاتا ہے، اور ایک گھنٹے والے رسائی ٹوکنز کو refresh ٹوکن سے تازہ کرتا ہے۔ مثال MCP Python SDK v2 استعمال کرتی ہے، جہاں ہینڈلر کو httpx2.Auth ہونا لازمی ہے، اور provider ایسا ہی ہے۔ ایک storage آبجیکٹ رجسٹریشن اور ٹوکنز کو رنز کے درمیان محفوظ رکھتا ہے؛ نیچے کی فائل ایک secret store کی جگہ لیتی ہے۔ 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 کسی اکاؤنٹ کے کمنٹس، mentions اور DMs کو اس روٹ پر بھیجتا ہے اور ایک بار signing secret واپس کرتا ہے؛ TikTok اکاؤنٹس کمنٹس فارورڈ کرتے ہیں۔ روٹ X-EC-Signature کی جانچ کرتا ہے، یعنی timestamp، ایک نقطہ اور خام body کا HMAC-SHA256، 8 سیکنڈ کے اندر جواب دیتا ہے، جو easyCoexistence کی حد ہے، اور ایونٹ کو قطار میں ڈال دیتا ہے۔ اس کے بعد ایک worker ایونٹ کو ان پٹ کے طور پر دے کر Runner.run کال کرتا ہے۔ DMs کے لیے، اکاؤنٹ اور بھیجنے والے پر مبنی سیشن گفتگو جاری رکھتا ہے؛ TikTok کمنٹ کو صرف کمنٹ اور اس کی ویڈیو درکار ہوتی ہے، اس لیے وہ اس کے بغیر بھی چل سکتا ہے۔
ایجنٹ کی ہدایات میں ہر نیٹ ورک کے بارے میں کیا لکھا جائے؟
ان اصولوں کو جو ہر نیٹ ورک کا API اکاؤنٹ پر لاگو کرتا ہے، ایسی جگہ لکھیں جہاں ماڈل انہیں پڑھتا ہے:
- TikTok:
reply_to_commentعوامی طور پر پوسٹ کرتا ہے اور ویڈیو کا ID بطورpost_idچاہتا ہے؛send_social_dmTikTok اکاؤنٹس کو مسترد کرتا ہے - TikTok حجم: reply اینڈ پوائنٹ پر فی اکاؤنٹ 40 کالز فی منٹ تک، اور کم وقت میں بہت سے ملتے جلتے جوابات کو اسپام کے طور پر چھپایا جا سکتا ہے
- Instagram DMs: صرف ان لوگوں کو جواب دیں جنہوں نے پچھلے 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 چھوڑ دیں: function ٹولز جو ec_live_ کلید کے ساتھ Partner API کو کال کرتے ہیں، 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 ہے
- کسی انسان کے بغیر لوپ میں ہر interruption کو منظور کرنا۔ require_approval پبلشنگ کی حفاظت صرف تب کرتا ہے جب ہر زیر التوا کال پر کوئی انسان، یا آپ کا قابلِ اعتماد قاعدہ، فیصلہ کرے
- ایجنٹ کو اکاؤنٹ کی اپنی سرگرمی دینا۔ Instagram DMs کو is_echo true کے ساتھ echoes کے طور پر، اور اکاؤنٹ کے عوامی جوابات کو نئے کمنٹس کے طور پر واپس کرتا ہے؛ Runner.run سے پہلے دونوں کو فلٹر کریں
easyCoexistence آپ کے OpenAI Agents SDK ایجنٹس کو WhatsApp، Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز تک رسائی دیتا ہے، ہر ایک اپنے سرکاری API کے ذریعے: OAuth سے سائن ان کرنے والا MCP سرور، کمنٹس اور DMs کے دستخط شدہ ایونٹس، اور بغیر نگرانی والے کاموں کے لیے 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 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ