Основные концепции

Понимание этих строительных блоков упростит использование любой функции в FRENZY.BOT. На этой странице объясняется, как работает система, простыми словами.

Как работает FRENZY.BOT

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│ Ваши данные │ ──→ │ Индексация   │ ──→ │   Qdrant    │
│ Файлы, URL  │     │(Эмбеддинги)  │     │ (Векторная  │
│    FAQ      │     └──────────────┘     │     БД)     │
└─────────────┘                          └──────┬──────┘
                                                │
                                                │ извлечение
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Вопрос     │ ──→ │  FRENZY.BOT  │ ──→ │  AI-модель  │
│ пользователя│     │ (RAG движок) │ ←── │ (через      │
└─────────────┘     └──────┬───────┘     │ OpenRouter) │
                           │             └─────────────┘
                    ┌──────┴──────┐
                    │    Ответ    │
                    │ + Данные лида│
                    │ + Аналитика │
                    └─────────────┘

Вы загружаете свои данные — файлы, URL-адреса веб-сайтов и пары FAQ попадают в Базу знаний.
Система индексирует их — контент преобразуется в числовые эмбеддинги и сохраняется в Qdrant (векторную базу данных), чтобы его можно было искать по смыслу, а не только по ключевым словам.
Пользователь задает вопрос — через виджет, WhatsApp, Telegram или любой другой подключенный канал.
FRENZY.BOT извлекает релевантный контент — система находит наиболее подходящие фрагменты вашей базы знаний с помощью семантического поиска.
AI-модель генерирует ответ — извлеченный контент + вопрос пользователя отправляются в модель ИИ (Claude, GPT, Gemini и т. д.) через OpenRouter.
Все отслеживается — диалог, время ответа, использование токенов и любые полученные данные лидов сохраняются для отчетности.

Бот (Bot)

Ваш бот — это AI-ассистент, которого вы создаете. У каждого бота есть свои:

База знаний — документы, URL-адреса и FAQ, на которых он учится.
Настройки — AI-модель, системный промпт, температура, брендинг, конфигурация виджета.
Диалоги — история переписки с пользователями.
Лиды — контакты, собранные во время разговоров.
Аналитика — метрики использования и данные воронки.
Виджет — собственный код вставки с уникальным data-bot-id.

В мульти-бот конфигурации вы можете запускать несколько ботов из одной инсталляции — каждый из них будет полностью изолирован от остальных.

Где управлять: Настройки (Settings), База знаний (Knowledge Base), Вставка (Embed) и выпадающее меню рабочего пространства в заголовке.

База знаний (Knowledge Base)

База знаний — это библиотека, которую ваш бот изучает перед тем, как ответить на любой вопрос. Именно она делает вашего бота специфичным для вашего бизнеса, а не просто стандартным ИИ.

Три источника данных:

Источник	Лучше всего подходит для	Скорость индексации
Файлы (PDF, DOCX, TXT, CSV и т.д.)	Внутренние документы, регламенты, спецификации продуктов	Минуты
URL (любая публичная страница)	Контент сайта, справочные статьи, посты в блоге	Минуты
FAQ (ручные пары вопрос-ответ)	Важные ответы, которые вы хотите контролировать точно	Мгновенно

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

Полное руководство см. в разделе База знаний.

Каналы (Channels)

Каналы — это места, где ваши пользователи взаимодействуют с ботом.

Канал	Тип	Настройка
Виджет на сайте	Основной	Скрипт вставки на вашем сайте
WhatsApp	Мессенджер	WAHA Docker + сопряжение по QR-коду
Telegram	Мессенджер	Токен бота от @BotFather
Discord	Сообщество	Токен бота из Developer Portal
Instagram	Соцсети	Токен доступа к странице (Page Access Token)
Messenger	Соцсети	Интеграция со страницей Facebook
Slack	Рабочее пространство	Токен приложения
Webhook	Кастомный	Любой HTTP-эндпоинт

У каждого канала может быть свой стиль ответа — ИИ адаптирует тон и длину ответа в соответствии с платформой (например, короче в WhatsApp, подробнее в виджете на сайте).

Подробности см. в разделе Каналы.

Сессии и диалоги (Sessions & conversations)

Сессия — это один полный разговор между пользователем и вашим ботом. Каждая сессия отслеживает:

Сообщения — каждый вопрос и ответ в диалоге.
Токены — сколько токенов ИИ было израсходовано (влияет на стоимость).
Длительность — как долго длился разговор.
Источник — из какого канала пришел диалог.
Данные лида — любая контактная информация, собранная во время чата.

Сессии являются основой аналитики, анализа качества и сбора лидов. Просматривайте их в разделе Диалоги.

Лиды и интеграции (Leads & integrations)

Лид — это контакт, полученный во время чата: имя, email, телефон, компания и любые настроенные вами кастомные поля.

Лиды проходят через воронку:

Новый (New) → Связались (Contacted) → Квалифицирован (Qualified) → Конвертирован (Converted) (или Утерян (Lost))

Интеграции автоматически направляют лидов в ваши внешние инструменты:

Email — SMTP-уведомления вашей команде.
Webhook — отправка JSON-данных на ваши эндпоинты.
Google Sheets — добавление строк в таблицу для простой CRM.
MailChimp — добавление контактов в списки email-маркетинга.

Подробности см. в разделах Управление лидами и Интеграции.

Модули (Modules)

Модули — это дополнительные возможности, которые можно включать или отключать, не затрагивая ядро системы:

Модуль	Что он делает
Live Web Access (Tavily)	Позволяет боту искать информацию в реальном интернете, если внутренних данных недостаточно
Human Handoff	Передает диалог живому оператору
Text-to-Speech	Преобразует ответы ИИ в аудио
Appointment Booking	Бронирование встреч через Calendly прямо в чате
Lead Form	Сбор контактной информации в процессе диалога
WhatsApp	Автоматизированная рассылка через WAHA

Просматривайте модули и управляйте ими в разделе Модули.

Быстрая самопроверка

Используйте этот чек-лист, чтобы убедиться, что ваш бот полностью готов к работе:

[ ] База знаний заполнена — добавлен хотя бы один файл, URL или FAQ со статусом Live.
[ ] OpenRouter подключен — в разделе AI Engine отображается подключенный провайдер и выбранная модель.
[ ] Виджет развернут — код вставки добавлен на ваш сайт, и иконка чата появилась.
[ ] Интеграции включены — лиды направляются в вашу CRM, почту или через вебхук.

Если все четыре пункта выполнены, ваша система полностью функциональна и готова к приему трафика.