Документация /Редактор агента

Редактор агента

Как собрать ИИ-агента: схема задач, переходы между целями и фазы обработки сообщения.

Обзор

Ручной редактор агента в Leadarr — это схема задач. Каждая задача в схеме — отдельная цель в диалоге (например, «Квалификация BANT» или «Назначить встречу»). Стрелки между задачами — это переходы: правила, по которым агент переключается с одной цели на другую. Агент всегда находится в какой-то одной задаче и переключается, когда сработало условие перехода.

Общие настройки агента — продукт, канал связи, триггеры — живут в сайдбаре слева. Основной фокус редактора — схема задач в центре экрана.

Как создать агента

Полная сборка агента сводится к четырём действиям. Подробно про каждый блок — ниже на этой странице.

  1. Открыть редактор и дать агенту имя. На главной нажмите «+ Создать нового AI Агента» и впишите название в шапке (например, «Менеджер по продажам»).
  2. Заполнить сайдбар слева. Выберите продукт, подключите канал связи (Email, Telegram, Avito, MAX или открытые линии Битрикс24), при необходимости — CRM. В разделе «Конфигурация» задайте ключевые фразы-триггеры, по которым агент берётся за диалог.
  3. Собрать схему задач. Нажмите «Добавить задачу» и выберите готовый шаблон цели (или создайте свою). Кликните на + под карточкой задачи, чтобы добавить переход — выберите условие («Квалифицирован», «Возражение снято»…) и задачу-цель. Так появляется второй узел и связь между ними. Повторяйте, пока не получится логика всего диалога. Чтобы агент в конце отключался от чата, добавьте узел «Завершение».
  4. Настроить каждую задачу. Кликните на карточку задачи — справа откроется панель. Внутри: инструкция для агента, набор шагов обработки сообщения и follow-up'ы (напоминания, если клиент молчит). Сохраните задачу.
  5. Сохранить или запустить. «Сохранить черновик» — агент сохранится в статусе «Неактивный». «Запустить» — сохранит и активирует, агент начнёт отвечать на входящие.
Не уверены, с чего начать? Соберите простую схему из двух задач: «Выявить потребность» → переход «Квалифицирован» → «Назначить встречу». Затем добавьте «Завершение» после встречи. Этого достаточно, чтобы агент уже работал — остальные ветки добавите по мере появления реальных диалогов.

Открыть редактор

На главной странице нажмите «+ Создать нового AI Агента». Откроется полноэкранный редактор с шапкой, сайдбаром слева и пустой схемой в центре.

Чтобы отредактировать существующего агента — нажмите ✏️ на его карточке на главной. Откроется тот же редактор, уже с заполненными настройками.

Схема задач

Центр экрана — холст со схемой. Пока задач нет, показывается заглушка «Нет задач. Добавьте первую задачу» и кнопка «Добавить задачу».

Редактор агента, пустая схема
Редактор нового агента. Слева — сайдбар с настройками, в центре — пустой холст с кнопкой «Добавить задачу». В шапке — «Режим учителя», «Сохранить черновик» и «Запустить».

Что такое задача

Задача — это цель, которую агент пытается достичь в диалоге. Примеры: «Выявить потребность», «Квалификация BANT», «Назначить встречу», «Отработать возражение по цене». У каждой задачи есть собственная инструкция и набор фаз выполнения.

На карточке задачи показано:

  • Название и краткое описание;
  • Пять цветных бейджей — счётчики включённых шагов по фазам обработки (защита, поиск контекста, анализ, генерация, действия);
  • Кнопка + снизу — добавить переход в другую задачу;
  • Справа от карточки — зелёный ярлык «Иначе — остаться в цели». Это автоматический самопереход: если ни одно из условий не сработало, агент остаётся в текущей задаче. Ярлык можно кликнуть и поменять описание этого условия.

Что такое переход

Переход — это условие, при котором агент переключается с одной задачи на другую. Условие описывается своим текстом («Клиент назвал бюджет и сроки»), и ИИ на каждом шаге решает, выполнено оно или нет.

Схема с двумя задачами и переходом между ними
Схема из двух задач: Квалификация BANT → Не квалифицирован → Проверить ЦА. Зелёный ярлык «Иначе — остаться в цели» — автоматический «иначе»-переход, который есть у каждой задачи.
Агент проверяет условия по очереди. Если ни одно не подошло — остаётся в текущей цели. Это и есть «иначе»-переход, который добавляется к каждой задаче автоматически.

Добавление задачи

Первая задача

На пустом холсте нажмите «Добавить задачу». Откроется каталог целей с вкладками:

