Руководство пользователя

BiFL — российская SaaS-платформа для создания ИИ-ассистентов под бизнес-задачи. Вы создаёте проект, внутри проекта — чатботов, привязываете к ним персонажа, промпт, AI-модель и базу знаний, после чего публикуете бота в каналы общения с клиентами: веб-виджет, Telegram, VK, MAX или мобильное приложение.

Основные понятия

Типовой путь

1. Регистрация — автоматически создаются проект и первый пустой чатбот.
2. Настройка бота: модель, системный промпт, персонаж, база знаний.
3. Публикация в каналах: виджет, Telegram, VK, MAX или мобильное приложение.
4. Клиенты общаются с ботом: он отвечает по базе знаний, помогает выбрать товар (Commerce) и записаться на услугу (Booking).

Бизнес-модули поверх диалогового ядра

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

Проект — контейнер для чатботов и настроек. У каждого проекта есть владелец, проекты хранятся в разделе «Мои проекты». При регистрации проект создаётся автоматически вместе с первым чатботом.

Как создать ещё один проект

1. Откройте раздел «Мои проекты» в боковом меню.
2. Нажмите «Создать проект».
3. Укажите название и описание, затем сохраните.

Поля проекта

Настройки проекта

• Embedding-модель по умолчанию — модель векторизации баз знаний проекта. При смене все базы знаний и товарные рекомендации перевекторизуются автоматически.
• Уведомления о бронированиях — токен Telegram-бота и ID чата для получения уведомлений о записях.
• Уведомления о заказах — аналогичные настройки для Telegram и MAX.
• Часовой пояс — задаётся в профиле пользователя.

Что такое чатбот

Чатбот — публикуемый ИИ-ассистент. Каждый привязан к проекту и настраивается отдельно: модель, промпт, персонаж, базы знаний и каналы.

Как создать чатбота

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

Основные поля

Мультимодальность и голос

Переключатель мультимодальности включает вложения (изображения, документы) и голосовой ввод в чате. Голосовой ввод — отдельный переключатель; для расшифровки выбирается модель транскрибации — собственная или платформенная.

Товарные рекомендации

Флаг catalog_recommendations_enabled включает автоматические рекомендации из каталога Commerce: если запрос клиента релевантен каталогу, бот показывает до 3 карточек товара с ценой и кнопкой.

Публикация

Чатбот публично доступен, когда опубликован хотя бы один его канал. Для виджета прямая ссылка — https://bifl.ru/{slug}. Пока канал не опубликован, обращения к нему получают 404: платформа не раскрывает существование неопубликованного бота.

Каждый чатбот работает на одной AI-модели. Модель определяет качество и скорость ответов, размер контекста и доступные возможности: мультимодальность, tool-calling, стриминг.

Два типа моделей

Категории моделей

Поддерживаемые провайдеры

Контекстное окно

У каждой модели есть лимит контекста: системный промпт + история диалога + база знаний + текущее сообщение. Если контекст превышает лимит, старые сообщения истории обрезаются.

Tool-calling

Модели с поддержкой функций умеют вызывать инструменты Commerce (поиск товаров, корзина, заказ) и Booking (услуги, слоты, запись) прямо из диалога. Вызовы работают фоново — клиент видит прогресс и результат.

Подключение своего провайдера

1. В разделе «Модели ИИ» нажмите «Добавить провайдера» и укажите тип, API-ключ и URL.
2. Импортируйте доступные у провайдера модели.
3. Привяжите модель к чатботу или базе знаний.

База знаний — набор документов, которые загружаете вы. Система нарезает текст на фрагменты (чанки), векторизует их и сохраняет в векторную базу Qdrant. На вопрос клиента бот ищет самые релевантные фрагменты и подставляет их в контекст ответа — этот механизм называется RAG (Retrieval-Augmented Generation).

Жизненный цикл базы знаний

Поддерживаемые форматы

PDF, DOC, DOCX, TXT, MD, CSV, XLS, XLSX. Один файл — до 10 МБ; за одну загрузку — до 10 файлов, в массовой операции — до 100.

Как текст становится знаниями

Документ нарезается на фрагменты — по умолчанию фиксированным размером (500 символов с перекрытием 100). Можно выбрать нарезку по предложениям, абзацам или смысловым блокам. Каждый фрагмент превращается в эмбеддинг — числовой вектор, где похожие по смыслу тексты находятся рядом. По умолчанию используются локальные модели FastEmbed; свою модель эмбеддингов можно подключить через BYOK.

Гибридный поиск

Поиск работает двумя методами сразу: векторный находит совпадения по смыслу, классический BM25 — по точным словам. Результаты объединяются. Если векторная база временно недоступна, система автоматически переключается на текстовый поиск — менее точный, но рабочий.

Как использовать

1. Откройте проект → «База знаний» и загрузите документы.
2. Дождитесь статуса «Готова» — обработка идёт в фоне.
3. Прикрепите базу знаний к чатботу в его настройках. Один бот может использовать несколько баз — лимит зависит от тарифа; поиск идёт по всем сразу.
4. В ответах бота, где использованы материалы базы, указываются источники.

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

Что хранит персонаж

Действия

• Клонировать — скопировать публичного персонажа себе и редактировать.
• Сделать публичным — опубликовать своего персонажа в общем каталоге.
• Применить к боту — перенести настройки на существующего чатбота.
• Создать бота из персонажа — сразу создать нового чатбота с этими настройками.

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

Автогенерация

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

Действия

• Создавать, редактировать и удалять промпты.
• Публиковать в общий каталог или скрывать.
• Подставлять промпт при настройке чатбота или персонажа.

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

