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

02Выберите режим
Нажмите на блок — слева откроется редактор. Под названием блока стоит поле Режим агента, и от него зависит, что показывает остальной редактор:
- Только чат — агент только отвечает. Ни веток, ни маршрутизации.
- Интенты + чат — отвечает, а при совпадении с одним из ваших намерений уводит разговор в ветку. Обычно ботам поддержки нужен именно он.
- Только интенты — ответов нет вовсе. Агент только определяет подходящее намерение и отправляет человека по этому пути. Раздел «Знания» пропадает: писать нечего.
03Сначала соберите базу знаний
Документы живут не в блоке, а в рабочем пространстве, поэтому их могут использовать сразу несколько блоков и сценариев.
Откройте в левом меню Настройки → AI (страница называется Настройки AI), пролистайте до раздела Базы знаний и нажмите Новая база знаний. Наполнить её можно тремя способами:
- Загрузить документ — TXT, Markdown, JSON, CSV, TSV, XML, YAML, PDF, DOC, DOCX, XLS и XLSX. Список допустимых форматов написан прямо над кнопками, гадать не придётся.
- Создать документ — наберите или вставьте текст прямо в браузере. Удобно для FAQ, который до сих пор существовал только в голове.
- Импортировать с сайта — вставьте адрес сайта, и FlowCastle сам прочитает страницы — по документу на страницу. Обычно это самый быстрый способ наполнить базу: ответы уже написаны у вас на сайте. Как это работает — в статье Как превратить сайт в базу знаний.
Сразу после загрузки документ ещё не участвует в поиске. Сначала FlowCastle читает его и готовит к поиску. Пока идёт обработка, видно текущий этап. Когда она закончилась — один из четырёх статусов: В очереди, Обработка, Готово, Ошибка, а рядом с именем файла — на сколько частей разбит документ. Четыре счётчика над таблицей (Документы, Готово, В обработке, Ошибки) — это та же картина одним взглядом. Ищутся только документы со статусом Готово.
Поправили документ? Переиндексировать заново подготовит один файл, Переиндексировать всё — всю базу.

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. В чате, куда пользователь прислал много больших файлов, ответ может стоить в два-три раза больше, потому что ИИ перечитывает эти файлы для каждого ответа.

05Расскажите агенту, с кем он говорит
Агент может знать о каждом собеседнике то, что нужно для ответа, — тариф, дату окончания, число устройств — и не переспрашивать. На вкладке Настройки разверните раздел Что AI знает о контакте и нажмите Добавить факт. Выберите переменную (проекта, бота или контакта) или поле профиля, например First Name или Language, и дайте ей короткое название, например «Тариф». Сначала название совпадает с именем переменной — замените его на то, что означает значение.
В каждом сообщении агент получает эти значения для того, кто пишет, вместе с названиями. Он считает их верными, использует, когда они к месту («в ваш тариф Pro входит 5 устройств»), и не зачитывает список. Пустые значения не передаются, поэтому факт можно добавить заранее, до того как сценарий его заполнит. Можно добавить до 20 фактов; значение длиннее 500 символов обрезается.
Секретные переменные выбрать нельзя, а блок, в котором такая переменная есть — в факте, в промпте или в описании намерения, — не сохранится: всё, что читает агент, уходит провайдеру AI-модели. Значения, которые есть только во время работы сценария (результат действия, текущее сообщение, id чата), здесь тоже пустые. Сохраните такое значение в переменную контакта и добавьте её как факт.
06Намерения уводят разговор дальше
Перейдите на вкладку Намерения. Каждое намерение — карточка: переключатель, название, описание.
Описание — самое важное. Его никто не видит: по нему модель решает, подходит ли это намерение. Пишите его как фразу о человеке, а не о боте: «Клиент спрашивает, где его заказ, или уточняет статус доставки уже оформленного заказа».
В карточке два флажка. Показывать как кнопку в меню превращает название намерения в подсказку, на которую можно нажать. Продолжать сессию AI-агента после выполнения возвращает человека к агенту после отработки ветки, вместо того чтобы выбросить его из разговора.
Кнопка Добавить намерение создаёт пустую карточку. Кнопка под ней открывает панель с готовыми примерами по типам бизнеса — можно начать с «Проверить статус заказа» или «Позвать оператора», а не с пустого поля.
Пока вы не соедините выходы, ничего никуда не пойдёт. У каждого включённого намерения на блоке появляется свой выход с его названием — тяните его в любой блок. Намерение «позвать человека» обычно ведёт в блок «Действие» с действием Начать диалог: оно открывает диалог в разделе Живой чат, где ответит кто-то из вашей команды. Пока никто не написал, ИИ-ассистент продолжает отвечать, и человек может задавать вопросы, пока ждёт.

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

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

