OpenAI Agents SDK agent එකකට Instagram, TikTok සහ WhatsApp tools දෙන්න
OpenAI Agents SDK agent එකට MCPServerStreamableHttp හරහා https://easycoexistence.com/api/mcp වෙත යොමු කළ විට Instagram, TikTok, WhatsApp සහ තවත් channel tools ලෙස ලැබේ. MCP Python SDK හි OAuthClientProvider එක auth handler ලෙස භාවිත වේ. tool filter එකෙන් 35+ tools කාර්යයට ගැලපෙන පරිදි සීමා කරයි, require_approval එකෙන් පළ කිරීම පුද්ගලයෙකු අනුමත කරන තෙක් රඳවයි, සෑම call එකක්ම එහි official API හරහා network එකට ළඟා වේ.
MCP Python SDK v2 සමඟ MCPServerStreamableHttp හි params["auth"] ගන්නේ කුමක්ද; v1 සමඟ එය httpx.Auth ගනී.
Agents SDK යැපෙන mcp package පරාසය, MCP Python SDK හි major versions දෙකම ආවරණය කරමින්.
Runner.run නැවත ආරම්භ වීමට පෙර RunState එකෙන් අනුමත හෝ ප්රතික්ෂේප කළ යුතු, approval බලා සිටින tool calls, විරාම ගත run එක ලැයිස්තුගත කරන ස්ථානය.
OpenAI අගය store නොකරන නිසා, Responses API හි MCP tool එකට OAuth token එක authorization හි කොපමණ වාර යැවිය යුතුද.
අවසර ලබා ගත් account එකකට, comment replies ඇතුළුව, සෑම Accounts API endpoint එකක් මතම TikTok අවසර දෙන calls ගණන.
Agent එක easyCoexistence වෙත සම්බන්ධ වන්නේ කෙසේද?
MCPServerStreamableHttp හරහා, params["auth"] හි MCP Python SDK හි OAuthClientProvider සමඟ. Agents SDK මෙම handler එක ගොඩනගන HTTP client එකට ලබා දෙයි, එබැවින් provider එක easyCoexistence හි authorization server සොයාගෙන, ඔබේ agent එක public client ලෙස ලියාපදිංචි කරයි, PKCE සමඟ එක් browser sign-in එකක් ක්රියාත්මක කර, පැය එකක් ඇති access tokens refresh token සමඟ refresh කරයි. උදාහරණය MCP Python SDK v2 භාවිත කරයි, එහි handler එක httpx2.Auth විය යුතුය; provider එක එයයි. Storage object එකක් run අතර ලියාපදිංචිය සහ tokens තබා ගනී; පහත file එක secret store එකක් වෙනුවට සිටී. create_static_tool_filter මගින් agent එකට දැකිය හැකි tools ලැයිස්තු ගත කරයි, 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}},
)පළ කිරීම පුද්ගලයෙකුගේ අනුමැතිය යටතේ තබා ගන්නේ කෙසේද?
server මත require_approval සමඟ, නම් කළ tool එක ක්රියාත්මක වීමට පෙර run එක විරාම කරයි. ඉන් පසු run එක අවසාන පිළිතුරක් වෙනුවට interruptions සමඟ ආපසු පැමිණේ: ප්රතිඵලය RunState බවට හරවා, බලා සිටින සෑම call එකක්ම අනුමත හෝ ප්රතික්ෂේප කර, එම agent සහ state සමඟ Runner.run නැවත කැඳවන්න. always_approve False ලෙස තැබූ විට, එක් ඔව් එකකින් එක් call එකක් පමණක් ආවරණය වන බැවින්, agent එකට දෙවන පළ කිරීමක් සඳහා අනුමැතියක් නැවත භාවිත කළ නොහැක. Loop එක async with block එක තුළ ක්රියාත්මක වන නිසා, විරාමය පුරා server එක විවෘතව පවතී. පැය ගණනක් ගත වන සමාලෝචනයක් සඳහා, SDK මගින් state එක JSON ලෙස store කර, පසුව RunState.from_json සමඟ නැවත load කළ හැක.
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 comment එකක් හෝ Instagram DM එකක් run එකක් ආරම්භ කරන්නේ කෙසේද?
ඔබේම HTTPS route එක හරහා, මන්දයත් agent එක MCP server එකෙන් ඉල්ලන දේ පමණක් අසයි. set_social_webhook_destination මගින් account එකක comments, mentions සහ DMs route වෙත යොමු කරන අතර signing secret එක එක් වරක් ලබා දෙයි; TikTok accounts comments forward කරයි. Route එක X-EC-Signature පරීක්ෂා කරයි, එනම් timestamp, dot සහ raw body හි HMAC-SHA256 එකකි, easyCoexistence හි තත්පර 8 ඇතුළත පිළිතුරු දී event එක queue කරයි. ඉන් පසු worker එකක් event එක input ලෙස සමඟ Runner.run කැඳවයි. DMs සඳහා, account සහ යවන්නා යතුර වශයෙන් වූ session එකක් සංවාදය පවත්වා ගනී; TikTok comment එකකට අවශ්ය වන්නේ comment සහ එහි video එක පමණි, එබැවින් එය එකක් නැතිව ක්රියාත්මක විය හැක.
Agent එකේ instructions එකෙන් සෑම network එක ගැනම කුමක් කිව යුතුද?
සෑම network API එකක් account එකට යොදන නීති, model එක කියවන ස්ථානයේ ලියා:
- TikTok:
reply_to_commentප්රසිද්ධියේ පළ කරයි,post_idලෙස video හි ID අවශ්යයි;send_social_dmTikTok accounts ප්රතික්ෂේප කරයි. - TikTok පරිමාව: reply endpoint එකේ එක් account එකකට විනාඩියට calls 40 දක්වා, සහ කෙටි කාලයක් තුළ බොහෝ සමාන replies spam ලෙස සැඟවිය හැක.
- Instagram DMs: අවසාන පැය 24 තුළ ලිඛිතව යවා ඇති පුද්ගලයන්ට පමණක් පිළිතුරු දිය හැක, UTF-8 text බයිට් 1,000 ට නොවැඩි.
- WhatsApp: පාරිභෝගිකයාගේ අවසාන පණිවිඩයෙන් පැය 24 ඇතුළත
send_message, එසේ නොමැති නම් අනුමත template එකක් සමඟsend_template. - කාලය:
scheduled_atISO 8601 timezone සමඟ, මිනිත්තු 1 සිට දින 90 දක්වා ඉදිරියට, සහlist_scheduled_postsqueue එක පෙන්වයි.
Agent එකට HostedMCPTool භාවිත කළ හැකිද, හෝ sign-in නොමැතිව ධාවනය කළ හැකිද?
දෙකම හැකි ය, වාසි සහ අවාසි සහිතව. HostedMCPTool server එක Responses API වෙත පවරයි, එහි MCP tool එක OAuth access token එකක් authorization හි ගන්නා අතර, OpenAI එය store නොකරන නිසා එය සෑම request එකකම අවශ්යයි; easyCoexistence access token එක පැයක් ඇති බැවින්, ඔබේ code එක සෑම run එකකට පෙර එකක් refresh කරයි. Sign in කළ හැකි කිසිවෙකු නොමැති කාර්යයක් සඳහා, MCP මඟ හරින්න: ec_live_ key සමඟ Partner API එක call කරන function tools මගින් POST /api/v1/channels/:id/posts හරහා posts queue කළ හැක, සහ GET /api/v1/channels/:id?credentials=1 හරහා නව TikTok, YouTube සහ LinkedIn tokens ලබා ගත හැක; comment rules සහ automations agent එකක් නොමැතිව easyCoexistence මත පිළිතුරු දෙයි.
සාමාන්ය වැරදි
- publishing සඳහා 5-second client_session_timeout_seconds තබා ගැනීම. publish එක network එකේ API එක මත රැඳේ, එබැවින් මන්දගාමී call එකක් easyCoexistence post එක ඉදිරියට යැවූ පසු agent එකේ timeout විය හැක; මිනිත්තුවක් ලබා දී, නැවත උත්සාහ කිරීමට පෙර list_scheduled_posts පරීක්ෂා කරන්න.
- external_id account_id ලෙස යැවීම. tools වලට account_id ගත යුතුය, එය easyCoexistence හි account ID එකයි; external_id යනු Instagram, TikTok හෝ Facebook හි account එකේ තමන්ගේම ID එකයි.
- පුද්ගලයෙකු නැති loop එකක interruptions අනුමත කිරීම. require_approval පවතින්නේ, මිනිසෙක් හෝ ඔබ විශ්වාස කරන නීතියක් සෑම බලා සිටින call එකක් පිළිබඳව තීරණය කරන විට පමණි.
- Agent එකට account එකේම activity ලබා දීම. Instagram account එකේ DMs is_echo true සමඟ echoes ලෙසත්, එහි public replies නව comments ලෙසත් ලබා දෙයි; Runner.run ට පෙර දෙකම පෙරන්න.
easyCoexistence මගින් ඔබේ OpenAI Agents SDK agents වලට WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn සහ තවත් channels වලින් පාරිභෝගිකයන් වෙත ළඟා වීමේ හැකියාව ලබා දෙයි, සෑම එකක්ම එහි official API හරහා: OAuth සමඟ sign in වන MCP server එකක්, comments සහ DMs සඳහා අත්සන් කළ events, සහ අධීක්ෂණයකින් තොරව ධාවනය වන කාර්යයන් සඳහා Partner API එකක්, සෑම connection එකක්ම 24/7 අධීක්ෂණය කරමින්. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
Agent එකට easyCoexistence වෙතින් API key එකක් අවශ්යද?
MCP සඳහා නැත. OAuth sign-in මගින් agent එකට තමාගේම tokens නිකුත් කරයි; dashboard එකෙන් ලබා ගන්නා ec_live_ key එක, MCP server එක වෙනුවට Partner API එක call කරන code සඳහා පමණි.
එම agent එකට WhatsApp පණිවිඩවලට පිළිතුරු දිය හැකිද?
ඔව්, අංකයේ tools සමඟ: connection_id සඳහා list_numbers, පාරිභෝගිකයාගේ අවසාන පණිවිඩයෙන් පැය 24 ඇතුළත send_message සහ ඉන් පිටත send_template. OpenAI Agents SDK හි WhatsApp මාර්ගෝපදේශය පණිවිඩ ලැබීම ආවරණය කරයි.
Agent එක කුමන model එක භාවිත කරයි?
ඔබ Agent එකට දෙන model එක. MCP tools SDK ධාවනය කරන ඕනෑම model එකක් සමඟ එකසේ ක්රියා කරයි, model භාවිතය එහි provider විසින් බිල් කරයි, සහ easyCoexistence සම්බන්ධතාවයට අය කරයි.
OpenAI Agents SDK agent එකක් සඳහා easyCoexistence කොපමණ වේද?
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වේ, සෑම network එකකම එක සමාන. MCP server, forwarded events සහ Partner API ඒ සමඟ ලැබේ, සහ පළමු දින 3 නොමිලේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