为 OpenAI Agents SDK 智能体添加 Instagram、TikTok 和 WhatsApp 工具
OpenAI Agents SDK 智能体通过 MCPServerStreamableHttp 连接 https://easycoexistence.com/api/mcp,并以 MCP Python SDK 的 OAuthClientProvider 作为认证处理器,从而将 Instagram、TikTok、WhatsApp 等渠道作为工具使用。工具过滤器可将 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 工具需要多久在 authorization 中发送一次 OAuth 令牌;OpenAI 不存储该值。
TikTok 在每个已授权账户上,对 Accounts API 各端点的调用次数限制,包括评论回复。
easyCoexistence 如何连接 Agents SDK 智能体?
通过 MCPServerStreamableHttp,并在 params["auth"] 中传入 MCP Python SDK 的 OAuthClientProvider。Agents SDK 会把该处理器传给它构建的 HTTP 客户端,因此提供方会发现 easyCoexistence 的授权服务器,把您的智能体注册为公共客户端,通过 PKCE 完成一次浏览器登录,并用刷新令牌更新有效期为一小时的访问令牌。示例使用 MCP Python SDK v2,此时处理器须为 httpx2.Auth,而 OAuthClientProvider 正是如此。存储对象会在多次运行之间保存注册信息和令牌;下方文件只是代替密钥存储。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 私信如何启动一次运行?
通过您自己的 HTTPS 路由,因为智能体只会接收它向 MCP 服务器请求的内容。set_social_webhook_destination 会把某个账户的评论、提及和私信指向该路由,并且只返回一次签名密钥;TikTok 账户会转发评论。路由会检查 X-EC-Signature,即时间戳、一个点号和原始请求体的 HMAC-SHA256,在 easyCoexistence 规定的 8 秒内响应,并将事件排入队列。随后,工作进程以该事件作为输入调用 Runner.run。对于私信,以账户和发送者为键的会话会保持对话的连续性;TikTok 评论只需要评论及其视频,因此无需会话也能运行。
智能体的指令应当如何说明每个平台?
每个平台的 API 对账户适用的规则,写在模型能够读取的位置:
- TikTok:
reply_to_comment会公开发布,并需要视频的 ID 作为post_id;send_social_dm会拒绝 TikTok 账户。 - TikTok 调用量:在回复端点,每个账户每分钟最多 40 次调用;短时间内大量内容相近的回复可能被当作垃圾信息隐藏。
- Instagram 私信:仅能回复过去 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 会以 is_echo 为 true 的回声形式返回账户发出的私信,并将其公开回复作为新评论返回;在调用 Runner.run 之前,请把两者都过滤掉。
easyCoexistence 为您的 OpenAI Agents SDK 智能体提供触达 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 等渠道客户的能力,每个渠道都通过其官方 API 接入:使用 OAuth 登录的 MCP 服务器、评论和私信的签名事件,以及适用于无人值守任务的 Partner API,每个连接全天候 24/7 监控。每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,前 3 天免费。
常见问题
智能体是否需要 easyCoexistence 的 API 密钥?
MCP 不需要。OAuth 登录会为智能体签发其自己的令牌;控制台中的 ec_live_ 密钥仅用于调用 Partner API 而非 MCP 服务器的代码。
同一个智能体能否回复 WhatsApp 消息?
可以,借助号码的工具:使用 list_numbers 获取 connection_id,在客户最后一条消息后 24 小时内使用 send_message,超出该时间则使用 send_template。OpenAI Agents SDK 的 WhatsApp 指南涵盖如何接收消息。
智能体使用哪个模型?
由您为 Agent 指定的模型。无论 SDK 运行哪个模型,MCP 工具的工作方式都相同;模型的用量由其提供商计费,easyCoexistence 则按连接收费。
easyCoexistence 对 OpenAI Agents SDK 智能体的收费是多少?
每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,各平台价格相同。MCP 服务器、转发的事件和 Partner API 均包含在内,前 3 天免费。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间