Окно «Выберите задачу» с вкладками и шаблонами
Каталог целей: вкладки «Мои цели», «Квалификация», «Встреча», «Возражения», «Прогрев», «Свой» и «Завершение». Готовые шаблоны: «Выявить потребность», «Квалификация BANT», «Назначить встречу», «Возражение по цене» и др.
Форма «Создать задачу» с заполненной инструкцией
Форма «Создать задачу». Название и инструкция предзаполнены выбранным шаблоном — можно отредактировать под свой сценарий.
  • Мои цели — задачи, которые вы уже создали раньше (общий справочник задач).
  • Квалификация — «Выявить потребность», «Квалификация BANT», «Проверить ЦА».
  • Встреча — «Назначить встречу», «Подготовить демо», «Follow-up после встречи».
  • Возражения — «Возражение по цене», «Возражение „не актуально“», «Возражение „не доверяю“».
  • Прогрев — «Напомнить о себе», «Поделиться ценностью».
  • Свой — создать задачу с нуля: задайте название и описание сами.
  • Завершение — добавить узел, который отключает агента в чате (доступен начиная со второй задачи).

Шаблон из каталога приходит с готовой инструкцией, которую можно отредактировать в редакторе задачи.

Следующие задачи

Нажмите + на карточке существующей задачи. Откроется двухшаговый диалог:

  1. Условие перехода — выберите, в какой момент агент должен уйти из текущей задачи (подробно ниже).
  2. Цель перехода — выберите задачу, куда вести: существующую, из шаблона или «Завершение».

Условия переходов

При добавлении перехода вы выбираете условие — в какой момент агент должен уйти из текущей задачи. Шесть категорий готовых формулировок:

КатегорияГотовые условия
КвалификацияКвалифицирован · Не квалифицирован · Нужно уточнить
ВозраженияВозражение снято · Возражение не снято · Новое возражение
ИнтересВысокий интерес · Нет интереса · Начал негативить
ВстречаЗаписался на встречу · Отказ от встречи · Перенос встречи
ДругоеМолчание · Связаться позже · Не тот контакт
СвойСвоё условие — задайте название и описание сами
Диалог выбора условия с шаблоном «Не квалифицирован»
Диалог «Условие перехода». Сверху — пояснение про «иначе»-переход, ниже — категории и карточки шаблонов. Поля «Название условия» и «Описание условия» подставляются из выбранного шаблона.

Каждый шаблон — это пара название + описание. Описание — это инструкция для ИИ, которая объясняет, когда условие считается выполненным. Пример описания для шаблона «Квалифицирован»:

Клиент соответствует целевым критериям: подтвердил
потребность, бюджет и сроки. Готов к следующему шагу воронки.

Название и описание можно отредактировать после выбора шаблона. Клик по ярлыку перехода прямо на схеме открывает то же самое окно — для правки.

Редактор задачи

Клик по карточке задачи открывает правую панель с её настройками. Все правки применяются по кнопке «Сохранить» внизу панели.

Инструкция

Поле «Промпт инструкции» — главное содержимое задачи. Это текст, который объясняет агенту, что именно нужно сделать в рамках этой цели. Клик по полю открывает большое окно для написания текста (подсказка «Опишите, что должен делать агент в рамках этой задачи…»). Метка рядом показывает «Настроено» или «Не настроено».

Фазы выполнения

Сворачиваемая секция, в которой настраивается, какие шаги агент проходит при каждом входящем сообщении. Подробно — ниже.

Follow-ups

Сворачиваемая секция с напоминаниями, привязанными к этой задаче. Подробно — ниже.

Лимит ответов

Переключатель и счётчик. Когда включён, агент не отправит больше указанного числа ответов одному клиенту в рамках этой задачи. Подпись: «Макс. N ответов AI на чат» или «Без ограничений». Защищает от зацикливания.

Удалить / Сохранить

Внизу панели — красная кнопка «Удалить задачу» и «Сохранить». По «Сохранить» правки уходят на сервер сразу: меняются инструкция, фазы, follow-ups и лимит. После успешного сохранения на 2 секунды появляется надпись «Сохранено».

Правая панель редактора задачи с раскрытой секцией «Фазы выполнения»
Правая панель редактора задачи. Сверху — «Инструкция» с состоянием «Настроено». Ниже — «Фазы выполнения» с шагами «Генерация ответа» и «Отправка клиенту» (с замочком — всегда включены) и кнопкой «+ Добавить шаг».

Фазы выполнения

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

ФазаЗачем
ЗащитаПроверки безопасности — например, отсев писем-автоответчиков и попыток обмануть агента
Поиск контекстаПоиск нужных фактов перед ответом — по базе знаний и по похожим прошлым диалогам
АнализОценка сообщения — насколько клиент заинтересован, нужно ли напоминание
ГенерацияСам ответ — основной шаг, на котором ИИ пишет текст (всегда включён)
ДействияЧто происходит после генерации: отправка клиенту, обновление CRM (отправка всегда включена)

