OpenAI Agents SDK ajanına Instagram, TikTok ve WhatsApp araçları verin
OpenAI Agents SDK ajanı, MCPServerStreamableHttp üzerinden https://easycoexistence.com/api/mcp adresine bağlanarak Instagram, TikTok, WhatsApp ve daha fazla kanalı araç olarak alır; kimlik doğrulama işleyicisi olarak MCP Python SDK'nın OAuthClientProvider'ı kullanılır. Bir araç filtresi 50'den fazla aracı işe göre daraltır, require_approval ise bir kişi onaylayana kadar yayımlamayı durdurur ve her çağrı ağa kendi resmi API'si üzerinden ulaşır.
MCP Python SDK v2 ile MCPServerStreamableHttp, params["auth"] içinde ne alır; v1 ile bir httpx.Auth alır.
Agents SDK'nın bağlı olduğu mcp paketi aralığı; MCP Python SDK'nın iki ana sürümünü de kapsar.
Duraklatılmış bir çalıştırmanın onay bekleyen araç çağrılarını listelediği yer; Runner.run devam etmeden önce bir RunState bunları onaylar veya reddeder.
Responses API'nin MCP aracına her seferinde authorization içinde OAuth token'ının ne sıklıkla gönderilmesi gerektiği; OpenAI bu değeri saklamaz.
TikTok'un her yetkilendirilmiş hesap için Accounts API uç noktasında izin verdiği çağrılar; yorum yanıtları dahil.
Bir Agents SDK ajanı easyCoexistence'a nasıl bağlanır?
MCPServerStreamableHttp üzerinden, params["auth"] içinde MCP Python SDK'nın OAuthClientProvider'ı ile. Agents SDK bu işleyiciyi oluşturduğu HTTP istemcisine aktarır; böylece sağlayıcı easyCoexistence'ın yetkilendirme sunucusunu keşfeder, ajanınızı herkese açık bir istemci olarak kaydeder, PKCE ile tarayıcıdan tek kez oturum açar ve bir saatlik erişim token'larını yenileme token'ı ile yeniler. Örnek MCP Python SDK v2 kullanır; burada işleyicinin bir httpx2.Auth olması gerekir ve sağlayıcı da öyledir. Bir depolama nesnesi kayıt ve token'ları çalıştırmalar arasında tutar; aşağıdaki dosya bir gizli anahtar deposunun yerini tutar. create_static_tool_filter ajanın görebileceği araçları listeler, require_approval ise bir kişinin onaylamasını bekleyenleri belirtir.
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}},
)Yayımlamayı bir kişinin onayının arkasında nasıl tutarsınız?
Sunucuda require_approval ile; bu, adlandırılmış bir araç çalışmadan önce çalıştırmayı duraklatır. Çalıştırma o zaman nihai yanıt yerine interruptions ile döner: sonucu bir RunState'e çevirin, bekleyen her çağrıyı onaylayın veya reddedin ve aynı ajan ile durumu vererek Runner.run'ı yeniden çağırın. always_approve False bırakıldığında her evet tek bir çağrıyı kapsar; böylece ajan bir onayı ikinci bir gönderi için kullanamaz. Döngü async with bloğunun içinde çalıştığı için sunucu duraklatma boyunca açık kalır. Saatler süren bir inceleme için SDK durumu JSON olarak saklayabilir ve daha sonra RunState.from_json ile yeniden yükleyebilir.
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_outputBir TikTok yorumu veya bir Instagram DM'i çalıştırmayı nasıl başlatır?
Kendi HTTPS rotanız üzerinden, çünkü ajan yalnızca MCP sunucusundan istediği şeyi duyar. set_social_webhook_destination, bir hesabın yorumlarını, bahsetmelerini ve DM'lerini rotaya yönlendirir ve imza gizli anahtarını yalnızca bir kez döndürür; TikTok hesapları yorumları iletir. Rota X-EC-Signature'ı kontrol eder; bu, zaman damgası, bir nokta ve ham gövdenin HMAC-SHA256'sıdır. easyCoexistence'ın 8 saniyesi içinde yanıt verir ve olayı kuyruğa alır. Ardından bir arka plan işi, olayı girdi olarak vererek Runner.run'ı çağırır. DM'ler için hesap ve gönderen üzerinden anahtarlanan bir oturum konuşmayı sürdürür; bir TikTok yorumu yalnızca yorumu ve videosunu gerektirir, bu yüzden videosuz da çalışabilir.
Ajanın talimatları her ağ hakkında ne söylemeli?
Her ağın API'sinin hesaba uyguladığı kurallar, modelin okuyacağı yere yazılmış olarak:
- TikTok:
reply_to_commentherkese açık paylaşır vepost_idolarak videonun ID'sini ister;send_social_dmTikTok hesaplarını reddeder. - TikTok hacmi: yanıt uç noktasında hesap başına dakikada en fazla 40 çağrı; kısa sürede birbirine çok benzeyen çok sayıda yanıt spam olarak gizlenebilir.
- Instagram DM'leri: yalnızca son 24 saat içinde yazan kişilere yanıt verilir ve en fazla 1.000 bayt UTF-8 metin içinde.
- WhatsApp: müşterinin son mesajından itibaren 24 saat içinde
send_message, bunun dışında ise onaylı bir şablonlasend_template. - Zamanlama:
scheduled_at, saat dilimi içeren ISO 8601 biçimini alır ve 1 dakika ile 90 gün arasında olabilir;list_scheduled_postskuyruğu gösterir.
Ajan HostedMCPTool kullanabilir mi, yoksa oturum açmadan mı çalışabilir?
İkisi de mümkün, ama ödünleşimleri var. HostedMCPTool sunucuyu Responses API'ye devreder; bu API'nin MCP aracı authorization içinde bir OAuth erişim token'ı ister ve her istekte bunun gönderilmesini gerektirir, çünkü OpenAI onu saklamaz. easyCoexistence erişim token'ı bir saat geçerli olduğundan, kodunuz her çalıştırmadan önce birini yeniler. Oturum açacak kimsenin olmadığı bir iş için MCP'yi atlayın: ec_live_ anahtarı ile Partner API'yi çağıran fonksiyon araçları, POST /api/v1/channels/:id/posts üzerinden gönderileri kuyruğa alabilir ve GET /api/v1/channels/:id?credentials=1 ile taze TikTok, YouTube ve LinkedIn token'ları alabilir; yorum kuralları ve otomasyonlar ise hiçbir ajan çalışmadan easyCoexistence'ta yanıt verir.
Yaygın hatalar
- Yayımlama için 5 saniyelik client_session_timeout_seconds değerini tutmak. Yayımlama ağın API'sini beklediğinden, yavaş bir çağrı easyCoexistence gönderiyi geçtikten sonra ajanda zaman aşımına uğrayabilir; bir dakika tanıyın ve yeniden denemeden önce list_scheduled_posts'u kontrol edin.
- external_id'yi account_id olarak göndermek. Araçlar easyCoexistence'ın hesap ID'si olan account_id'yi alır; external_id ise Instagram, TikTok veya Facebook'taki hesabın kendi ID'sidir.
- Kimsenin olmadığı bir döngüde interruptions'ı otomatik onaylamak. require_approval, yayımlamayı yalnızca bir insan veya güvendiğiniz bir kural bekleyen her çağrı hakkında karar verdiğinde korur.
- Ajana hesabın kendi etkinliğini beslemek. Instagram, hesabın DM'lerini is_echo true ile yankı olarak ve kamuya açık yanıtlarını yeni yorum olarak döndürür; Runner.run'dan önce ikisini de süzün.
easyCoexistence, OpenAI Agents SDK ajanlarınıza WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve daha fazla kanalda müşterilere erişim verir; her biri resmi API'si üzerinden çalışır: OAuth ile oturum açan bir MCP sunucusu, yorumlar ve DM'ler için imzalı olaylar ve gözetimsiz çalışan işler için bir Partner API. Her bağlantı 7/24 izlenir. Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında, bağlantı eklendikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
OpenAI Agents SDK ajanı için easyCoexistence'tan API anahtarı gerekir mi?
MCP için gerekmez. OAuth oturum açma, ajana kendi token'larını verir; panelden alınan ec_live_ anahtarı yalnızca MCP sunucusu yerine Partner API'yi çağıran kod içindir.
Aynı ajan WhatsApp mesajlarını yanıtlayabilir mi?
Evet, numaranın araçlarıyla: connection_id alanı için list_numbers, müşterinin son mesajından itibaren 24 saat içinde send_message ve bunun dışında send_template. WhatsApp için OpenAI Agents SDK kılavuzu mesajların alınmasını anlatır.
Hangi modeli kullanır?
Agent'a verdiğiniz model. MCP araçları, SDK'nın çalıştırdığı modelden bağımsız olarak aynı şekilde çalışır; modelin kullanımı sağlayıcısı tarafından faturalandırılır, easyCoexistence ise bağlantı başına ücret alır.
OpenAI Agents SDK ajanı için easyCoexistence ne kadar tutar?
Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında; bağlantı eklendikçe düşer ve her ağda aynıdır. MCP sunucusu, iletilen olaylar ve Partner API bunun içindedir; ilk 3 gün ücretsizdir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi