Как создать агента для WhatsApp на OpenAI Agents SDK

OpenAI Agents SDK — это открытый фреймворк OpenAI для создания агентов: модель с инструкциями, инструментами, которые она может вызывать, передачей задач другим агентам и ограничителями на входе и выходе, всё это работает в цикле, пока задача не решена. Это отличный способ создать агента. Но сам по себе он не даёт вам ни номера WhatsApp, ни входящих команды, ни шаблонных сообщений, ни способа для человека подхватить диалог. С Agent Harness от MonoChat вы выбираете OpenAI Agents SDK как ИИ Harness, помещаете узел «ИИ-агент» в сценарий, подключаете WhatsApp и тестируете, а остальное берёт на себя MonoChat.

В этом руководстве описано, что даёт SDK, три способа использовать агентов OpenAI в MonoChat, пошаговая настройка и особенности WhatsApp, от которых зависит доверие клиентов к агенту.

Что даёт OpenAI Agents SDK

SDK построен вокруг небольшого набора идей:

• Агенты: модель плюс инструкции, описывающие её задачу.
• Инструменты: функции, которые агент может вызывать, например «найти заказ» или «проверить свободное время», а также серверы MCP.
• Передача между агентами (handoffs): один агент передаёт задачу другому, который в ней специализируется, например от общего агента поддержки к агенту по возвратам.
• Ограничители (guardrails): проверки, работающие рядом с агентом, чтобы остановить нежелательные входные или выходные данные.
• Сессии и трассировка: память между репликами и запись того, что агент делал, шаг за шагом.

Вместе это и есть agent harness: цикл, позволяющий модели действовать, проверять свою работу и продолжать, а не отвечать один раз. Для клиентских сообщений это разница между объяснением правил возврата и реальным созданием возврата.

Что WhatsApp добавляет к задаче

Создание агента — только половина работы. Чтобы поставить его перед клиентами в WhatsApp, нужно решить следующее:

• WhatsApp Business Platform. Официальное подключение к API, верифицированная компания и одобренный номер.
• 24-часовое окно. Ответы в свободной форме разрешены в течение 24 часов после последнего сообщения клиента; после этого нужен одобренный шаблон.
• Политика. С 15 января 2026 года WhatsApp не допускает на платформе ИИ-ассистентов общего назначения. Агент, обслуживающий ваших клиентов, разрешён, а при автоматических ответах ожидается понятный путь к человеку.
• Люди. Некоторые диалоги должны попадать к человеку с сохранённой историей, в инструменте, которым уже пользуется ваша команда.
• Другие каналы. Клиенты, которые пишут в Instagram, Messenger или на вашем сайте, ждут тех же ответов.

MonoChat берёт это на себя вокруг агента, так что ваша работа остаётся сосредоточенной на самом агенте.

Три способа использовать агентов OpenAI в MonoChat

Вариант	Где работает	Что нужно
OpenAI Agents SDK	Внутри MonoChat	Ничего дополнительного; используются ваши ИИ-модели
OpenAI Agents API (размещается у OpenAI)	Облако OpenAI	Ваш ключ OpenAI API
Собственный (ваш сервис на Agents SDK)	Ваш собственный сервер	URL эндпоинта и общий секрет

Начните с harness OpenAI Agents SDK, если вам нужен агент в стиле OpenAI без развёртывания. Выберите OpenAI Agents API, если ваши агенты уже живут на облачной платформе OpenAI. Выберите «Собственный», если ваши разработчики написали собственного агента на SDK, со своими инструментами, передачей между агентами и тестами, и хотят продолжать запускать этот код; см. как подключить собственного ИИ-агента к WhatsApp.

Шаг за шагом: агент OpenAI Agents SDK в WhatsApp

1. Добавьте ИИ Harness

Добавьте ИИ Harness в MonoChat и выберите провайдера OpenAI Agents SDK. Он работает внутри MonoChat и использует уже настроенные вами ИИ-модели, поэтому для этого шага не нужны ни дополнительные ключи, ни серверы.