Что можно делать

• Создавать заметки вручную или сохранять сообщения из чата одной кнопкой.
• Организовывать заметки по папкам.
• Конвертировать выбранные заметки в базу знаний чатбота.

Диалог — тред общения клиента с чатботом. Один и тот же диалог может вестись в любом канале: виджет, Telegram, MAX, VK или мобильное приложение.

Как создаётся диалог

• Личный кабинет — кнопкой «Начать чат» у чатбота.
• Виджет — автоматически при первом сообщении посетителя.
• Telegram, MAX, VK — автоматически при первом сообщении пользователя канала.
• Мобильное приложение — клиент создаёт или переиспользует диалог.

Память диалога

Бот видит контекст: системный промпт, базу знаний, последние 10 сообщений истории и новое сообщение. Если контекст превышает лимит модели, старые сообщения отбрасываются — поэтому длинные диалоги «забывают» начало.

Как проходит ответ

Сообщение сохраняется в истории; если приложены файлы — изображения передаются модели как изображения, документы — извлечённым текстом. Если у бота есть базы знаний, система ищет релевантные фрагменты и добавляет их в контекст. Ответ приходит по частям (стриминг) и сохраняется в истории вместе со сведениями об использованных источниках.

Очистка истории

Управление в кабинете

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

Готового бота публикуют в каналах: веб-виджет на сайте, Telegram, VK, MAX и мобильное приложение. Для каждого канала — своя настройка. Сценарии каталога, корзины, заказов, оплаты и записи работают в веб-виджете, Telegram и MAX; в VK бот отвечает текстом на сообщения сообщества.

Мобильное приложение BiFL (iOS/Android) — приложение для клиентов вашего бизнеса. Оно подключается к чатботам через защищённый слой BFF с бесшовной авторизацией.

Два типа приложений

Авторизация и уведомления

Вход по email, через Google и VK ID, с выбором проекта. Push-уведомления работают через Firebase Cloud Messaging: новые заказы, записи клиентов, изменения статусов.

Commerce — модуль электронной коммерции: чатбот помогает клиенту выбрать товар или услугу, оформить заказ и оплатить. Вы загружаете каталог и настраиваете оплату, каналы включают commerce-сценарии отдельно.

Разделы модуля

Статусы заказа

Онлайн-оплата

1. Откройте Commerce → «Платёжные системы» и создайте систему: Tinkoff (Т-Банк) или CloudPayments.
2. Введите ключи API и проверьте подключение кнопкой «Тест».
3. Включите онлайн-оплату для нужных каналов.

Продажи прямо в диалоге

При включённых рекомендациях бот сам находит релевантные товары и показывает до 3 карточек. С tool-calling бот может искать товары, проверять наличие, добавлять в корзину, оформлять заказ и сообщать его статус — клиент видит прогресс в чате.

Booking — модуль онлайн-записи: клиент выбирает услугу и время в чатботе, а вы получаете запись и уведомление. Услуги, расписания и слоты настраиваются в кабинете.

Услуги и расписание

Услуга имеет цену, длительность и флаги «продавать» и «принимать запись» — так одна услуга работает и в Commerce, и в Booking. Расписание задаётся по дням недели: время работы и перерывы.

Слоты

• «Сгенерировать слоты» создаёт слоты из расписания на выбранный период; повторный запуск дубликатов не создаёт.
• Слот можно создать вручную: дата, время, длительность, вместимость.
• Статусы слота: доступен, заполнен, отменён, завершён.

Как клиент записывается

1. Выбирает услугу в чатботе.
2. Видит доступные слоты и выбирает время.
3. Указывает имя и телефон — они обязательны.
4. Получает запись; при включённой оплате — оплачивает.

Статусы записи

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

Статусы подписки

Как оформить подписку

1. Выберите тариф на странице «Тарифы».
2. Выберите период и оплатите через Т-Банк или CloudPayments.
3. После подтверждения оплаты подписка становится активной.

Автопродление

При включённом автопродлении система списывает сумму с сохранённой карты перед концом периода. Не удалось списать — подписка переходит в статус «просрочена»; привяжите или обновите карту и обратитесь в поддержку для повторной попытки.

Баланс

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

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

Основные лимиты

Что ещё зависит от тарифа

• Каналы: веб-виджет, Telegram, VK, MAX включаются тарифом.
• Голосовой ввод и вложения в чате.
• Модули Commerce и Booking и их разделы.
• Разделы Commerce, видимые в интерфейсе проекта, — подмножество разрешённых тарифом.

Регистрация

Зарегистрироваться можно по email и паролю, через Google или VK ID. Для телефона принимается российский формат +7XXXXXXXXXX. Сразу после регистрации создаются проект и первый пустой чатбот. Если платформа включила капчу, она запрашивается при регистрации, входе и сбросе пароля.

Вход

Основной способ входа — телефон и пароль; также доступны email с паролем и вход через Google / VK ID. При неверном номере, пароле или неактивном аккаунте система отвечает одинаково нейтрально и не раскрывает, существует ли аккаунт.

Восстановление пароля

1. Нажмите «Забыли пароль» и укажите email и телефон аккаунта.
2. Система создаст новый временный пароль и отправит его на email.
3. Войдите с новым паролем и смените его в профиле.

Сессии и профиль

• «Выйти» завершает текущую сессию, «Выйти со всех устройств» — все.
• В профиле доступны имя, email, телефон, часовой пояс, язык, аватар, смена пароля и привязка Google / VK.
• Неактивный аккаунт блокирует вход и все запросы до реакции поддержки.