OpenAI Agents SDK ఏజెంట్కు Instagram, TikTok మరియు WhatsApp టూల్స్ ఇవ్వండి
OpenAI Agents SDK ఏజెంట్కు Instagram, TikTok, WhatsApp మరియు ఇతర ఛానెళ్లు టూల్స్గా అందుతాయి; ఇవి https://easycoexistence.com/api/mcp కు సూచించిన MCPServerStreamableHttp ద్వారా చేరుతాయి, ప్రమాణీకరణ హ్యాండ్లర్గా 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 టూల్కు OAuth టోకెన్ను authorization లో ఎంత తరచుగా పంపాలి; OpenAI ఆ విలువను నిల్వ చేయదు.
ప్రతి అధికారం పొందిన ఖాతాకు Accounts API ఎండ్పాయింట్పై TikTok అనుమతించే కాల్స్, కామెంట్ రిప్లైలతో సహా.
OpenAI 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_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_dmTikTok ఖాతాలను తిరస్కరిస్తుంది. - 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. OpenAI Agents SDK గైడ్ WhatsApp కోసం మెసేజ్లను స్వీకరించడాన్ని వివరిస్తుంది.
ఏ మోడల్ను ఏజెంట్ ఉపయోగిస్తుంది?
మీరు 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 పర్యవేక్షణ
ధృవీకరించిన తేదీ