2. Добавьте узел «ИИ-агент» в сценарий

В сценарии, принимающем ваши диалоги в WhatsApp, добавьте узел «ИИ-агент» и выберите harness. Напишите инструкции для агента: кого он обслуживает, что умеет, чего не должен делать никогда и когда передаёт диалог.

3. Выберите основную, резервную и быструю модели

У каждого узла «ИИ-агент» три роли моделей:

• Основная модель рассуждает и пишет ответы.
• Резервная модель подключается после мягкого лимита или сбоя.
• Быстрая модель выполняет фоновые задачи.

Добавьте лимит бюджета на запуск, чтобы один необычный диалог не привёл к большому счёту. Не уверены, как выбрать резервную модель? Прочитайте почему вашему клиентскому ИИ-агенту нужна резервная модель.

4. Подключите инструменты

Дайте агенту инструменты, соответствующие вашим самым частым запросам:

• ИИ-инструменты функций для вызовов ваших API со структурированными входными данными.
• Интеграция MCP для инструментов из совместимых с MCP систем.
• ИИ-база знаний для ответов, опирающихся на ваши документы и правила.
• Пользовательские функции для логики, выполняемой внутри диалога.

Три хороших инструмента лучше пятнадцати недотестированных. Добавляйте новые, когда увидите реальные диалоги.

5. Подключите WhatsApp (и всё остальное)

Подключите номер WhatsApp Business через MonoChat, официального бизнес-партнёра Meta. Тот же сценарий может работать в Instagram, Messenger, TikTok, Telegram, веб-чате, SMS и голосе, так что один агент охватывает все каналы.

6. Протестируйте на реальных сообщениях

Используйте диалоги за прошлый месяц как тестовый набор. Включите сложные: рассерженных клиентов, расплывчатые вопросы, несколько просьб в одном сообщении, клиента, который сразу просит человека. Проверьте вызовы инструментов, тон и передачу диалога. Затем запускайте.

Подходы, которые хорошо работают в WhatsApp

Один вопрос в сообщении. Агенты, созданные для веб-чатов, склонны отвечать длинными списками. На телефоне короткие сообщения и один понятный вопрос за раз вызывают лучшие ответы клиентов.

Подтверждайте перед необратимыми действиями. Пусть агент предлагает, а клиент подтверждает перед отменой, возвратом или изменением бронирования.

Специалисты через передачу между агентами, люди через входящие. Передача между агентами в SDK отлично подходит для маршрутизации между агентами (продажи, поддержка, возвраты). Передача человеку происходит в общих входящих команды MonoChat, куда диалог приходит с полной историей.

Инструкции с названными пределами. «Возвраты до €50 можешь одобрять; выше передавай команде биллинга». Конкретные числа лучше расплывчатых правил.

Держитесь рамок вашего бизнеса. Агент, который помогает вашим клиентам, разрешён в WhatsApp. Тот, что отвечает на что угодно, рискует нарушить правила WhatsApp 2026 года; где проходит граница, объясняет наше руководство по политике WhatsApp для ИИ-чат-ботов.

Затраты

Складываются три статьи: ваш тариф MonoChat, использование ИИ-моделей и сборы Meta за сообщения WhatsApp. С 1 октября 2026 года Meta берёт плату за ответы в рамках обслуживания после первых 1000 в месяц на каждый бизнес-номер; см. наше руководство по ценам WhatsApp API.

Что касается ИИ, MonoChat не добавляет наценку, когда вы используете собственные ключи провайдеров. Бюджеты на запуск, более дешёвая быстрая модель для фоновых задач и надёжная резервная модель делают счёт предсказуемым.

Без привязки

Agent Harness позволяет выбирать фреймворк, а не только модель. Если позже вы захотите попробовать Claude Agent SDK, Pi, Claude Managed Agents или собственный фреймворк, добавьте другой ИИ Harness и направьте на него узел «ИИ-агент». Ваши каналы, инструменты и передача диалога останутся прежними. Сравните всех провайдеров на странице Agent Harness.