Блок «AI чат-агент»: ответы из вашей базы знаний

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

11 минут чтения·Обновлено: 2026-11-20

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

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

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

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

Блок «AI чат-агент» на холсте: по выходу на каждое намерение, они ведут в блок-сообщение и в блок живого диалога

02Выберите режим

Нажмите на блок — слева откроется редактор. Под названием блока стоит поле Режим агента, и от него зависит, что показывает остальной редактор:

  • Только чат — агент только отвечает. Ни веток, ни маршрутизации.
  • Интенты + чат — отвечает, а при совпадении с одним из ваших намерений уводит разговор в ветку. Обычно ботам поддержки нужен именно он.
  • Только интенты — ответов нет вовсе. Агент только определяет подходящее намерение и отправляет человека по этому пути. Раздел «Знания» пропадает: писать нечего.

03Сначала соберите базу знаний

Документы живут не в блоке, а в рабочем пространстве, поэтому их могут использовать сразу несколько блоков и сценариев.

Откройте в левом меню Настройки → AI (страница называется Настройки AI), пролистайте до раздела Базы знаний и нажмите Новая база знаний. Наполнить её можно тремя способами:

  • Загрузить документ — TXT, Markdown, JSON, CSV, TSV, XML, YAML, PDF, DOC, DOCX, XLS и XLSX. Список допустимых форматов написан прямо над кнопками, гадать не придётся.
  • Создать документ — наберите или вставьте текст прямо в браузере. Удобно для FAQ, который до сих пор существовал только в голове.
  • Импортировать с сайта — вставьте адрес сайта, и FlowCastle сам прочитает страницы — по документу на страницу. Обычно это самый быстрый способ наполнить базу: ответы уже написаны у вас на сайте. Как это работает — в статье Как превратить сайт в базу знаний.

Сразу после загрузки документ ещё не участвует в поиске. Сначала FlowCastle читает его и готовит к поиску. Пока идёт обработка, видно текущий этап. Когда она закончилась — один из четырёх статусов: В очереди, Обработка, Готово, Ошибка, а рядом с именем файла — на сколько частей разбит документ. Четыре счётчика над таблицей (Документы, Готово, В обработке, Ошибки) — это та же картина одним взглядом. Ищутся только документы со статусом Готово.

Поправили документ? Переиндексировать заново подготовит один файл, Переиндексировать всё — всю базу.

Раздел «Базы знаний» на странице настроек AI: выбранная база, форматы файлов, счётчики и список документов

04Подключите базу и выберите модель

Вернитесь в сценарий, откройте блок и перейдите на вкладку Настройки.

Разверните раздел Знания. Поле Базы знаний — множественный выбор, можно указать одну базу или несколько. Именно по ним агент ищет на каждом шаге разговора.

Два поля выше значат не меньше.

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

Модель AI в разделе Модели AI стоит рядом с плашкой Баланс: 82/100 кредитов. Оставьте Auto, если нет причин выбрать другое. Рядом с каждым вариантом написано, сколько он стоит по сравнению с обычной ценой AI: у Auto — 0.50x, то есть половина цены. Ниже — Поиск в вебе: он разрешает подходящим моделям искать в интернете и остаётся неактивным на моделях, которые так не умеют.

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

На холсте у блока есть метка Тратит AI-кредиты, а в сценарии для группы, где триггер слушает каждое сообщение, добавляется Каждое сообщение группы → ИИ: каждое сообщение участников доходит до этого шага и тратит кредиты. Чтобы бот отвечал только когда к нему обращаются, откройте триггер и в поле Охват сообщений в группе выберите Упоминания, ответы и команды — остальные сообщения ничего не стоят. Когда AI-конструктор собирает бота для группы, он спрашивает, какой из двух вариантов вам нужен.

Размышление под выбором модели задаёт, сколько ИИ думает перед ответом. Авто подходит для обычного чата и равно уровню Низкое. Для сложных задач (математика, код, планирование) выберите Среднее или Высокое: ответы станут точнее, но медленнее, и каждый ответ стоит дороже (Среднее — 1,5×, Высокое — 2,5× кредитов модели). Без размышления отвечает быстрее всего за половину кредитов. Настройка работает только у моделей, которые умеют думать (GPT-5 и новее, Claude Sonnet/Opus 5); остальные её не учитывают, и цена у них не меняется. Если включено Брать модель из переменной, уровень тоже можно брать из переменной — так меню моделей в боте может предложить вариант «думать дольше».

Файлы, которые присылает пользователь. Если включено Читать документы, агент читает файлы PDF, Word, Excel, TXT и CSV и хранит их для этого человека без срока и без ограничения по количеству. В каждом ответе он видит список всех файлов с их названиями: самые новые читает целиком, а остальные открывает, когда они нужны для вопроса. Так пользователь может прислать двенадцать отчётов по месяцам и потом попросить сводку за год. Из одного сообщения читается до 10 файлов. Очень длинный файл хранится до первых 200 000 символов; если для ответа нужно остальное, агент так и скажет. Сканы PDF без текстового слоя прочитать нельзя.

Длинные разговоры. Агент читает самые новые сообщения разговора дословно (до 40). Более ранние он не забывает: когда разговор длиннее, агент хранит короткую сводку ранней части (тема, договорённости, цифры, открытые вопросы), а если для ответа нужны точные слова из прошлого, он ищет по переписке и читает нужное место. Сводка пишется в фоне и ничего вам не стоит; ответ, для которого пришлось искать, стоит на один вызов модели больше. Тексты сообщений хранятся 90 дней, поэтому поиск достаёт на 90 дней назад, а суть остаётся в сводке и после.