Доступные шаги

ШагФазаЧто делает
Защита от взломаЗащитаБлокирует попытки обмануть агента подсунутой инструкцией в письме
Фильтр автоответовЗащитаПропускает письма-автоответчики, чтобы агент не вступал с ними в переписку
Поиск по документамПоиск контекстаПодмешивает в ответ факты из базы знаний
Подражание стилюПоиск контекстаНаходит похожие примеры из вашей переписки, чтобы держать тон — см. обучение стилю
Оценка интереса клиентаАнализОпределяет заинтересованность по шкале от 1 до 5
Решение о напоминанииАнализПроверяет, нужен ли follow-up прямо сейчас
Генерация ответаГенерацияГлавный шаг — ИИ пишет текст ответа (всегда включён, нельзя удалить)
Отправка клиентуДействияДоставка сообщения через канал связи (всегда включена, нельзя удалить)
Действия в Битрикс24ДействияСоздание контакта, обновление полей сделки, перевод по стадиям, запись резюме диалога — для подключённой CRM Битрикс24

Кнопка «Добавить шаг» открывает меню всех доступных шагов, сгруппированных по фазам. Если все шаги уже добавлены, надпись становится «Все шаги уже добавлены» и кнопка неактивна.

Шаги «Поиск по документам» и «Подражание стилю» требуют выбора ресурса (база знаний или набор примеров). Пока ресурс не выбран — карточка шага подсвечивается красным с маркером «Требуется настройка». Шаги «Действия в Битрикс24» открывают свой блок настроек со списком полей CRM, которыми агент может управлять.

У новой задачи по умолчанию включены только два обязательных шага — «Генерация ответа» и «Отправка клиенту». Остальное добавляйте по необходимости — лишние шаги замедляют ответ и увеличивают расход кредитов.

Follow-ups

Секция «Follow-ups» в редакторе задачи задаёт напоминания, привязанные к этой цели. Когда чат находится в данной задаче и клиент молчит — через заданное время агент сам отправит follow-up.

Как настроить

  1. Нажмите «Добавить follow-up».
  2. Укажите задержку — дн / час / мин от момента последнего сообщения клиента.
  3. Введите текст в поле «Текст сообщения follow-up…». Можно оставить пустым — агент сам сгенерирует напоминание по тону диалога.
  4. Порядок follow-up меняется стрелками ↑ ↓, удаление — крестиком.

Smart filter

Чекбокс «Smart filter (ML проверяет, нужен ли)» — дополнительная защита от лишних напоминаний. Если включить, ИИ ещё раз посмотрит на последнее сообщение клиента и решит, уместен ли follow-up прямо сейчас (например, если клиент уже дал окончательный отказ — напоминание пропускается). При желании в появившемся поле можно задать свой текст-инструкцию для этой проверки; если оставить пустым — используется стандартный.

Follow-up применяется только к новым чатам — то есть к диалогам, в которых агент написал что-то после того, как вы добавили follow-up. Старые молчащие чаты не получат напоминаний задним числом.
Секция Follow-ups в редакторе задачи с полями задержки и Smart filter
Секция «Follow-ups» — задержка дн / час / мин, поле для текста и чекбокс «Smart filter (ML проверяет, нужен ли)».

Завершение

Чтобы агент явно отключался от чата на каком-то шаге, добавьте переход в узел «Завершение». Это специальный тип узла — красный, может быть только целью перехода. Дальнейших переходов после него нет — агент перестаёт отвечать в этом чате.

Финальное сообщение

Клик по узлу «Завершение» открывает правую панель с переключателем «Отправить сообщение перед отключением». Если включить — задайте прощальный текст (подсказка: «Например: Спасибо за ваше время! Если понадобимся — напишите»). Если выключить — агент молча перестанет отвечать.

Сохранение и запуск

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

  • Сохранить черновик — создаёт или обновляет агента со статусом «Неактивный». Можно вернуться к редактированию позже.
  • Запустить — сохраняет и активирует агента. После успешного запуска вас перекинет на главную, карточка агента получит статус «Активный 🟢» и начнёт обрабатывать входящие.

Что нужно для запуска

  • Название агента (без него не сохранится даже черновик);
  • Продукт в сайдбаре;
  • Канал связи в сайдбаре;
  • Минимум одна задача в схеме;
  • Подтверждённый email пользователя;
  • Достаточный баланс кредитов на счету организации.

Если чего-то не хватает — кнопка «Запустить» вернёт сообщение со списком пропущенных полей. Никаких изменений на сервере при этом не произойдёт.

Для первых дней работы агента включите Режим учителя — вы сможете проверить каждый ответ перед отправкой и поправить инструкции на основе реальных диалогов.
← Предыдущее Агент за 6 шагов (ИИ)