Дайте агенту OpenAI Agents SDK инструменты для Instagram, TikTok и WhatsApp
Агент OpenAI Agents SDK получает Instagram, TikTok, WhatsApp и другие каналы как инструменты через MCPServerStreamableHttp, направленный на https://easycoexistence.com/api/mcp, с OAuthClientProvider из MCP Python SDK в качестве обработчика авторизации. Фильтр инструментов сужает более 35 инструментов до нужных задач, require_approval задерживает публикацию до одобрения человеком, а каждый вызов идёт в сеть через официальный API.
Что MCPServerStreamableHttp принимает в params["auth"] в MCP Python SDK v2; в v1 принимается httpx.Auth.
Диапазон версий пакета mcp, от которого зависит Agents SDK, охватывающий обе основные версии MCP Python SDK.
Где приостановленный запуск показывает вызовы инструментов, ожидающие одобрения; RunState одобряет или отклоняет их до того, как Runner.run возобновит работу.
Как часто MCP-инструменту Responses API нужно передавать OAuth-токен в authorization; OpenAI это значение не хранит.
Сколько вызовов TikTok разрешено на каждый авторизованный аккаунт на каждом эндпоинте Accounts API, включая ответы на комментарии.
Как агент Agents SDK подключается к easyCoexistence?
Через MCPServerStreamableHttp, с OAuthClientProvider из MCP Python SDK в params["auth"]. Agents SDK передаёт этот обработчик HTTP-клиенту, который создаёт сам, поэтому провайдер находит сервер авторизации easyCoexistence, регистрирует ваш агент как публичный клиент, проводит один вход в браузере с PKCE и обновляет токены доступа, живущие час, с помощью токена обновления. В примере используется MCP Python SDK v2, где обработчик должен быть httpx2.Auth, а провайдер является именно им. Объект хранилища сохраняет регистрацию и токены между запусками; файл ниже заменяет хранилище секретов. 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_outputКак комментарий в TikTok или личное сообщение в Instagram запускает работу?
Через ваш собственный маршрут HTTPS, так как агент получает только то, что сам запрашивает у MCP-сервера. set_social_webhook_destination направляет комментарии, упоминания и личные сообщения аккаунта на маршрут и возвращает секрет подписи один раз; аккаунты TikTok передают комментарии. Маршрут проверяет X-EC-Signature, HMAC-SHA256 от метки времени, точки и исходного тела запроса, отвечает в пределах 8 секунд, отведённых easyCoexistence, и ставит событие в очередь. Затем воркер вызывает Runner.run, передавая событие как input. Для личных сообщений сессия, привязанная к аккаунту и отправителю, поддерживает диалог; комментарий TikTok нужен только сам по себе и своему видео, поэтому может работать без неё.
Что инструкции агента должны говорить о каждой сети?
Правила, которые API каждой сети применяет к аккаунту, записанные там, где их читает модель:
- TikTok:
reply_to_commentпубликует ответ публично и требует ID видео какpost_id;send_social_dmотказывает аккаунтам TikTok. - Объём в TikTok: до 40 вызовов в минуту на аккаунт для эндпоинта ответов, а много почти одинаковых ответов за короткое время может быть скрыто как спам.
- Личные сообщения в Instagram: ответы только тем, кто писал в последние 24 часа, длиной не более 1 000 байт текста в UTF-8.
- WhatsApp:
send_messageв течение 24 часов после последнего сообщения клиента, а иначеsend_templateс одобренным шаблоном. - Сроки:
scheduled_atпринимает ISO 8601 с часовым поясом, от 1 минуты до 90 дней вперёд;list_scheduled_postsпоказывает очередь.
Может ли агент использовать HostedMCPTool или работать без входа?
Возможно и то, и другое, с компромиссами. HostedMCPTool передаёт сервер Responses API, инструмент MCP которого принимает OAuth-токен доступа в authorization и требует его в каждом запросе, так как OpenAI его не хранит. Токен доступа easyCoexistence живёт час, поэтому ваш код обновляет его перед каждым запуском. Для задачи, где некому входить, пропустите MCP: инструменты-функции, которые вызывают Partner API с ключом ec_live_, могут ставить публикации в очередь через POST /api/v1/channels/:id/posts и получать свежие токены TikTok, YouTube и LinkedIn из GET /api/v1/channels/:id?credentials=1, а правила комментариев и автоматизации отвечают в easyCoexistence без работающего агента.
Распространённые ошибки
- Сохранение client_session_timeout_seconds равным 5 секундам для публикации. Публикация ждёт ответа API сети, поэтому медленный вызов может истечь по таймауту в агенте уже после того, как easyCoexistence передал публикацию дальше. Задайте минуту и перед повтором проверьте list_scheduled_posts.
- Передача external_id вместо account_id. Инструменты принимают account_id, то есть ID аккаунта в easyCoexistence; external_id это собственный ID аккаунта в Instagram, TikTok или Facebook.
- Автоматическое одобрение interruptions в цикле, где нет человека. require_approval защищает публикацию только тогда, когда человек или правило, которому вы доверяете, решает по каждому ожидающему вызову.
- Передача агенту собственной активности аккаунта. Instagram возвращает личные сообщения аккаунта как эхо с is_echo true, а его публичные ответы как новые комментарии; отфильтруйте оба типа до Runner.run.
easyCoexistence даёт вашим агентам OpenAI Agents SDK доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах, каждый через официальный API: MCP-сервер, который входит через OAuth, подписанные события для комментариев и личных сообщений и Partner API для задач без присмотра, при этом каждое подключение круглосуточно под мониторингом. От US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужен ли агенту API-ключ от easyCoexistence?
Для MCP нет. Вход через OAuth выдаёт агенту собственные токены; ключ ec_live_ из панели управления нужен только коду, который вызывает Partner API вместо MCP-сервера.
Может ли тот же агент отвечать на сообщения WhatsApp?
Да, с помощью инструментов номера: list_numbers для connection_id, send_message в течение 24 часов после последнего сообщения клиента и send_template после этого срока. Руководство OpenAI Agents SDK для WhatsApp описывает получение сообщений.
Какую модель использует агент?
Ту, которую вы укажете в Agent. Инструменты MCP работают одинаково независимо от модели, которую запускает SDK; оплату за её использование выставляет её провайдер, а easyCoexistence берёт плату за подключение.
Сколько стоит easyCoexistence для агента OpenAI Agents SDK?
От US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений, одинаково для каждой сети. MCP-сервер, пересылаемые события и Partner API входят в стоимость, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на