09Пусть учится на живых диалогах
Когда бот уже поработал с людьми, откройте Пульс → Работа ИИ. Страница открывается на списке Что исправить: каждая проблема с сообщениями, из которых она видна, и одна кнопка, которая исправляет её прямо здесь, без перехода на холст.
- Добавить ответ — для вопроса, на который агент не ответил. Если кто-то из команды уже ответил на него в живом чате, этот ответ подставится; иначе напишите свой. Базу знаний для ответа выбираете вы.
- Добавить интент — когда люди постоянно просят то, для чего нет ветки: название, описание и шаг или сценарий, куда он ведёт.
- Применить описание — когда ИИ выбирает интент неверно; старое и новое описание видны рядом. Отключить — для интента, который никто не выбирает.
- Настройки, из-за которых люди остаются без ответа: например, агент молчит, когда ничего не подошло, или отвечает без базы знаний (Подключить базу знаний).
- Отдельные сообщения: без ответа, ответ без базы знаний, ответ не помог, спросили повторно, ошибка инструмента. У каждого свои кнопки, например Добавить ответ, Добавить в интент… и Это не вопрос.
Ответ в базе знаний, которую агент уже читает, начинает работать, как только документ прочитается. Новые и изменённые интенты и новая подключённая база знаний сохраняются в редакторе и заработают после публикации — страница так и пишет и показывает кнопку Опубликовать. Рядом с вкладками редактора агента небольшой счётчик показывает, сколько исправлений ждёт, и открывает этот список.
10Агент, AI Action или модуль OpenAI
Модель в FlowCastle вызывают три разные вещи, и они не взаимозаменяемы.
Блок AI чат-агент — это разговор: он ждёт ответы, помнит предыдущий шаг, ищет по вашим документам и умеет уводить разговор в ветки. Берите его, когда человек задаст больше одного вопроса.
AI Action (название действия в интерфейсе пока на английском) — одно обращение внутри блока «Действие»: один запрос к модели, один результат в переменную, без памяти и без веток. Подходит, чтобы сжать сообщение или разложить ответ по категориям посреди сценария. Где его найти, описано в статье Блок «Действие»: всё, что умеет ваш бот.
Модуль OpenAI добавляет действие Спросить ChatGPT, которое работает на вашем ключе OpenAI. Тоже одно обращение, без базы знаний и намерений: смысл ставить его — именно свой ключ.
11Начните с шаблона
Этот блок используют два готовых сценария, оба ставятся в один клик:
- AI FAQ + передача человеку — бот поддержки отвечает про заказы, доставку и возвраты по базе знаний, а сложные диалоги отдаёт человеку.
- Чат-ассистент для сайта (EN/RU) — двуязычный ассистент из чат-виджета flowcastle.ai. К нему подходит статья Чат-виджет на вашем сайте.
Если бот ещё и продаёт, вторая половина того же разговора — Приём оплаты в Telegram: Stars и платёжные провайдеры.
12Что дальше
Возвращаемся на основной путь — к внешним сервисам, которые можно подключить боту: Модули: Таблицы, AI, платежи и другие сервисы.
