Как запустить агента Claude Agent SDK в WhatsApp (с MonoChat)

Claude Agent SDK — это harness агентов от Anthropic: тот же цикл рассуждения, использования инструментов и самопроверки, на котором работает Claude Code, упакованный так, чтобы разработчики могли создавать собственных агентов. Чтобы запустить такого агента в WhatsApp, вокруг него нужны ещё три вещи: подключение к WhatsApp Business Platform, способ дать агенту ваши бизнес-инструменты и безопасный путь к человеку, когда агенту нужно остановиться. С Agent Harness от MonoChat вы добавляете Claude Agent SDK как ИИ Harness, помещаете узел «ИИ-агент» в сценарий, подключаете номер WhatsApp и тестируете. Запускать серверы не нужно.

В этом руководстве объясняется, что Claude Agent SDK даёт клиентским диалогам, как работает настройка в MonoChat и что важно сделать правильно до того, как клиенты начнут писать.

Что такое Claude Agent SDK (и почему он подходит для поддержки)

Большая часть ИИ в WhatsApp сегодня — это один вызов модели: приходит сообщение, модель пишет ответ, готово. Для вопроса «Какие у вас часы работы?» этого достаточно. Для «Мой заказ не пришёл, а в пятницу я уезжаю» этого уже мало.

Harness запускает модель в цикле. Модель решает, что делать дальше, harness выполняет этот шаг (найти данные, вызвать инструмент, прочитать файл), возвращает результат и повторяет, пока задача не решена или не понадобится человек. Claude Agent SDK — версия такого цикла от Anthropic. Это основа Claude Code, и он включает строительные блоки, на которые полагаются разработчики: использование инструментов, поддержку MCP, субагентов, управление контекстом для длинных сессий и контроль разрешений.

В клиентских сообщениях именно этот цикл превращает ответ в решение:

• Он проверяет, прежде чем обещать. Наличие товара, статус доставки, свободные слоты записи или правило возврата проверяются в момент ответа, а не угадываются.
• Он ведёт обращение в несколько шагов. Найти заказ, проверить перевозчика, увидеть, что посылка застряла, предложить замену, и всё в одном диалоге.
• Он знает, когда остановиться. Хороший harness передаёт обращение человеку, а не импровизирует, когда доходит до границы допустимого.

Если нужна справка о различии между harness и обычным вызовом модели, прочитайте что такое agent harness и почему он нужен поддержке в WhatsApp.

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

MonoChat поддерживает три пути к агенту на основе Claude. Все три используют один и тот же узел «ИИ-агент», те же каналы и ту же передачу диалога.

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

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

Шаг за шагом: агент Claude Agent SDK в WhatsApp

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

В MonoChat ИИ Harness — это определение сервиса, которое вы добавляете один раз и используете повторно. Добавьте его и выберите провайдера Claude Agent SDK. Для самого провайдера больше ничего настраивать не нужно: он работает на агентном раннере MonoChat и обращается к вашим ИИ-моделям через шлюз MonoChat.

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

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

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

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

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

Задайте также лимит бюджета на запуск. Клиентскому диалогу редко нужна длинная цепочка шагов, а бюджет не даёт необычному случаю стать дорогим. Наша статья о том, почему вашему клиентскому агенту нужна резервная модель, объясняет, как выбрать пару.

4. Дайте агенту инструменты

Агент без инструментов умеет только говорить. В MonoChat агент может использовать:

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

Начните с двух-трёх инструментов, покрывающих самые частые запросы. Каждый добавленный инструмент — это ещё одна возможность агента и ещё одна вещь для тестирования.

5. Подключите WhatsApp и другие каналы

Подключите номер WhatsApp Business к MonoChat, если вы ещё этого не сделали (MonoChat — официальный бизнес-партнёр Meta и использует официальную WhatsApp Business Platform). Поскольку агент живёт в сценарии, тот же сценарий можно подключить к Instagram, Messenger, TikTok, Telegram, веб-чату, SMS и голосу, ничего не перестраивая.

6. Протестируйте и запустите

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

Как писать инструкции для агента в WhatsApp

Claude Agent SDK вырос в программировании, где длинные подробные ответы уместны. WhatsApp — наоборот. Несколько правил дают большую разницу:

• Пишите короткие ответы. Два-три предложения в сообщении, по одному вопросу за раз. Клиенты читают на телефоне.
• Подтверждайте перед действием. «Я могу отменить заказ 4821 и вернуть €39. Выполнить?» перед всем, что стоит денег или не может быть отменено.
• Прямо назовите правило передачи. Например: «Передавай человеку при жалобах на сотрудников, юридических угрозах, возвратах свыше €100 или когда клиент просит человека».
• Оставайтесь в рамках вашего бизнеса. С 15 января 2026 года условия WhatsApp не допускают на платформе ИИ-ассистентов общего назначения. Агент, обслуживающий ваших клиентов, допустим; тот, что пишет эссе на любую тему, нет. Это правило объясняет наше руководство по политике WhatsApp для ИИ-чат-ботов.
• Учитывайте 24-часовое окно. Ответы в свободной форме разрешены в течение 24 часов после последнего сообщения клиента. После этого для сообщения нужен одобренный шаблон.

Передача человеку: то, от чего зависит доверие

Клиенты прощают агента, который говорит «Сейчас позову коллегу». Они не прощают того, кто ходит по кругу. В MonoChat агент передаёт диалог вашей команде в общих входящих с полной историей: о чём спросил клиент, что агент проверил и что уже пробовал. Сотруднику, который подхватывает диалог, не нужно просить клиента начинать заново.

Продумайте правила передачи раньше, чем инструменты. Решите, какие случаи агент никогда не должен вести в одиночку, кто их получает и что агент говорит клиенту, пока тот ждёт.

Затраты и контроль

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

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

Когда выбрать другой harness

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