Berikan agen OpenAI Agents SDK alat untuk Instagram, TikTok dan WhatsApp
Agen OpenAI Agents SDK mendapatkan alat untuk Instagram, TikTok, WhatsApp, dan saluran lainnya melalui MCPServerStreamableHttp yang mengarah ke https://easycoexistence.com/api/mcp, dengan OAuthClientProvider dari MCP Python SDK sebagai penangan autentikasinya. Filter alat mempersempit lebih dari 35 alat sesuai tugas, require_approval menahan publikasi sampai seseorang menyetujuinya, dan setiap panggilan mencapai jaringan melalui API resminya.
Yang diterima MCPServerStreamableHttp di params["auth"] dengan MCP Python SDK v2; dengan v1 yang diterima adalah httpx.Auth.
Rentang paket mcp yang dibutuhkan Agents SDK, yang mencakup kedua versi utama MCP Python SDK.
Daftar panggilan alat yang menunggu persetujuan pada eksekusi yang dijeda, yang disetujui atau ditolak RunState sebelum Runner.run dilanjutkan.
Seberapa sering alat MCP Responses API harus dikirimi token OAuth-nya di authorization; OpenAI tidak menyimpan nilainya.
Panggilan yang diizinkan TikTok per akun terotorisasi di tiap endpoint Accounts API, termasuk balasan komentar.
Bagaimana agen Agents SDK terhubung ke easyCoexistence?
Lewat MCPServerStreamableHttp, dengan OAuthClientProvider dari MCP Python SDK di params["auth"]. Agents SDK meneruskan penangan itu ke klien HTTP yang dibangunnya, sehingga provider menemukan server otorisasi easyCoexistence, mendaftarkan agen Anda sebagai klien publik, menjalankan satu kali masuk di browser dengan PKCE, dan memperbarui token akses yang berlaku satu jam dengan refresh token. Contoh ini memakai MCP Python SDK v2, di mana penangan harus berupa httpx2.Auth, dan provider memang demikian. Objek penyimpanan menyimpan pendaftaran dan token antar-eksekusi; berkas di bawah menggantikan penyimpanan rahasia. create_static_tool_filter mendaftar alat yang boleh dilihat agen, dan require_approval menyebut alat yang menunggu seseorang.
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 menjaga publikasi tetap di balik persetujuan seseorang?
Dengan require_approval pada server, yang menjeda run sebelum alat bernama dijalankan. Run kemudian kembali dengan interruptions alih-alih jawaban akhir: ubah hasilnya menjadi RunState, setujui atau tolak setiap panggilan yang tertunda, lalu panggil Runner.run lagi dengan agen dan state yang sama. Dengan always_approve dibiarkan False, setiap persetujuan berlaku untuk satu panggilan, sehingga agen tidak dapat memakai ulang persetujuan untuk unggahan kedua. Server tetap terbuka selama jeda karena perulangan berjalan di dalam blok async with-nya. Untuk peninjauan yang memakan waktu berjam-jam, SDK dapat menyimpan state sebagai JSON dan memuatnya kembali nanti dengan 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_outputBagaimana komentar TikTok atau DM Instagram memulai run?
Lewat rute HTTPS milik Anda sendiri, karena agen hanya mendengar apa yang diminta dari server MCP. set_social_webhook_destination mengarahkan komentar, mention, dan DM sebuah akun ke rute itu dan mengembalikan kunci rahasia penandatanganan sekali saja; akun TikTok meneruskan komentar. Rute memeriksa X-EC-Signature, yaitu HMAC-SHA256 dari timestamp, titik, lalu body mentah, merespons dalam 8 detik milik easyCoexistence, dan memasukkan event ke antrean. Worker kemudian memanggil Runner.run dengan event sebagai input. Untuk DM, sesi yang dikunci pada akun dan pengirim menjaga percakapan tetap berlanjut; komentar TikTok hanya membutuhkan komentar dan videonya, sehingga dapat berjalan tanpa sesi itu.
Apa yang harus dikatakan instruksi agen tentang tiap jaringan?
Aturan yang diterapkan API tiap jaringan pada akun, ditulis di tempat model membacanya:
- TikTok:
reply_to_commentmemposting secara publik dan membutuhkan ID video sebagaipost_id;send_social_dmmenolak akun TikTok. - Volume TikTok: hingga 40 panggilan per menit per akun di endpoint balasan, dan banyak balasan yang hampir sama dalam waktu singkat dapat disembunyikan sebagai spam.
- DM Instagram: hanya membalas orang yang menulis dalam 24 jam terakhir, dengan teks UTF-8 maksimal 1,000 byte.
- WhatsApp:
send_messagedalam 24 jam sejak pesan terakhir pelanggan, dansend_templatedengan template yang disetujui di luar itu. - Waktu:
scheduled_atmenerima ISO 8601 dengan zona waktu, 1 menit hingga 90 hari ke depan, danlist_scheduled_postsmenampilkan antrean.
Bisakah agen memakai HostedMCPTool, atau berjalan tanpa masuk?
Keduanya bisa, dengan trade-off. HostedMCPTool menyerahkan server ke Responses API, yang alat MCP-nya menerima token akses OAuth di authorization dan memintanya di setiap permintaan, karena OpenAI tidak menyimpannya; token akses easyCoexistence berlaku satu jam, jadi kode Anda memperbaruinya sebelum setiap run. Untuk tugas tanpa orang yang bisa masuk, lewati MCP: alat fungsi yang memanggil Partner API dengan kunci ec_live_ dapat mengantrekan postingan lewat POST /api/v1/channels/:id/posts dan mengambil token TikTok, YouTube, dan LinkedIn terbaru dari GET /api/v1/channels/:id?credentials=1, sementara aturan komentar dan otomatisasi membalas di easyCoexistence tanpa agen yang berjalan.
Kesalahan umum
- Mempertahankan client_session_timeout_seconds 5 detik untuk publikasi. Publikasi menunggu API jaringan, sehingga panggilan yang lambat bisa habis waktu di agen setelah easyCoexistence sudah meneruskan postingan; beri waktu satu menit, dan periksa list_scheduled_posts sebelum mencoba lagi.
- Mengirim external_id sebagai account_id. Alat menerima account_id, yaitu ID easyCoexistence untuk akun; external_id adalah ID akun di Instagram, TikTok, atau Facebook.
- Menyetujui interruptions dalam perulangan tanpa orang di dalamnya. require_approval hanya melindungi publikasi bila seseorang, atau aturan yang Anda percaya, memutuskan setiap panggilan yang tertunda.
- Memberi agen aktivitas akunnya sendiri. Instagram mengembalikan DM akun sebagai echoes dengan is_echo true dan balasan publiknya sebagai komentar baru; saring keduanya sebelum Runner.run.
easyCoexistence memberi agen OpenAI Agents SDK Anda jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn, dan saluran lainnya, masing-masing lewat API resminya: server MCP yang masuk dengan OAuth, event bertanda tangan untuk komentar dan DM, serta Partner API untuk tugas yang berjalan tanpa diawasi, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah agen memerlukan kunci API dari easyCoexistence?
Tidak untuk MCP. Masuk dengan OAuth memberi agen token miliknya sendiri; kunci ec_live_ dari dasbor hanya untuk kode yang memanggil Partner API, bukan server MCP.
Bisakah agen yang sama membalas pesan WhatsApp?
Bisa, dengan alat nomornya: list_numbers untuk connection_id, send_message dalam 24 jam sejak pesan terakhir pelanggan, dan send_template di luar waktu itu. Panduan OpenAI Agents SDK untuk WhatsApp membahas penerimaan pesannya.
Model apa yang dipakai agen?
Model yang Anda berikan ke Agent. Alat MCP bekerja sama untuk model apa pun yang dijalankan SDK, pemakaian model ditagih oleh penyedianya, dan easyCoexistence menagih per koneksi.
Berapa biaya easyCoexistence untuk agen OpenAI Agents SDK?
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, sama di tiap jaringan. Server MCP, event yang diteruskan, dan Partner API sudah termasuk, dan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada