OpenAI Agents SDK ஏஜென்ட்டுக்கு Instagram, TikTok மற்றும் WhatsApp டூல்கள் கொடுங்கள்
ஒரு OpenAI Agents SDK ஏஜென்ட்டுக்கு https://easycoexistence.com/api/mcp முகவரியைச் சுட்டிக்காட்டும் MCPServerStreamableHttp வழியாக Instagram, TikTok, WhatsApp மற்றும் பிற சேனல்கள் டூல்களாகக் கிடைக்கும், அங்கீகார கையாளியாக MCP Python SDK-இன் OAuthClientProvider இருக்கும். டூல் வடிகட்டி 50-க்கும் மேற்பட்ட டூல்களை வேலைக்கு ஏற்ப குறைக்கும், 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 டூல் OAuth டோக்கனை authorization-இல் எத்தனை முறை அனுப்பப்பட வேண்டும்; OpenAI அந்த மதிப்பைச் சேமிப்பதில்லை.
ஒவ்வொரு Accounts API எண்ட்பாயிண்டிலும் அங்கீகரிக்கப்பட்ட ஒரு கணக்குக்கு TikTok அனுமதிக்கும் அழைப்புகள், கருத்துப் பதில்கள் உட்பட.
OpenAI Agents SDK ஏஜென்ட் easyCoexistence-உடன் எப்படி இணைகிறது?
MCPServerStreamableHttp வழியாக, params["auth"]-இல் MCP Python SDK-இன் OAuthClientProvider உடன். Agents SDK அந்த அங்கீகார கையாளியை தானே உருவாக்கும் HTTP கிளையண்டுக்கு அனுப்புகிறது; எனவே வழங்குநர் easyCoexistence-இன் அங்கீகார சர்வரைக் கண்டறிகிறது, உங்கள் ஏஜென்ட்டை பொது கிளையண்டாகப் பதிவு செய்கிறது, PKCE உடன் ஒரே ஒரு உலாவி உள்நுழைவை நடத்துகிறது, refresh டோக்கன் மூலம் ஒரு மணி நேரம் செல்லுபடியாகும் அணுகல் டோக்கன்களைப் புதுப்பிக்கிறது. எடுத்துக்காட்டு 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-ஐச் சரிபார்க்கிறது, அது timestamp, ஒரு புள்ளி, மூல உடலின் HMAC-SHA256; easyCoexistence-இன் 8 வினாடிக்குள் பதிலளித்து நிகழ்வை வரிசையில் சேர்க்கிறது. பின்னர் ஒரு worker நிகழ்வை உள்ளீடாகக் கொண்டு Runner.run-ஐ அழைக்கிறது. DM-களுக்கு, கணக்கும் அனுப்புநரும் சேர்ந்த ஒரு செஷன் உரையாடலைத் தொடர வைக்கிறது; TikTok கருத்துக்கு கருத்தும் அதன் வீடியோவும் மட்டுமே தேவை, எனவே வீடியோ இல்லாமலும் அது இயங்க முடியும்.
ஒவ்வொரு நெட்வொர்க்கைப் பற்றி ஏஜென்ட்டின் instructions என்ன சொல்ல வேண்டும்?
ஒவ்வொரு நெட்வொர்க்கின் API கணக்குக்குப் பொருந்தும் விதிகள், மாதிரி படிக்கும் இடத்தில் எழுதப்பட்டவை:
- TikTok:
reply_to_commentபொதுவில் பதிலிடுகிறது, அதற்கு வீடியோவின் ID-ஐpost_idஆகத் தேவை;send_social_dmTikTok கணக்குகளை மறுக்கிறது. - TikTok அளவு: ஒரு கணக்குக்கு பதில் எண்ட்பாயிண்டில் நிமிடத்துக்கு 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 டூல் OAuth அணுகல் டோக்கனை authorization-இல் ஒவ்வொரு கோரிக்கையிலும் எதிர்பார்க்கிறது, OpenAI அதைச் சேமிப்பதில்லை. easyCoexistence அணுகல் டோக்கன் ஒரு மணி நேரம் மட்டுமே செல்லுபடியாகும், எனவே உங்கள் குறியீடு ஒவ்வொரு ரனுக்கும் முன் ஒன்றைப் புதுப்பிக்கும். உள்நுழைய ஆளில்லாத வேலைக்கு MCP-ஐத் தவிர்க்கலாம்: ec_live_ விசையுடன் Partner API-ஐ அழைக்கும் function tools, POST /api/v1/channels/:id/posts வழியாக இடுகைகளை வரிசைப்படுத்தலாம் மற்றும் GET /api/v1/channels/:id?credentials=1 வழியாக புதிய TikTok, YouTube மற்றும் LinkedIn டோக்கன்களைப் பெறலாம்; கருத்து விதிகளும் தானியங்கிகளும் ஏஜென்ட் இயங்காமலேயே easyCoexistence-இல் பதிலளிக்கும்.
பொதுவான தவறுகள்
- வெளியீட்டுக்கு 5-second 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 உடன் echoes ஆகவும், அதன் பொதுப் பதில்களை புதிய கருத்துகளாகவும் திருப்பித் தருகிறது; 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 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
OpenAI Agents SDK ஏஜென்ட்டுக்கு easyCoexistence-இன் API விசை தேவையா?
MCP-க்கு தேவையில்லை. OAuth உள்நுழைவு ஏஜென்ட்டுக்கென தனி டோக்கன்களை வழங்குகிறது; டாஷ்போர்டிலிருந்து வரும் ec_live_ விசை, MCP சர்வருக்குப் பதிலாக Partner API-ஐ அழைக்கும் குறியீட்டுக்கு மட்டுமே.
அதே ஏஜென்ட் WhatsApp மெசேஜ்களுக்குப் பதிலளிக்க முடியுமா?
முடியும், எண்ணின் டூல்களுடன்: connection_id-க்கு list_numbers, வாடிக்கையாளரின் கடைசி மெசேஜிலிருந்து 24 மணி நேரத்துக்குள் send_message, அதற்கு வெளியே send_template. மெசேஜ்களைப் பெறுவது குறித்து WhatsApp-க்கான OpenAI Agents SDK வழிகாட்டி விளக்குகிறது.
ஏஜென்ட் எந்த மாடலைப் பயன்படுத்துகிறது?
நீங்கள் Agent-க்குக் கொடுக்கும் மாடல். SDK எந்த மாடலை இயக்கினாலும் MCP டூல்கள் ஒரே மாதிரி வேலை செய்கின்றன; மாடலின் பயன்பாட்டுக் கட்டணத்தை அதன் வழங்குநர் வசூலிக்கிறார், easyCoexistence ஒவ்வொரு இணைப்புக்கும் கட்டணம் வசூலிக்கிறது.
OpenAI Agents SDK ஏஜென்ட்டுக்கு easyCoexistence எவ்வளவு செலவாகும்?
ஒரு இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் கூடும்போது குறையும், ஒவ்வொரு நெட்வொர்க்குக்கும் ஒரே விலை. MCP சர்வர், அனுப்பப்படும் நிகழ்வுகள், Partner API அனைத்தும் அதில் அடங்கும்; முதல் 3 நாட்கள் இலவசம்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: