AI-агент LEADTEX: как добавить нейросеть в чат-бот

Q: Можно ли использовать AI-агент для ответов по документу?

Да. Добавьте текстовую базу знаний или файл .txt, .md либо .csv, настройте инструкцию и проверьте, что агент не отвечает за пределами переданных данных. Если текст не умещается в поле базы знаний, используйте файл.

AI Обзор интеграций Туториалы

AI-агент LEADTEX: как добавить нейросеть в чат-бот

Что умеет AI-агент LEADTEX, как настроить ответы по базе знаний и персональный текст внутри сценария без API-ключей и программирования, а также как проверить блок до запуска.

AI-агент LEADTEX — это готовый блок внутри уже собранного сценария чат-бота. Он добавляет нейросеть в конкретную точку диалога: например, отвечает на свободный вопрос клиента по базе знаний, ведёт ограниченный диалог или готовит персональный текст по данным контакта.

Главное отличие от внешней API-интеграции — для блока не нужны API-ключи, endpoint и программирование. Вы добавляете AI-агента в сценарий, задаёте ему инструкцию, контекст и правила завершения диалога. Качество результата зависит от того, насколько ясно описаны задача, допустимые данные и границы ответа.

Что такое AI-агент в чат-боте и где он работает

AI-агент работает внутри готового сценария, когда бот уже знает, на каком шаге находится клиент и какой результат нужен дальше. Это позволяет использовать ИИ как управляемую функцию бизнес-процесса.

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

Блок AI-агент в сценарии чат-бота LEADTEX — AI-агент добавляется в конкретную точку уже собранного сценария.

Что умеет блок AI-агента

AI-агент полезен там, где заранее прописанных кнопок и ответов недостаточно, но бизнесу всё ещё нужен контролируемый сценарий. Блок может отвечать на свободные вопросы по Вашей базе знаний, вести ограниченный диалог с клиентом и готовить текст по переменным контакта.

Задача в боте	Как использовать AI-агент	Что важно задать заранее
FAQ по продукту или услуге	Клиент пишет вопрос своими словами; агент отвечает, опираясь на базу знаний	Точную базу знаний и запрет на выдумывание фактов
Первая линия поддержки	Агент уточняет вопрос и даёт ответ в пределах разрешённой информации	Стоп-слова для передачи человеку и текст ошибки
Персональный текст	После выбора услуги агент готовит памятку, описание или персональное приветствие	Переменные контакта, тон и допустимую длину ответа
Ответ для следующего блока	Агент формирует текст по данным контакта, а сценарий сохраняет его в переменную	Переменную для результата и одношаговый режим работы
Сбор заявки	Агент помогает сформулировать запрос, но не заменяет подтверждение менеджером	Поля заявки, правило передачи и границы обещаний

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

Чем AI-агент отличается от AI-генератора и HTTP-блока

В LEADTEX это три разные роли. AI-генератор сценариев собирает черновик бота по описанию задачи и может сразу добавить в него блок AI-агента, если Вы описали нужную AI-функцию в промте. Затем владелец бота должен проверить сценарий и настроить самого AI-агента: инструкцию, базу знаний, входные данные, ошибки и выход из диалога. AI-агент выполняет ИИ-действие внутри созданного сценария. HTTP-блок нужен для отдельной технической интеграции с внешним сервисом, когда важны конкретный провайдер, endpoint или собственная логика.

Для типовой функции «ответить по базе знаний», «провести ограниченный диалог» или «подготовить текст по данным клиента» начинайте с AI-агента. Он не требует ключей досутпа, понимания API и кода. HTTP-блок имеет смысл только тогда, когда готового функционала недостаточно по конкретной технической причине.

Как настроить AI-агента LEADTEX

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

Шаг 1. Сформулируйте одну задачу для AI-агента

Сначала определите одну функцию блока. Например: «AI-агент отвечает на вопросы о доставке по утверждённой базе знаний и передаёт нестандартный вопрос оператору». Для такой настройки понадобятся актуальные тексты, правила команды и список обещаний, которые бот не вправе давать. Если в одной фразе смешались поддержка, продажи, запись, жалобы и юридические ответы, разделите их на самостоятельные ветки. Тогда будет ясно, в какой момент агент включается, что ему разрешено отвечать и куда вести человека дальше.

Шаг 2. Добавьте блок и сразу подготовьте две связи

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

Добавление блока AI-агент в визуальном конструкторе LEADTEX — Найдите AI-агент через поиск по блокам или в разделах «Специальные» и «Интеграции».

Шаг 3. Заполните инструкцию, первое сообщение и базу знаний

Откройте раздел «Исходные данные» и задайте агенту роль, стиль, ограничения, первое сообщение и базу знаний. В поле можно вставить до 8 192 символов текста; более объёмную базу загрузите файлом .txt, .md или .csv до 100 МБ. Используйте только утверждённые материалы и те переменные, которые бот собрал раньше. Затем спросите то, чего в базе нет. Правильно настроенный агент честно сообщит об ограничении, а не придумает цену или условие.

Пример инструкции для FAQ-бота:

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

Если контекст был собран раньше, передайте его через «Первое сообщение». Например: Товар {{$product_name}}. Вопрос клиента: {{$user__message}}. Так AI-агент получает не абстрактный запрос, а данные конкретной ветки сценария.

Шаг 4. Ограничьте длину и режим диалога

Для первого запуска ограничьте диалог так, чтобы бот вёл себя предсказуемо и не расходовал токены без необходимости. Выберите вариативность ответа, максимальную длину, число запросов и стоп-слова клиента. Если нужен один ответ на FAQ, укажите максимальное количество запросов 1. Для диалога добавьте слова, по которым человек может сразу перейти к оператору: например, «оператор, человек, позови».

Настройка	Как выбрать для первого запуска
Вариативность	Для справочных ответов начните с точной или сбалансированной; креативность оставляйте для задач, где важны разные формулировки
Максимальная длина	Давайте ровно тот объём, который нужен клиенту: короткая справка обычно полезнее длинного полотна
Количество запросов	`1` для одношагового FAQ; больше `1` — только для осмысленного диалога с понятным условием выхода
Стоп-слова	Добавьте слова, после которых клиента нужно передать оператору или завершить диалог
Условие выхода	Опишите, когда агент должен закончить разговор: например, после просьбы о менеджере или подтверждения, что вопрос решён

Шаг 5. Настройте ожидание, ошибку и передачу человеку

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

Шаг 6. Решите, отправлять ответ в чат или сохранять в переменную

По умолчанию ответ AI-агента отправляется в чат. Если сначала его должен использовать следующий блок, включите сохранение в переменную и укажите её имя. Этот режим лучше применять для одношаговой задачи: в многошаговом диалоге в переменной останется только последний ответ AI. Проверьте на тесте, куда именно попадает результат: клиент должен либо увидеть ответ сразу, либо получить его после обработки следующим шагом.

Шаг 7. Пройдите тест-протокол до запуска

Тест-кейс	Что отправляет клиент	Что должен сделать AI-агент	Что считать ошибкой
Вопрос есть в базе	«Какой срок доставки?»	Ответить только по утверждённой базе	Добавить несуществующий срок или условие
Вопроса нет в базе	«Есть ли у вас филиал в другом городе?»	Честно сообщить, что данных нет, и предложить помощь человека	Уверенно придумать ответ
Просьба об операторе	«Позовите человека»	Сработать по стоп-слову или условию выхода и передать дальше	Продолжать AI-диалог вопреки просьбе
Нулевой баланс или ошибка	Вызвать ошибку на тестовой ветке	Показать понятный текст и перейти по связи «Ошибка»	Показать технический текст или оборвать путь
Сохранение в переменную	Запустить одношаговый режим с включённым сохранением	Записать результат в выбранную переменную	Одновременно отправить непроверенный текст в чат, если он должен идти на следующий блок

Как расходуются токены AI-агента

Работа AI-агента оплачивается токенами с баланса владельца бота. На старте доступно 3 000 токенов для тестирования AI-инструментов. На расход влияет объём инструкции, размер базы знаний, учёт истории диалога, длина ответа и количество запросов. Поэтому для первого запуска полезнее короткая инструкция, одна понятная задача и ограниченный диалог, чем большая база и бесконечное число сообщений.

Когда AI-агент — правильный выбор

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

Если критично выбрать конкретную модель, использовать внешний endpoint или написать собственную серверную логику, это уже отдельный HTTP/API-маршрут. Не ставьте оба способа на одну и ту же AI-задачу: сначала определите результат, который должен получить клиент, и выберите один управляемый путь.

Добавить AI-агент в чат-бот LEADTEX

Частые вопросы

Нужны ли API-ключи, чтобы запустить AI-агент LEADTEX?

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

Можно ли выбрать модель для AI-агента?

Пока нет. Если выбор конкретной модели является обязательным требованием, нужен отдельный маршрут через внешний API. Не называйте его настройкой AI-агента LEADTEX: это другая техническая интеграция.

Можно ли использовать AI-агент для ответов по документу?

Да. Добавьте текстовую базу знаний или файл .txt, .md либо .csv, настройте инструкцию и проверьте, что агент не отвечает за пределами переданных данных. Если текст не умещается в поле базы знаний, используйте файл.

Что будет, если закончатся токены?

AI-агент не выполнит запрос, а клиент увидит настроенное сообщение при ошибке. Поэтому до запуска обязательно соедините связь «Ошибка» с понятной запасной веткой или передачей оператору.

Данные актуальны на Q3 2026