Если ИИ читает много, ответ стоит дороже. Цена ответа покрывает до 32 000 токенов, которые читает ИИ (токен — это кусочек слова; 32 000 токенов — примерно 100 000 символов: ваш промпт, недавняя переписка и файлы в контексте). Каждые следующие 32 000 токенов, даже неполные, добавляют цену ещё раз. Почти любое сообщение в чате укладывается в первые 32 000. В чате, куда пользователь прислал много больших файлов, ответ может стоить в два-три раза больше, потому что ИИ перечитывает эти файлы для каждого ответа.

Вкладка «Настройки»: системный промпт в режиме переопределения, модель Auto и подключённая база знаний

05Расскажите агенту, с кем он говорит

Агент может знать о каждом собеседнике то, что нужно для ответа, — тариф, дату окончания, число устройств — и не переспрашивать. На вкладке Настройки разверните раздел Что AI знает о контакте и нажмите Добавить факт. Выберите переменную (проекта, бота или контакта) или поле профиля, например First Name или Language, и дайте ей короткое название, например «Тариф». Сначала название совпадает с именем переменной — замените его на то, что означает значение.

В каждом сообщении агент получает эти значения для того, кто пишет, вместе с названиями. Он считает их верными, использует, когда они к месту («в ваш тариф Pro входит 5 устройств»), и не зачитывает список. Пустые значения не передаются, поэтому факт можно добавить заранее, до того как сценарий его заполнит. Можно добавить до 20 фактов; значение длиннее 500 символов обрезается.

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

06Намерения уводят разговор дальше

Перейдите на вкладку Намерения. Каждое намерение — карточка: переключатель, название, описание.

Описание — самое важное. Его никто не видит: по нему модель решает, подходит ли это намерение. Пишите его как фразу о человеке, а не о боте: «Клиент спрашивает, где его заказ, или уточняет статус доставки уже оформленного заказа».

В карточке два флажка. Показывать как кнопку в меню превращает название намерения в подсказку, на которую можно нажать. Продолжать сессию AI-агента после выполнения возвращает человека к агенту после отработки ветки, вместо того чтобы выбросить его из разговора.

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

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

Вкладка «Намерения»: две карточки с названием, описанием и двумя флажками

07Когда ничего не подошло

Откройте раздел Запасной вариант. У поля Когда намерение не распознано три ответа:

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

Раздел «Запасной вариант» в режиме передачи в другой блок и подсказка про выход «Нет совпадения»

Ниже есть раздел Обнаружение фрустрации. Он замечает, что человек начинает злиться, и реагирует, пока тот не ушёл.

  1. Включите переключатель.
  2. Задайте Порог фрустрации (по умолчанию 0.7). Меньше — реакция раньше. Больше — только при явном раздражении. Просьба позвать человека считается сильным недовольством.
  3. Выберите, что делать, в поле При обнаружении фрустрации: Остановить обработку, Отправить запасное сообщение (вы пишете успокаивающий текст) или Передать в другой блок.
  4. Если выбрали передачу, у блока появится выход Недовольство. Соедините его с блоком передачи человеку.

08Проверьте ответ

Нажмите Тест над холстом и откройте вкладку Чат. Задайте тот вопрос, на который отвечают ваши документы, и прочитайте ответ. Если он размытый, чинить почти всегда нужно документ, а не промпт: агент не может быть точнее того, что ему дали.

Панель теста: посетитель спрашивает про сроки доставки, агент отвечает по базе знаний

09Пусть учится на живых диалогах

Когда бот уже поработал с людьми, откройте Пульс → Работа ИИ. Страница открывается на списке Что исправить: каждая проблема с сообщениями, из которых она видна, и одна кнопка, которая исправляет её прямо здесь, без перехода на холст.

  • Добавить ответ — для вопроса, на который агент не ответил. Если кто-то из команды уже ответил на него в живом чате, этот ответ подставится; иначе напишите свой. Базу знаний для ответа выбираете вы.
  • Добавить интент — когда люди постоянно просят то, для чего нет ветки: название, описание и шаг или сценарий, куда он ведёт.
  • Применить описание — когда ИИ выбирает интент неверно; старое и новое описание видны рядом. Отключить — для интента, который никто не выбирает.
  • Настройки, из-за которых люди остаются без ответа: например, агент молчит, когда ничего не подошло, или отвечает без базы знаний (Подключить базу знаний).
  • Отдельные сообщения: без ответа, ответ без базы знаний, ответ не помог, спросили повторно, ошибка инструмента. У каждого свои кнопки, например Добавить ответ, Добавить в интент… и Это не вопрос.

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

10Агент, AI Action или модуль OpenAI

Модель в FlowCastle вызывают три разные вещи, и они не взаимозаменяемы.

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

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

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

11Начните с шаблона

Этот блок используют два готовых сценария, оба ставятся в один клик:

Если бот ещё и продаёт, вторая половина того же разговора — Приём оплаты в Telegram: Stars и платёжные провайдеры.

12Что дальше

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

Похожие гайды

Ещё гайды, чтобы продолжить с этой темы.

Попробуйте в своём боте

Соберите это на бесплатном тарифе, пока шаги свежи в памяти. Карта не нужна.

Создать бота бесплатно