Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Beri ejen OpenAI Agents SDK alat Instagram, TikTok dan WhatsApp

Ejen OpenAI Agents SDK mendapat saluran Instagram, TikTok, WhatsApp dan lain-lain sebagai alat melalui MCPServerStreamableHttp yang menghala ke https://easycoexistence.com/api/mcp, dengan OAuthClientProvider daripada MCP Python SDK sebagai pengendali pengesahan. Penapis alat menyempitkan 35+ alat mengikut tugasan, require_approval menahan penerbitan sehingga seseorang meluluskannya, dan setiap panggilan sampai ke rangkaian melalui API rasmi masing-masing.

httpx2.Auth

Apa yang MCPServerStreamableHttp terima dalam params["auth"] dengan MCP Python SDK v2; dengan v1 ia menerima httpx.Auth.

mcp>=1.19.0,<3

Julat pakej mcp yang disandarkan oleh Agents SDK, meliputi kedua-dua versi utama MCP Python SDK.

interruptions

Tempat larian yang dijeda menyenaraikan panggilan alat yang menunggu kelulusan, yang diluluskan atau ditolak oleh RunState sebelum Runner.run disambung semula.

Per request

Kekerapan token OAuth perlu dihantar kepada alat MCP Responses API dalam authorization; OpenAI tidak menyimpan nilainya.

40 a minute

Panggilan yang TikTok benarkan bagi setiap akaun yang diberi kuasa pada setiap endpoint Accounts API, termasuk balasan komen.

Bagaimana ejen Agents SDK bersambung ke easyCoexistence?

Melalui MCPServerStreamableHttp, dengan OAuthClientProvider daripada MCP Python SDK dalam params["auth"]. Agents SDK menyerahkan pengendali itu kepada klien HTTP yang dibinanya, jadi pembekal itu menemui pelayan kebenaran easyCoexistence, mendaftarkan ejen anda sebagai klien awam, menjalankan satu log masuk melalui pelayar dengan PKCE dan menyegarkan token akses (sah selama sejam) menggunakan token penyegaran. Contoh ini menggunakan MCP Python SDK v2, yang mana pengendali itu mesti ialah httpx2.Auth, dan pembekal itu memang begitu. Objek storan menyimpan pendaftaran dan token antara larian; fail di bawah menggantikan stor rahsia. create_static_tool_filter menyenaraikan alat yang boleh dilihat ejen, dan require_approval menamakan alat yang menunggu seseorang.

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}},
    )

Bagaimana anda memastikan penerbitan hanya berlaku selepas diluluskan oleh seseorang?

Dengan require_approval pada pelayan, yang menjeda larian sebelum alat yang dinamakan dilaksanakan. Larian kemudian kembali dengan gangguan dan bukan jawapan akhir: tukarkan hasil itu kepada RunState, luluskan atau tolak setiap panggilan yang menunggu, dan panggil Runner.run sekali lagi dengan ejen dan keadaan yang sama. Dengan always_approve kekal False, setiap 'ya' meliputi satu panggilan sahaja, jadi ejen tidak dapat menggunakan semula satu kelulusan untuk siaran kedua. Pelayan kekal terbuka sepanjang jeda kerana gelung berjalan di dalam blok async with. Bagi semakan yang mengambil masa berjam-jam, SDK boleh menyimpan keadaan sebagai JSON dan memuatkannya semula kemudian dengan 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

Bagaimana komen TikTok atau DM Instagram memulakan larian?

Melalui laluan HTTPS anda sendiri, kerana ejen hanya mendengar apa yang diminta daripada pelayan MCP. set_social_webhook_destination menghalakan komen, sebutan dan DM bagi sesuatu akaun ke laluan itu dan memulangkan rahsia tandatangan sekali sahaja; akaun TikTok menghantar komen ke hadapan. Laluan itu menyemak X-EC-Signature, iaitu HMAC-SHA256 bagi cap masa, titik, dan badan mentah, membalas dalam tempoh 8 saat yang ditetapkan easyCoexistence dan memasukkan acara ke dalam giliran. Pekerja kemudian memanggil Runner.run dengan acara itu sebagai input. Bagi DM, sesi yang dikunci pada akaun dan pengirim meneruskan perbualan; komen TikTok hanya memerlukan komen dan videonya, jadi ia boleh berjalan tanpa sesi.

Apakah arahan ejen perlu nyatakan tentang setiap rangkaian?

