একটি OpenAI Agents SDK এজেন্টকে Instagram, TikTok ও WhatsApp-এর টুল দিন
একটি OpenAI Agents SDK এজেন্ট https://easycoexistence.com/api/mcp-এ নির্দেশিত MCPServerStreamableHttp-এর মাধ্যমে 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 ক্লায়েন্টে পাস করে, তাই প্রোভাইডার 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 কমেন্ট বা 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 লাগে; TikTok অ্যাকাউন্টের জন্যsend_social_dmপ্রত্যাখ্যান করে। - 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-এ উত্তর দেয়।
সাধারণ ভুলগুলো
- 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, আর তার বাইরে 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 পর্যবেক্ষণ
যাচাই করা হয়েছে