Сценарий — это визуальная схема поведения. Вы не пишете код: логику задаёте блоками и стрелками между ними.
Черновик и публикация
У бота один основной (активный) сценарий — именно он отвечает людям. Рядом с ним можно держать дополнительные сценарии: их запускают только VK-лендинги и ссылки на бота, у которых этот сценарий выбран целью (см. «Дополнительные сценарии» ниже).
Черновик — рабочая копия сценария: он сохраняется автоматически по мере правок и на бота не влияет. «Опубликовать» копирует черновик в опубликованный сценарий бота. Если такой сценарий у бота уже есть, его содержимое целиком заменяется, поэтому перед публикацией редактор спросит подтверждение. Прежняя активная версия при этом не теряется: если её нет ни в одном черновике (например, вы правили активный сценарий вживую), она сохранится отдельным черновиком «… (была активной до дата время)» — его можно открыть и опубликовать обратно. Сам черновик после публикации остаётся в списке карточкой «Черновик»: его дальнейшие правки в бой не идут, а повторная публикация снова целиком заменит активный сценарий. Открытые у соредакторов редакторы активного сценария перечитают его сразу.
Активный сценарий редактируется вживую: каждая правка сохраняется автоматически и сразу применяется к боту. Перед сохранением она проходит те же проверки, что и публикация. Прежнее состояние попадает в историю версий, откатиться можно кнопкой «История». Правка с ошибкой (например, к сценарию подключён пустой блок «Сообщение») не сохранится: редактор покажет «Изменения не сохранены», подсветит проблемные блоки, а бот продолжит работать на последней корректной версии. Поправьте ошибку — и правка сохранится.
Пропала связь — редактор покажет «не сохранено» и повторит сам через 10 секунд; закрыть вкладку с несохранёнными правками браузер без вопроса не даст, а уйти по ссылке с правкой, которую сервер не принял, редактор не даст без подтверждения. Истекла сессия — откроется вход, после него вы вернётесь в сценарий.
Правка неактивного опубликованного сценария сохраняется, но активным его не делает: какой сценарий у бота активный, переключает «Сделать активным» на странице бота.
Дополнительные сценарии (для лендингов и ссылок)
Дополнительный сценарий опубликован рядом с основным и основной не заменяет: подписчик попадает в него только по VK-лендингу или ссылке на бота с этим сценарием-целью (при создании ссылки в «Ссылках на бота» выберите сценарий; «Скопировать диплинк» на шаге дополнительного сценария сам ведёт в него). Так у одного бота может быть общая воронка и отдельные сценарии под каждый лендинг или рекламную кампанию.
Как опубликовать: откройте черновик и нажмите «Как дополнительный» рядом с «Опубликовать» (или кнопку «Опубликовать как дополнительный» прямо в редакторе VK-лендинга). Проверки те же, что у основного: ошибки блокируют публикацию, сценарий с запуском по расписанию или отправкой в заданный чат токену MCP нужно право «Рассылки и сообщения». Публикуется сам сценарий, без копии: его правки дальше применяются вживую, как у основного. Кнопка есть, только если у бота уже есть основной сценарий; основной сценарий дополнительным сделать нельзя. В дополнительном сценарии не работают триггеры, которые слушает только основной: «По расписанию», «Заявка с сайта», события канала или группы, комментарии и вебхук — с ними публикация не пройдёт. Если сценарий — копия основного, при первой публикации его блоки получают новые внутренние номера, чтобы кнопки и ответы двух сценариев не путались. В режиме «сессия на сценарий» дополнительные сценарии недоступны.
Что видит подписчик: по лендингу или ссылке он начинает с команды /start дополнительного сценария (если её нет — с первого триггера или первого блока; у ссылки на шаг — с этого шага). Ответы на его вопросы, его кнопки, задержки и оплаты продолжаются в нём, даже если основной сценарий другой — как при «Перейти в другой сценарий». Команды и ключевые слова матчатся по основному сценарию, а любой старт — /start, /start с кодом ссылки на основной сценарий, кнопка «Начать» в VK — ведёт в основной: если подписчик в этот момент ждал ответа на вопрос дополнительного сценария, ожидание снимается. Триггер «Оплата прошла» в дополнительном сценарии срабатывает только для подписчика, который сейчас в нём (тогда основной на эту оплату не запускается). Когда дополнительный сценарий доходит до блока «Конец» или подписчик запускает команду или ключевое слово основного сценария, он возвращается в основной. Если сценарий открыт в редакторе у кого-то со старой копией после такой публикации, его правки не сохранятся с подсказкой перезагрузить страницу.
Если цель лендинга или ссылки не опубликована как дополнительный сценарий (черновик), удалена или это сам основной сценарий — подписчик попадает в основной сценарий, как раньше. Редактор лендинга показывает, что именно запустится, а в списке лендингов такой лендинг помечен «цель не опубликована».
В списке сценариев бота такие сценарии помечены «Дополнительный», основной — «Основной». В меню карточки: «Снять с публикации» — сценарий снова черновик, ссылки и лендинги ведут в основной, подписчики, остававшиеся в нём, возвращаются в основной, его задержки отменяются; «Сделать основным» — он становится основным сценарием бота. Публикация основного сценария дополнительные не трогает. Журнал прогонов и аналитика считаются по самому дополнительному сценарию; «Тест» в его редакторе работает как обычно. Дополнительный сценарий занимает место в лимите сценариев тарифа.
Что проверяется перед публикацией
Публикация не пройдёт, если схема пустая — публиковать нечего. Пустым сценарием нельзя случайно затереть работающего бота.
Ошибки (красный баннер) блокируют публикацию; предупреждения (жёлтый баннер) — нет, но их стоит прочитать. Частое предупреждение — «нет точки входа»: схема есть, а начать её некому.
Те же проверки проходит каждая правка активного сценария — в том числе платные блоки и лимит блоков вашего тарифа.
История версий и откат
История версий: в редакторе кнопка «История» открывает панель со снимками сценария. Снимок создаётся при каждой публикации, при правке работающего сценария (не чаще раза в 10 минут: сохраняется состояние до правки) и по кнопке «Сохранить версию» (можно добавить подпись). Каждая версия показывает дату, автора, причину (публикация, ручное сохранение, автосохранение, откат) и число блоков.
Что можно сделать с версией: открыть её отличия от текущего сценария (сколько блоков добавлено, удалено, изменено и отличаются ли связи), нажать «Просмотр» — версия откроется на холсте только для чтения, ничего не меняя, — или «Восстановить». Откат равносилен публикации выбранной версии: у работающего сценария он применяется к боту сразу и проходит те же проверки, что и обычная правка (если проверка не пройдена, бот остаётся на текущей версии и редактор покажет причину). Текущее состояние перед откатом само сохраняется отдельной версией, так что откат можно отменить тем же способом. Откат доступен владельцу и редакторам, наблюдатель только смотрит; перед ним дождитесь сохранения правок.
Сколько хранится: последние 50 версий каждого сценария и все публикации и откаты за последние 90 дней; ещё у сценария есть общий потолок по объёму снимков, и в первую очередь освобождается место от самых старых автосохранений. Версии удаляются вместе со сценарием. История привязана к опубликованному (работающему) сценарию: черновик, из которого вы публиковали, свою историю не ведёт. Для надёжной копии перед крупной переделкой по-прежнему есть «Экспорт». Агенты через retensy-mcp видят те же версии инструментами graph_versions_list и graph_version_rollback.
Какие бывают блоки
Блоки сгруппированы по назначению. Ниже — что делает каждая группа.
Сообщения
«Сообщение» — один блок для всего, что бот пишет: внутри него карточки — текст, картинка, файл, аудио, видео, голосовое, видео-заметка, галерея, кнопки и вопрос. Отдельных блоков «Картинка» и «Вопрос» в палитре нет — это карточки «Сообщения».
По умолчанию сообщение уходит тому, кто в диалоге. В настройках блока можно выбрать другого получателя: конкретный чат/канал или адрес из переменной — это нужно для сценариев-вебхуков, где «текущего собеседника» нет.
«Случайный текст» — блок выдаёт подписчику один случайный текст из вашего списка целиком (например, случайную историю, цитату или совет дня). Тексты вводятся в настройках блока по одному, либо вставляются пачкой (разделитель — строка из трёх дефисов ---), либо загружаются из файлов .txt (несколько файлов сразу). В списке до 500 текстов, каждый до 65 536 символов, все вместе до 1 500 000 символов (сценарий целиком не больше 4 МБ). Два режима: «Отправить сообщением» — текст уходит подписчику (если он длиннее лимита канала, Telegram 4096 знаков, MAX 4000, он автоматически делится на несколько сообщений по границам абзацев; галочка «Делить длинный текст» отключает деление, тогда лишнее обрезается) или «Сохранить в переменную» — текст кладётся в переменную, и дальше его можно вставить в любое сообщение как {{var.имя}} (в переменную помещается до 65 536 знаков). Галочка «Не повторять, пока не выданы все тексты» запоминает у каждого подписчика, что он уже получил, и выдаёт каждый текст по разу, пока список не кончится, затем круг начинается заново (новый круг не начинается с текста, которым закончился прошлый). В текстах работают подстановки {{from.first_name}} и {{var.имя}}. Выходы: «Дальше» и «Ошибка» (пустой список, не получилось отправить, переменная не сохранилась). В режиме «Тест» блок работает как обычно. Чтобы выдать длинный текст целиком, используйте именно этот блок, а не базу знаний агента.
Логика и ветвления
«Условие» — развилка «да / нет» по одному или нескольким условиям: метка, поле или переменная, имя, email, телефон, username, UTM-метка, подписка на канал, клик по ссылке из шага, текущая дата, время, день недели, канал «Telegram Business» (сообщение пришло через бизнес-аккаунт или из обычного чата с ботом). «Рандомайзер» — случайно делит подписчиков между ветками для A/B-теста. «Формула» — вычисление над переменными (например посчитать сумму).
«Развилка по значению» — когда веток больше двух: указываете, что сравнивать (обычно переменную), и перечисляете значения. Каждое значение — свой выход, всё остальное уходит в выход «Иначе». Сравнение без учёта регистра и пробелов по краям. Оба вида развилки добавляются одной кнопкой «Условие»: клик открывает выбор — «да / нет» или по значению.
«ИИ-развилка» — ветвление по смыслу сообщения для всех ботов. Это режим блока «ИИ-разбор» («ИИ-развилка по правилам»): в поле правил вы простым языком описываете, когда куда идти, и помечаете ветки метками с решёткой, например «Если клиент согласен купить - #да. Если спрашивает цену - #цена. Если отказывается - #нет». Каждая метка (буквы, цифры и _, до 10 штук, без повторов) сразу появляется выходом блока на холсте, плюс выход «Иначе». ИИ видит последнее сообщение клиента, короткую историю чата и переменные сценария и выбирает одну метку; выбранная метка сохраняется в переменную ai_route (или в вашу), а короткая причина в ai_route_reason. Если ИИ не ответил за 8 секунд (время можно изменить от 1 до 30), вернул ошибку, не выбрал известную метку или кончились ИИ-токены тарифа, сценарий идёт по выходу «Иначе» и не ломается. Каждый вызов тратит ИИ-токены тарифа (вид расхода «разбор»). В режиме «Тест» модель не вызывается — путь идёт по «Иначе». Все метки должны быть соединены со следующим шагом, иначе сценарий не опубликуется.
«Действия» — список шагов, которые в основном ничего не пишут в чат: теги и переменные подписчика, строка в Google Таблицы, сделка в CRM, внешний запрос, счёт на оплату. Клик по «Действие» открывает список всех действий, сгруппированный по темам: выбранное сразу ложится в новый блок первым, остальные добавляются кнопкой внутри блока. «Отправить уведомление» пишет вам в бот уведомлений, подключённый в профиле (Telegram или MAX); если он не подключён, блок уйдёт в выход «Ошибка».
«Остановить с ошибкой» — служебный блок: обрывает прогон и помечает его ошибочным с вашим текстом, чтобы неудачная ветка не выглядела в журнале успешной. В палитре его нет — он приходит в сценариях, собранных через MCP или импорт, и работает там как обычно.
Живой Telegram-бот — три действия блока «Действия» (только Telegram). «Показать «печатает…»» — в шапке чата появляется статус «печатает…», «записывает голосовое…» или «отправляет фото…»; он держится около 5 секунд или до следующего сообщения, поэтому ставьте его перед «Задержкой» на 2–4 секунды. «Поставить реакцию» — бот ставит эмодзи-реакцию (👍, ❤, 🔥, 🎉 и другие стандартные) на последнее сообщение подписчика или на сообщение с указанным id: живой отклик на ответ в анкете или квизе. «Бросить кубик» — анимированный кубик, дартс, мяч, боулинг или слот; выпавшее число (кубик, дартс, боулинг — 1–6, мяч — 1–5, слот — 1–64) сохраняется в переменную, дальше «Условие» решает, выиграл ли подписчик скидку. Если Telegram не принял действие (реакции в чате выключены), блок уходит в выход «Ошибка».
Блок «Опрос / квиз» (только Telegram) — нативный опрос Telegram: вопрос и от 1 до 12 вариантов. У каждого варианта на холсте свой выход, «Дальше» — любой ответ без своей ветки. Сценарий ждёт голос подписчика, его текстовые сообщения ожидание не снимают. Режим «Квиз» — один верный ответ (Telegram подсветит его и покажет пояснение), можно разрешить несколько ответов в обычном опросе (ветка по первому). Ответ сохраняется в переменную: текст варианта, {имя}_index — номер варианта с 0, у квиза {имя}_correct — 1 или 0. Опрос неанонимный: бот видит, кто как ответил.
Ещё про кнопки Telegram: тип «Неактивная» — плашка без действия («Мест нет», «Скоро»); в поповере цвета кнопки можно указать id кастомного эмодзи — он встанет иконкой слева от текста. У блока «Вопрос» с текстовым ответом галочка «Сразу открыть поле ответа» открывает у подписчика поле ответа на сообщение бота (удобно в группах), с подсказкой в поле ввода.
ИИ-ответ в простом режиме с отправкой подписчику может «печататься» по мере генерации — галочка «Печатать ответ по мере генерации» (Telegram, личный чат): подписчик видит текст, пока модель пишет, итог приходит обычным сообщением. У ИИ-агента ответ проверяется целиком до отправки, поэтому там стриминга нет.
Кнопка «Копировать» в сообщении (тип кнопки рядом с «Переход», «Ссылка» и «Mini App», только Telegram): по нажатию Telegram копирует заданный текст в буфер — промокод, реквизиты, адрес. Текст до 256 символов, подстановки {{var.…}} работают, перехода дальше по такой кнопке нет.
«Удалить сообщение» — убирает сообщение у подписчика. Что удалить: предыдущее сообщение бота; последнее сообщение выбранного блока (например, блока со ссылкой-приглашением, которую нужно убрать после того, как человека исключили из канала); последнее сообщение подписчика (только Telegram, в личке); сообщение, которое отправит следующий блок. Можно удалить сразу или через паузу меньше 24 часов, сценарий при этом не останавливается. Режим «сообщение следующего блока» работает, только если следующий блок отправляет сообщение сразу (без «Задержки» между ними); если блок «Действия» отправил несколько сообщений, удаляется последнее; удаление сообщения подписчика работает только в личке Telegram. Ограничения платформ: Telegram даёт удалить сообщение бота в течение 48 часов, VK в течение 24, в MAX удаляются сообщения бота. Если удалить нельзя (прошло слишком много времени, сообщение уже удалено), сценарий идёт дальше, а шаг в журнале помечается ошибкой и попадает в аналитику.
«Выгнать или забанить в канале/группе» — действие блока «Действия» (раздел «Группы»). Режим «Выгнать»: человек уходит из канала или группы, но не заблокирован — если у него есть ссылка-приглашение, он сможет вернуться (в Telegram бот банит и сразу разбанивает). Режим «Забанить»: вернуться по ссылке нельзя, срок бана в днях можно задать (от 1 до 366), без срока бан бессрочный. Канал или группу выбирают из подключённых к боту, либо вводят ID, @username или переменную; пользователь — текущий подписчик. Бот должен быть администратором с правом блокировать участников. Если прав нет или человека нет в чате, блок уходит в выход «Ошибка» (появляется на карточке сам), а сценарий не падает. Платформы: Telegram — все режимы; MAX — «Выгнать» и бан навсегда, бан на срок недоступен; VK — только «Выгнать» из беседы сообщества (бот — админ беседы, указывается номер беседы), бан в VK недоступен: в конструкторе появится предупреждение. В пробном прогоне ничего реально не вызывается. Хорошо сочетается с «Удалить сообщение»: выгнали — и сразу убрали сообщение со ссылкой-приглашением.
«Перейти в другой сценарий» — действие блока «Действия» с двумя режимами (выбираются в настройках). «Перейти» — подписчик уходит в выбранный сценарий этого же бота и продолжает там, а текущий сценарий на этом заканчивается. Удобно, чтобы не держать всю воронку на одном холсте: меню, оплата, анкета — отдельными сценариями. «Вызвать и вернуться» — то же самое, но когда вызванный сценарий дойдёт до конца, подписчик автоматически возвращается сюда и продолжает со следующего шага после этого блока; это работает, даже если между вызовом и возвратом сервер перезапустился — состояние хранится у подписчика, а не только в оперативной памяти. Удобно для переиспользуемых кусков вроде «спросить адрес» или «проверить подписку», к которым обращаются из разных мест. Ответы на вопросы и нажатия кнопок вызванного сценария обрабатывает он сам, даже если активный сценарий бота другой. Старт — с команды /start выбранного сценария, если её нет — с первого триггера, а у сценария без триггеров (подсценария) — с первого блока без входящих связей. В настройках можно передать переменные: они сохраняются подписчику до перехода, значения поддерживают подстановки {{var.…}}. Действие ставится последним в блоке — после перехода (или вызова) остальные не выполнятся. Защита от зацикливания общая для обоих режимов: в одной цепочке переходов/вызовов сценарий не может повториться, и суммарно их не больше 5 подряд — иначе шаг завершается ошибкой и блок уходит в ветку «Ошибка». Переход возможен только в сценарии своего бота; вебхук-сценарии, где бот лишь отвечает, и сценарии других ботов выбрать нельзя. Целевой сценарий может быть черновиком — тогда его правки сразу видят подписчики, которые в него уже перешли или вызвали его. Кнопки и вопросы вызванного сценария продолжают работать и позже. Служебные переменные (имя начинается с «_») передать нельзя.
Ожидание и ввод
Вопрос — карточка «Вопрос» в блоке «Сообщение»: бот спрашивает и сохраняет ответ в переменную. Выходы: «Ответил»; «Не ответил» — ответ не прошёл проверку за отведённые попытки; «Нет ответа» — появляется, если задано время ожидания, и срабатывает, когда человек так и не ответил.
«Задержка» — пауза перед следующим шагом. «Расписание» — запуск ветки в заданное время. Если у многих подписчиков пауза заканчивается в одно время (например, «завтра в 12:00»), сообщения уходят не разом, а постепенно — примерно по 10 в секунду на бота (1000 подписчиков — около 2 минут, 10 000 — около 17 минут), так бот не упирается в лимиты Telegram. Если Telegram всё же попросил бота подождать, срабатывания задержек ждут конца этой паузы. Ответ подписчику, который пишет боту прямо сейчас, отправляется сразу, без ожидания; если Telegram откажет и ему, шаг уходит в ветку «Ошибка», если она проведена, иначе сценарий идёт дальше по обычному выходу.
Внешние сервисы
«Внешний запрос» — HTTP-запрос к вашему API или CRM: отправить данные или получить ответ и разложить его по переменным. Живёт он действием внутри блока «Действия» — отдельного блока для него нет, чтобы одна и та же возможность не была в двух местах; в палитре ищите его в списке действий под кнопкой «Действие».
Код ответа и тело целиком можно сохранить в переменные и дальше ветвиться по ним «Развилкой по значению»; отдельные поля достаются по пути JSONPath. При сетевой ошибке и таймауте код будет 0, а тело пустым. Таймаут настраивается от 0,5 до 30 секунд.
Если запрос не удался (чужой сервис лёг, таймаут, код 400 и выше), блок «Действия» уходит в свой выход «Ошибка» — он появляется на карточке сам, как только в блоке есть действие, которое ходит наружу. Не нарисовали ветку «Ошибка» — сценарий просто идёт дальше по обычному выходу.
Внешний запрос доступен на платных тарифах.
«Отправить письмо» — ещё одно действие внутри блока «Действия»: шлёт письмо на один адрес (шаблон {{var.*}} в поле «Кому» — например {{var.email}}), с темой, текстом и необязательным Reply-To. Текст — только обычный текст: HTML-теги не поддерживаются и уйдут в письме как есть, без разметки. Массовой рассылкой это действие не станет — адрес один, и в сутки с одного аккаунта (и в целом по сервису) уходит ограниченное число писем; при превышении лимита, неверном адресе или сбое почтового сервера блок «Действия» уходит в выход «Ошибка», как и любое внешнее действие.
«AI-агент» — блок с ответом языковой модели, два режима (переключаются в настройках блока). «Простой» — модель отвечает по вашему промпту, ответ можно отправить подписчику и/или сохранить в переменную. «Агент» — модель ищет ответ по подключённой базе знаний, умеет уходить в отдельные ветки-действия и помнит историю разговора на этом блоке. Оба режима доступны на платных тарифах и расходуют общий месячный бюджет ИИ — подробнее в разделе «Тарифы и оплата». Если модель не отвечает (сбой у провайдера), блок уходит в выход «Ошибка» примерно через минуту.
Агента можно проверить в разделе «ИИ-агенты» → «Тестирование».
«Прямой ответ на точное совпадение» — отдельная галочка в настройках блока, по умолчанию ВЫКЛЮЧЕНА. Включив её, вы получаете бесплатный ответ без обращения к модели: срабатывает, только если вопрос подписчика почти дословно совпал с одной из ваших пар вопрос-ответ в базе знаний. На произвольный вопрос так агент не ответит — для этого и нужна модель. Прямой ответ, как и обычный, не сработает, если месячный бюджет ИИ уже исчерпан (бюджет проверяется раньше поиска по базе).
Без найденных в базе фрагментов (нет базы вовсе или релевантность ниже порога) агент в ЛЮБОМ режиме уходит в ветку «не знаю» — до модели дело не доходит. Исключение — блок с «Действиями»: просьбу вроде «запишите меня на завтра» в базе не найти, поэтому такой блок и без фрагментов спросит модель, чтобы та могла выбрать действие; ответить от себя без фрагментов она не сможет ни в каком режиме — уйдёт в «не знаю». «Строгий режим» (включён по умолчанию) решает, что происходит, когда фрагменты УЖЕ нашлись: агент отвечает только по ним, не выдумывая. Без строгого режима агент может дополнить найденное общими знаниями модели, но не про цены, сроки и обещания — их он всегда берёт только из базы и вашей инструкции. Строгий режим без выбранной базы знаний публиковаться не даст; сняв галочку, сценарий опубликуется, но агент без базы всё равно ничего не найдёт и будет неизменно отвечать «не знаю» — «нестрогий» не означает «работает без базы».
«Действия» агента — ветки, между которыми модель выбирает сама по смыслу разговора (например «Оформить заказ» или «Позвать менеджера»): дайте каждому название (без него действие никак не появится на холсте) и, если нужно, условие «когда применять», и протяните от блока свою стрелку для каждого — публикация не пройдёт, пока у действия нет своей стрелки: иначе модель могла бы выбрать его, а идти было бы некуда. Ветку «не знаю» стрелкой лучше тоже не оставлять пустой — публикацию она не блокирует, но не подключенная, оставит диалог в тупике там, где нужен человек.
«Извлекать из разговора» — переменные, которые агент сам заполняет, если клиент их упомянул (например телефон или город); это слова клиента, а не проверенный факт. При уходе в действие агент готовит и краткую сводку разговора для менеджера — она доступна как {{var.ai_summary}} без отдельной настройки, тоже словами клиента, не проверенными данными.
Защиту от попыток выманить инструкцию агента или заставить его забыть правила, запрет обещать несделанное и формат ответа под конкретный мессенджер платформа добавляет сама — дублировать это в своей инструкции не нужно.
Инструкция агента (system prompt) — до 10 000 символов: длиннее модель хуже держит середину, и каждый ответ дороже. Жёсткий потолок — 30 000 символов, длиннее сценарий не опубликуется. В отличие от промпта простого режима, подстановки вида {{var.x}} в инструкции агента не работают — текст уходит модели как есть. Так же, без подстановок, уходит и текст на случай исчерпания бюджета (ниже) — в обоих режимах.
Исчерпание бюджета ИИ у агента — не «идёт дальше как обычно»: у этого блока нет обычного выхода, поэтому он уходит в свою ветку «Бюджет ИИ исчерпан» (если вы её подключили) либо в ветку «Ошибка». Запасной текст на этот случай задаётся прямо в настройках блока — для обоих режимов.
База знаний агента собирается из файлов, сайтов и пар вопрос-ответ — подробнее в подразделе «База знаний» ниже.
«Выставить счёт» — приём оплаты на вашу кассу ЮKassa (для Telegram-ботов есть и «Выставить счёт в звёздах», см. раздел «Оплата звёздами Telegram»). Это тоже действие внутри блока «Действия», в группе «Оплата», отдельного блока для него нет. Если протянуть от блока ветку «Оплачено», сценарий дождётся платежа и продолжится только после него; появится и ветка «Не оплатили вовремя». Не протянули — бот просто пришлёт счёт и пойдёт дальше. Счёт ставьте последним действием в блоке: после него блок ждёт оплату, и следующие действия не выполнятся. Подробнее — в разделе «Подключения».
База знаний
В режиме агента блок выбирает готового агента, а не базу прямо тут: ссылка «Открыть агента» ведёт на его страницу, где база наполняется тремя способами — загрузкой файла (PDF, DOC, DOCX, TXT, MD, HTML, CSV, XLSX, XLS — до 20 МБ), парами вопрос-ответ и обходом сайта. Блок, собранный до перехода на агентов, может хранить прежнюю базу или инструкцию прямо в своих настройках — тогда вместо выбора агента в нём виден прежний список и ссылка «Открыть базу»: она ведёт на страницу агента-владельца или, если его не нашли, на прежний адрес /bots/knowledge, который сам перенаправит, куда нужно.
Как агент видит документы. Текст документа режется на фрагменты по 800 знаков с небольшим перекрытием (разделы с заголовками стараются не смешиваться), и агент отвечает по тем фрагментам, которые нашёл по вопросу подписчика, — не по документу целиком. Короткий документ (до 2500 знаков текста) хранится одним фрагментом и виден агенту целиком; таблицы режутся построчно, а пара вопрос-ответ — это один фрагмент. Ранее загруженные документы остаются в прежней нарезке, пока вы не загрузите их заново. Агент не пересказывает и не отдаёт документ целиком: если нужно выдать подписчику готовый текст дословно (историю, письмо, инструкцию, случайный текст из набора), используйте блок «Случайный текст» в сценарии, а не базу знаний.
Файл должен содержать настоящий текст: скан страницы без текстового слоя (просто картинка) агент не прочитает — распознавания изображений здесь нет. Таблицы (CSV/XLSX) режутся построчно, и им нужна строка заголовков — без неё поиск по таблице выйдет хуже, редактор предупредит об этом отдельной строкой у документа.
Источник «Сайт» обходит только страницы указанного домена — на чужие сайты обход не уходит. Соблюдаются запреты robots.txt (агент представляется как RetensyBot); число страниц одного сайта, которое обходится за раз, задаёт тариф. Можно задать расписание повторного обхода — «Не обновлять», «Каждый день» или «Раз в неделю» — либо запустить его вручную кнопкой «Пересканировать»; повторный обход переиндексирует только изменившиеся страницы, не всё заново.
Загрузка и обход отвечают сразу: документ появляется в статусе «В очереди», затем «Обрабатывается», пока идёт разбор и эмбеддинги — это может занять минуту-другую, статус в списке обновляется сам и заканчивается «Готово» или «Ошибка». Одновременно индексируется не больше нескольких документов и обходится не больше нескольких сайтов на владельца — при превышении редактор попросит подождать окончания текущей загрузки/обхода. Ещё один обход того же сайта, пока предыдущий не завершился, тоже придётся подождать.
Пары вопрос-ответ добавляются пачкой прямо в редакторе — до 200 пар за раз, вопрос не длиннее 500 символов, ответ — не длиннее 4000.
Число фрагментов базы ограничено тарифом — лимит общий на ВСЕ ваши базы знаний, а не на каждую отдельно: несколько баз не в обход лимита. Для пар вопрос-ответ превышение редактор покажет сразу, при добавлении пачки. Для файла и обхода сайта точное число фрагментов известно только после разбора — лимит проверяется в фоне, и при превышении документ закончится статусом «Ошибка». В карточке (и в сообщении при загрузке на странице «База знаний») будет сказано, что произошло, сколько текста вы пытались добавить и сколько места свободно из лимита тарифа, и что делать: удалить ненужные источники или повысить тариф.
Оба потолка — фрагментов базы и страниц одного сайта — растут с тарифом: на бесплатном тарифе база знаний недоступна вовсе, платные тарифы дают больше места, а старшие — больше остальных.
Проверка ИИ-клиентами
Автоматическая проверка агента и сценария: ИИ играет клиента с заданной персоной и целью, ведёт диалог, а ИИ-судья оценивает его по вашим критериям. Вкладка «Проверка» есть у агента и в редакторе сценария (кнопка «Проверка» рядом с «Тест»). Тестовые диалоги не попадают в аналитику агента и в статистику бота.
Тест-кейс — это персона клиента (кто он и как пишет), цель (чего хочет добиться) и критерии успеха своими словами, например «назвал цену из базы» или «не обещал сроков». У сценария можно добавить точные ожидания: значения переменных, метки и узел, до которого должен дойти диалог — они проверяются без ИИ. Реплик клиента в кейсе от 1 до 6, кейсов на цель до 30, в один прогон идут до 10.
Кнопка «Создать кейсы с ИИ» придумывает до 10 кейсов по базе знаний, инструкциям агента, частым вопросам без ответа или по сообщениям сценария. Кейсы можно править и удалять.
Как идёт прогон. Агента проверяет сервер: ИИ-клиент пишет агенту через ту же песочницу, что и «Тестирование» (инструменты записи в ней работают только в режиме песочницы, ничего не уходит в CRM и таблицы по-настоящему). Сценарий проходит браузер движком симулятора, ИИ-узлы сценария в проверке не отвечают — агента проверяйте на его вкладке. В конце судья выносит вердикт по каждому кейсу: пройден или нет, причина и дословная цитата из диалога. Диалог можно открыть в рамке симулятора.
Расход. Каждый запуск, создание кейсов и черновики ответов тратят ИИ-бюджет тарифа (вид расхода «тест», в цену ответа он не входит) и всегда спрашивают подтверждение с оценкой числа вызовов. Пробные ИИ-ответы без подписки не используются: без бюджета тарифа проверка недоступна. Лимиты: до 120 вызовов ИИ на прогон и до 30 прогонов в сутки; если бюджет или лимит кончились посреди прогона, он останавливается и сохраняет уже проверенное.
История и регрессии. Прогоны хранятся 180 дней; для каждого кейса видно вердикт прошлого прогона, а кейс, который раньше проходил и перестал, помечен как регрессия. Галочка «Запускать проверку перед публикацией» предлагает прогнать кейсы при публикации агента или сценария; если есть проваленные, вы получите предупреждение, но публикация не блокируется.
Инсайты. У агента под результатами есть блок «Инсайты»: из вопросов клиентов, на которые агент не ответил, и из проваленных кейсов ИИ готовит черновики пар вопрос-ответ. Места, где ИИ не знает факта, помечены [в скобках] — впишите данные и нажмите «Добавить в базу знаний»; без вашего нажатия в базу ничего не попадает. В MCP: agent_tests_run запускает проверку агента, agent_tests_list показывает кейсы и историю прогонов.
Инструменты агента (живые данные)
Кроме базы знаний агент может во время разговора заглянуть в живые данные — инструменты чтения ничего не меняют. Настраивается в кабинете агента, вкладка «Инструменты»: до 10 инструментов, каждый — своего типа. Инструменты, которые что-то записывают, описаны в следующем разделе.
amoCRM — поиск контакта по телефону/почте и статус сделки по её номеру (с человекочитаемым названием воронки и статуса, не просто номером), через уже подключённую интеграцию amoCRM. Google Таблицы — поиск строки по значению в колонке подключённой таблицы, возвращает указанные колонки. Свой HTTP-запрос — GET по шаблону адреса с именованными параметрами ({variable}), с извлечением нужного значения из JSON-ответа.
Адрес свой HTTP-запрос проверяется на внутренние/служебные адреса (localhost, локальная сеть, метаданные облака) — такие адреса инструмент не примет. Ответ ограничен по размеру и времени ожидания.
У каждого сохранённого инструмента в настройках есть кнопка «Проверить» — вызывает именно его, с параметрами, которые вы впишете, без похода к модели: удобно проверить само подключение/таблицу/адрес, не дожидаясь, когда агент решит позвать инструмент сам.
В тест-чате агента виден журнал вызовов: какой инструмент дёрнут и что вернул (или какая ошибка). Стоимость вызова инструмента входит в бюджет ИИ — так же, как обычный ответ агента.
Инструменты записи: сделки, таблицы, свой API, поля и теги
Агент может не только читать, но и записывать: создать сделку в amoCRM, обновить сделку или контакт, добавить строку в Google Таблицу, отправить POST на ваш API, сохранить поле или тег подписчика, передать диалог оператору. Каждый такой инструмент владелец включает отдельно и явно в «Инструменты» (группа «Запись»). Пока инструмент не добавлен, агент ничего не записывает.
Для каждого инструмента записи вы задаёте описание («когда использовать») и JSON-схему аргументов: какие данные агент обязан собрать у клиента (имя, телефон и т.д.), их типы, enum, pattern, длины, границы. Агент не вызовет инструмент с лишними аргументами или с данными, не подходящими под схему. Аргументы подставляются в ваши шаблоны как {имя_аргумента}: название сделки, ячейки строки, тело запроса; в Таблицу значения вида =... записываются как текст, в JSON-тело подставляются как значения, а не как кусок разметки.
Подтверждение у пользователя: для записей во внешние системы включено по умолчанию. Агент сначала описывает, что собирается сделать, и спрашивает согласие; выполняется только после ответа клиента «да» в следующем сообщении. Подтверждение действует 10 минут. Для полей, тегов и передачи оператору подтверждение по умолчанию выключено, включить можно галочкой.
Лимиты и повторы: на каждый инструмент задаются лимит вызовов на диалог (по умолчанию 3, максимум 20) и в сутки (по умолчанию 100, максимум 1000). Одинаковый вызов (тот же диалог, инструмент и данные) в течение суток второй раз не выполняется, чтобы не получить дубль сделки. Запись не начинается, если у владельца кончился бюджет ИИ.
amoCRM берёт ваше подключение из раздела «Подключения» (ошибки и повторная авторизация видны там же, а вызовы попадают в журнал интеграций). POST на свой API проходит ту же защиту, что и «Свой HTTP-запрос»: адреса из внутренней сети и метаданных облака, а также редиректы отклоняются; заголовки (например Authorization) хранятся в настройках агента и не попадают в журнал.
Проверка в песочнице: у сохранённого инструмента записи кнопка «Проверить» по умолчанию работает в режиме песочницы: проверяет аргументы и показывает, что было бы отправлено, но ничего не отправляет. Отправить по-настоящему можно галочкой «Отправить по-настоящему». Тест-чат агента тоже ничего не пишет вовне и показывает вызовы в журнале хода.
Журнал: под списком инструментов виден журнал вызовов: когда, какой инструмент, кто инициатор (агент, тест владельца, песочница), статус (выполнено, ошибка, ждёт подтверждения, отклонено лимитом), аргументы и результат. Ключи с названиями вроде token, password, secret, key в аргументах скрываются, длинные значения обрезаются; журнал хранится 90 дней.
Ограничения: в публичном чате на сайте (виджет и публичный API агента) инструменты записи не работают, там собеседник анонимный. Поле, тег и передача оператору действуют только в диалоге бота с подписчиком. Выбор модели не настраивается: модель одна для всех агентов. Через MCP инструменты настраиваются так же: agent_update с полем tools, проверка через agent_tool_test (live:true отправляет по-настоящему), журнал вызовов в agent_tool_calls.