AI-агент LEADTEX записывает данные клиента в переменные, ставит теги и выбирает ветку сценария после диалога. Разбираем настройку на сквозном примере и типичные ловушки.
Диалог с AI-агентом полезен бизнесу тогда, когда его итог попадает в сценарий: телефон оказывается в карточке контакта, выбранный тариф доходит до менеджера, а отказ не получает напоминаний об оплате. Для этого у блока AI-агент есть три механики: агент записывает сведения в переменные, ставит и снимает теги и выбирает ветку сценария по итогам разговора. Так ИИ-агент для бизнеса не просто поддерживает беседу, а передаёт её результат в следующие шаги бота.
Все три раздела находятся в настройках блока AI-агент, рядом с исходными данными. Теги и переменные в чат-боте отвечают за разные части результата, а ветка определяет продолжение сценария. Ключевая разница между механизмами — в том, что именно они меняют и когда это происходит.
На практике эти механики не заменяют друг друга. Переменная сохраняет конкретный факт, тег фиксирует статус контакта, а ветка определяет следующий участок сценария. Например, выбранный тариф можно записать в user_tariff, после просьбы о ссылке на оплату добавить тег «Горячий лид», а после завершения разговора отправить контакт в ветку «Заявка».
| Механика | Что делает | Когда срабатывает | Типичная ошибка |
|---|---|---|---|
| Запись в переменные | Сохраняет имя, телефон, город, бюджет, дату | На каждом шаге: агент проверяет новые сообщения клиента | В одной переменной два значения |
| Теги (добавить и удалить) | Меняет метку контакта по условию | По итогам разговора | Условие «клиент интересуется» вместо конкретного действия |
| Ветки | Направляют контакт в нужный участок сценария | После завершения диалога | Считать, что ветка завершает диалог |
О том, как заставить агента готовить релевантные ответы, рассказали в материале про инструкцию и стоп-слова.
В разделе «Запись в переменные» нажмите «Добавить переменную», задайте имя и тип значения: текст, число, телефон, email или дата. В поле «Что записать в переменную» объясните агенту, какие данные нужно достать из диалога. Например, для user_phone подойдёт формулировка: «Номер телефона, который клиент оставил для связи».
Правило, которое чаще всего нарушают: для телефона и города нужны две отдельные переменные. Если описать одну как «контакты клиента», агент запишет туда всё вперемешку, а следующий блок сценария не сможет использовать значение. Сохранённые данные потом подставляются в сообщения, уведомления менеджеру, заявки и список контактов через обычные переменные вида {{$user_phone}}. В описании укажите три вещи: что извлечь, из какой реплики и в каком формате. Например: «Номер телефона, который клиент сообщил для связи; сохранить только цифры и знак +».
Раздел «Запись в переменные»: имя, тип значения и описание того, что агент должен взять из диалога.
В разделах «Теги для добавления» и «Теги для удаления» выберите или создайте тег и опишите условие. Например:
Хорошее условие можно проверить по одной реплике клиента: «выбрал товар и попросил ссылку на оплату». Плохое: «клиент заинтересован». Такое условие сработает на любой вежливый ответ и не даст надёжно определить статус лида.
Разделы «Теги для добавления» и «Теги для удаления»: у каждого тега своё условие, описанное через действие клиента.
Ветка получает название, и оно появляется на схеме у исходящей связи блока. В поле «Условие выбора ветки» опишите, когда агент должен её выбрать, и соедините связь с нужным блоком. Например, можно создать три ветки: «Заявка», «Отказ» и «Позвать менеджера».
Когда диалог завершён, агент анализирует его и выбирает подходящую ветку. Если ни одно условие не выполнено, контакт уходит по системной связи «Продолжить». Связь «Ошибка» используется только при сбое блока; для сценария «ничего не подошло» она не нужна.
Ветки блока AI-агент на схеме сценария: названия веток отображаются у исходящих связей.
Ветка отвечает на вопрос «куда идти после диалога», а не «когда закончить». Момент завершения задают три другие настройки: максимальное количество запросов, стоп-слова клиента и условие выхода из диалога. Поэтому сценарий, в котором клиент оставил телефон и агент «должен сразу передать менеджеру», без настройки выхода продолжит разговаривать.
Если переход нужен сразу после выполнения условия, продублируйте это условие в поле «Условие выхода из диалога». Порядок работы простой: сначала решите, когда разговор заканчивается, а потом — куда направить контакт.
Условия выхода и выбора ветки должны быть согласованы. Если диалог завершается по телефону, а ветка «Заявка» требует ещё и тариф, контакт с телефоном без тарифа уйдёт по связи «Продолжить», и этот исход нужно описать отдельно. Такой случай разобран в примере ниже.
Для выбора ветки агент использует историю, размер которой задан в поле «Количество сообщений диалога». При значении 0 он ориентируется только на последнее сообщение и может не учесть телефон, отказ или просьбу из предыдущих реплик. Если агент последовательно спрашивает имя, телефон и город, история должна охватывать весь этот опрос. Чем больше сообщений в истории, тем больше расход токенов, поэтому выбирайте минимальное число, при котором ветки ещё определяются верно.
Сценарий гипотетический: агент отвечает по базе знаний о трёх тарифах и по пути собирает данные. Так выглядят настройки.
| Раздел | Значение |
|---|---|
Переменная user_name |
Имя клиента, как он представился |
Переменная user_phone (тип «телефон») |
Номер, который клиент оставил для связи |
Переменная user_tariff |
Тариф, который клиент выбрал |
| Тег для добавления «Горячий лид» | Клиент выбрал тариф и попросил ссылку на оплату |
| Тег для удаления «Не определился» | Клиент выбрал конкретный тариф |
| Ветка «Заявка» | Есть тариф и телефон |
| Ветка «Отказ» | Есть явный отказ |
| Ветка «Позвать менеджера» | Есть просьба связать с человеком или вопрос вне базы знаний |
| Выход из диалога | Клиент выбрал тариф и оставил телефон; прямо отказался; попросил человека |
| «Продолжить» | Данные неполные или финал не распознан: отправить уточнение либо уведомить менеджера |
Здесь условие выхода и условие ветки «Заявка» совпадают, а все нестандартные исходы уходят по «Продолжить». Если продукт требует прекращать разговор сразу после получения телефона, добавьте отдельную ветку «Неполная заявка»: клиент оставил телефон, но тариф не выбрал.
После таблицы настроек прогоните тестовые диалоги и сверьте результат с ожидаемым:
| Реплика или финал | Переменные | Тег | Ветка |
|---|---|---|---|
| «Я Анна, беру Бизнес, +7…» | user_name, user_tariff, user_phone |
Горячий лид | Заявка |
| «Подумаю, не звоните» | При наличии — user_name |
— | Отказ |
| «Позовите менеджера» | Ранее собранные данные | Нужен менеджер | Позвать менеджера |
| Телефон есть, тариф не выбран | user_phone |
Неполная заявка | «Продолжить» или «Неполная заявка» |
| Неоднозначное «наверное, позже» | Без изменений | — | «Продолжить» |
Теги «Нужен менеджер» и «Неполная заявка» в этом примере добавьте по аналогии с «Горячий лид»: условие через конкретное действие клиента. Это ожидаемые результаты, а не измеренные: фактический исход зависит от модели, формулировок условий и количества сообщений в истории. Если результат расходится, проверьте по порядку условие выхода, описание ветки и объём истории.
Если вы разбираетесь, как создать ИИ-агента для квалификации заявок, начните не с длинной инструкции, а с пяти решений ниже.
Шаг 1. Запишите цель диалога. Одной фразой сформулируйте, что должно быть у клиента и у вас в конце разговора.
Шаг 2. Настройте выход. Задайте максимальное количество запросов, стоп-слова и условие выхода из диалога.
Шаг 3. Добавьте переменные. Одна переменная должна хранить одно значение, а в описании нужно прямо указать, что именно записывать.
Шаг 4. Добавьте теги и ветки. Формулируйте условия через действия клиента и проверьте, что они не пересекаются.
Шаг 5. Проверьте историю. Укажите количество сообщений, которого хватает на весь опрос, и прогоните тестовые диалоги.
Видеоурок LEADTEX по AI-агенту в чат-боте: как добавить блок в сценарий и настроить его работу.
Переменные, теги и ветки увеличивают число запросов к ИИ, поэтому перед запуском проверьте баланс токенов. Для первичного тестирования сценариев рекомендуется начинать с модели GPT-4.1 Mini: она хорошо следует инструкции, работает с базой знаний, переменными, тегами и ветками.
Если для корректного выбора ветки агенту не хватает контекста, увеличивайте количество сообщений диалога постепенно. Так проще увидеть связь между качеством маршрутизации и расходом токенов, не меняя сразу несколько настроек.
Тестируйте отдельно короткий диалог и разговор, в котором клиент возвращается к прежнему вопросу. В первом случае важна реакция на последнее сообщение, во втором — способность восстановить контекст по истории. Оба варианта помогают понять, действительно ли выбранного лимита достаточно.
Блок «Условие» проверяет заранее заданные данные: тег, переменную, значение. Ветки AI-агента выбирает сама нейросеть по итогам диалога на основе описанных вами условий, поэтому они подходят для свободного разговора.
Контакт уйдёт по системной связи «Продолжить». Свяжите её с блоком, который обрабатывает такой случай, например с уведомлением менеджеру.
Да. Значения переменных подставляются в сообщения, заявки и другие блоки так же, как обычные переменные контакта.
Чаще всего описание переменной слишком общее или содержит два значения. Оставьте в описании одно конкретное значение и приведите пример формулировки.
Создать тестовый сценарий квалификации
Данные актуальны на Q4 2026