AI-агент

AI-агент (ИИ, нейросеть, ChatGPT) в чат-боте LEADTEX: ответы на вопросы клиентов по базе знаний, автоматизированный сбор контактов, техническая поддержка без участия человека. Работает в одношаговом режиме и в режиме диалога

Что делает блок «AI-агент»

Блок AI-агент подключает к сценарию нейросеть, которая отвечает клиенту на свободные вопросы. Вы задаёте роль и стиль ответа, добавляете базу знаний (текст и/или файл), а бот сам формирует ответы на сообщения клиента.

Типовые задачи блока:

• ответы на частые вопросы (FAQ) по вашей базе знаний;
• консультации и поддержка клиентов;
• генерация текста по данным контакта.

Как добавить блок в сценарий

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

У блока две связи для перехода:

• Продолжить — сработает после ответа ИИ (или при завершении диалога);
• Ошибка — сработает, если ответ получить не удалось (например, закончились токены или сервис временно недоступен).

Настройки блока

Настройки сгруппированы в четыре раздела:

• Исходные данные
• Настройки агента
• Чат
• Ответ

Исходные данные

Инструкция — опишите роль ИИ, стиль ответа и ограничения. Это главное поле, которое задаёт поведение агента.

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

Первое сообщение — сообщение, с которого начинается диалог с ИИ.

В это поле можно подставить переменные контакта с предыдущих шагов. Чтобы передать в ИИ вопрос клиента с прошлого шага, сначала сохраните его в переменную, затем укажите эту переменную здесь.

Товар {{$product_name}}. Вопрос клиента: {{$user__message}}

Если поле пустое, агент отправит клиенту Текст для старта диалога (см. в разделе Чат) и будет ждать сообщение пользователя.

База знаний — добавьте текст (до 8 192 символов) или загрузите файл формата .txt, .md или .csv (до 100 МБ) по кнопке «+ Добавить файл». Можно использовать оба источника одновременно.

В инструкции достаточно сослаться на базу знаний словами (например, «отвечай, опираясь на базу знаний» или "расскажи про товар из базы знаний с id {{$product_id}}").

Количество сообщений диалога — сколько последних пар сообщений (входящее от контакта и исходящее от ИИ) добавлять к запросу, чтобы агент «помнил» контекст беседы. Значение 0 — история не учитывается.

Настройки агента

Вариативность (креативность) — стиль ответов:

• Точная — более предсказуемые и строгие ответы;
• Сбалансированная — баланс точности и разнообразия (по умолчанию);
• Креативная — более разнообразные формулировки.

Максимальная длина ответа в токенах — ограничивает максимальный объём одного ответа ИИ (от 64 до 4096).

Максимальное количество запросов — сколько раз ИИ может ответить на этом шаге. Допустимые значения:

• 1 — одношаговый режим: один ответ и выход из блока (удобно для FAQ);
• число больше 1 — диалог до указанного числа запросов;
• пустое поле — диалог без ограничения по количеству запросов; выход только по стоп-слову клиента или по условию выхода.

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

Стоп-слова клиента — если сообщение содержит одно из этих слов как отдельное слово, блок завершит диалог без ответа ИИ и перейдёт по связи «Продолжить». Регистр не важен, разделитель — запятая (например: оператор, человек, позови). Продумайте, какие слова могут использовать ваши клиенты для прекращения диалога с AI-агентом.

Условие выхода из диалога — опишите своими словами, в каких случаях AI-агент должен закончить диалог (например, «если пользователь попросит менеджера» или «если клиент подтвердил, что вопрос решён»). Оставьте поле пустым, чтобы агент не завершал диалог по своей инициативе.

Чат

Выводить ошибки в чат — отладочный переключатель. Если включён, клиенту дополнительно отправляется техническое описание ошибки. Используйте только во время настройки бота, в рабочем боте держите выключенным.

Выводить сообщение ожидания — если включено, перед ответом ИИ клиенту отправляется сообщение ожидания (по умолчанию «Готовлю ответ»). Текст можно изменить.

Текст для старта диалога — выводится, если у агента нет входящего сообщения из поля "Первое сообщение". По умолчанию «Напишите сообщение».

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

Ответ

Сохранить ответ AI-агента в переменную — по умолчанию ответ отправляется клиенту в чат. Если переключатель включён, ответ записывается в Переменную и в чат не отправляется — это удобно для дальнейшей обработки ответа в сценарии.

Как работает блок

1. Клиент попадает на блок «AI-агент».
2. Блок собирает запрос из раздела Исходные данные в таком порядке:
   • Инструкция;
   • База знаний — сначала текст, затем файл, если заполнены оба;
   • история диалога — последние пары сообщений, если задано Количество сообщений диалога;
   • Первое сообщение (на первом ходе; дальше в запрос идут новые сообщения клиента из чата).
3. Блок проверяет стоп-слова клиента и баланс токенов, затем отправляет запрос к нейросети и возвращает ответ.
4. Ответ отправляется в чат или записывается в переменную — в зависимости от настроек раздела Ответ.
5. Дальнейшее поведение зависит от поля Максимальное количество запросов:
   • 1 — агент отвечает один раз и переходит по связи «Продолжить»;
   • больше 1 или пусто — агент остаётся на шаге и ведёт диалог, пока не сработает стоп-слово, условие выхода или лимит запросов.

Оплата работы AI-агента

Работа AI-агента оплачивается токенами с баланса владельца бота. Если баланс токенов исчерпан, запрос к нейросети не выполняется, а клиенту показывается Сообщение при ошибке.

Пополнить баланс и посмотреть расход можно на вкладке Оплата токенов.

Примеры использования

1. Ответы на частые вопросы (FAQ). Инструкция + база знаний магазина, Максимальное количество запросов = 1. Клиент задаёт вопрос — агент отвечает по базе знаний и передаёт клиента дальше по сценарию.

2. Многошаговая техническая поддержка. Диалог с лимитом запросов больше 1 (или без ограничения), база знаний и учёт истории сообщений. Клиент уточняет вопрос в чате, агент отвечает по базе знаний. Когда клиент просит оператора или подтверждает, что вопрос решён, блок завершает диалог по стоп-слову или условию выхода и переходит по связи «Продолжить».

3. Генерация текста по данным контакта. В поле Первое сообщение подставляются переменные контакта — агент формирует персонализированный текст (например, приветствие или описание товара).

В личном кабинете LEADTEX уже доступны 250+ уроков по разработке чат-ботов и мини-приложений, а также возможность присоединиться к крупнейшему сообществу разработчиков с 6000+ участниками - Перейти в личный кабинет.