登录开始免费试用
easyCoexistence 官方 API

为 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 发出。

httpx2.Auth

在 MCP Python SDK v2 中,MCPServerStreamableHttp 通过 params["auth"] 接收参数;在 v1 中则接收 httpx.Auth。

mcp>=1.19.0,<3

Agents SDK 所依赖的 mcp 包版本范围,涵盖 MCP Python SDK 的两个主要版本。

interruptions

暂停的运行会列出等待批准的工具调用,RunState 在 Runner.run 恢复运行之前对其进行批准或拒绝。

Per request

说明 Responses API 的 MCP 工具需要多久在 authorization 中发送一次 OAuth 令牌;OpenAI 不存储该值。

40 a minute

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 则指定需要人工批准的工具。

The MCP server, signed in over OAuth, with a filter and approvals
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 重新加载。

Run the agent and resume it after each decision
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 私信如何启动一次运行?

通过您自己的 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 完成这些操作

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 监控

验证时间