Peraturan yang digunakan API setiap rangkaian ke atas akaun, ditulis di tempat model membacanya:

  • TikTok: reply_to_comment menyiarkan secara awam dan memerlukan ID video sebagai post_id; send_social_dm menolak akaun TikTok.
  • Had kadar TikTok: sehingga 40 panggilan seminit bagi setiap akaun pada endpoint balasan, dan banyak balasan yang hampir serupa dalam masa singkat boleh disorokkan sebagai spam.
  • DM Instagram: balasan hanya kepada orang yang menulis dalam 24 jam terakhir, dalam tidak lebih daripada 1,000 bait teks UTF-8.
  • WhatsApp: send_message dalam tempoh 24 jam selepas mesej terakhir pelanggan, dan send_template dengan templat yang diluluskan jika tidak.
  • Masa: scheduled_at menerima ISO 8601 dengan zon waktu, 1 minit hingga 90 hari ke hadapan, dan list_scheduled_posts memaparkan giliran jadual.

Bolehkah ejen menggunakan HostedMCPTool, atau berjalan tanpa log masuk?

Kedua-duanya boleh, dengan dagangan. HostedMCPTool menyerahkan pelayan kepada Responses API, yang alat MCP-nya menerima token akses OAuth dalam authorization dan memerlukannya dalam setiap permintaan, kerana OpenAI tidak menyimpannya; token akses easyCoexistence sah selama sejam, jadi kod anda menyegarkan satu token sebelum setiap larian. Bagi tugasan yang tiada sesiapa untuk log masuk, langkau MCP: alat fungsi yang memanggil Partner API dengan kunci ec_live_ boleh menjadualkan siaran melalui POST /api/v1/channels/:id/posts dan mengambil token TikTok, YouTube dan LinkedIn yang segar daripada GET /api/v1/channels/:id?credentials=1, manakala peraturan komen dan automasi membalas di easyCoexistence tanpa ejen berjalan.

Kesilapan biasa

  • Mengekalkan client_session_timeout_seconds 5 saat untuk penerbitan. Penerbitan menunggu API rangkaian, jadi panggilan yang perlahan boleh tamat masa dalam ejen selepas easyCoexistence telah menghantar siaran itu; beri masa seminit, dan semak list_scheduled_posts sebelum mencuba semula.
  • Menghantar external_id sebagai account_id. Alat menerima account_id, iaitu ID easyCoexistence bagi akaun itu; external_id ialah ID akaun itu sendiri di Instagram, TikTok atau Facebook.
  • Meluluskan gangguan dalam gelung tanpa seorang manusia. require_approval hanya melindungi penerbitan apabila manusia, atau peraturan yang anda percayai, membuat keputusan bagi setiap panggilan yang menunggu.
  • Memberi ejen aktiviti akaunnya sendiri. Instagram memulangkan DM akaun sebagai gema dengan is_echo true dan balasan awamnya sebagai komen baharu; tapis kedua-duanya sebelum Runner.run.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberi ejen OpenAI Agents SDK anda capaian kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, setiap satunya melalui API rasminya: pelayan MCP yang log masuk dengan OAuth, acara bertandatangan untuk komen dan DM, dan Partner API untuk tugasan yang berjalan tanpa pengawasan, dengan setiap sambungan dipantau 24/7. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah ejen memerlukan kunci API daripada easyCoexistence?

Tidak untuk MCP. Log masuk OAuth mengeluarkan token sendiri untuk ejen; kunci ec_live_ daripada dashboard hanya untuk kod yang memanggil Partner API dan bukannya pelayan MCP.

Bolehkah ejen yang sama membalas mesej WhatsApp?

Boleh, dengan alat nombor: list_numbers untuk connection_id, send_message dalam tempoh 24 jam selepas mesej terakhir pelanggan dan send_template di luar tempoh itu. Panduan OpenAI Agents SDK untuk WhatsApp merangkumi cara menerima mesej.

Model apa yang digunakan ejen?

Model yang anda berikan kepada Agent. Alat MCP berfungsi sama walau apa model yang dijalankan SDK, penggunaan model dicaj oleh pembekalnya, dan easyCoexistence mengenakan caj setiap sambungan.

Berapa kos easyCoexistence untuk ejen OpenAI Agents SDK?

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, sama bagi setiap rangkaian. Pelayan MCP, acara yang dihantar ke hadapan dan Partner API termasuk, dan 3 hari pertama adalah percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada