> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Основні концепції
> Ключові концепції та термінологія в Revol
## Компанії
**Компанія** — це центральна сутність у Revol. Все — продукти, файли, агенти, інтеграції та аналітика — належить компанії.
Кожна компанія має:
* **Продукти та послуги** — структурований каталог з описами, цінами, фото та параметрами
* **Файловий менеджер** — документи, посилання, текст, відео та фото для баз знань
* **AI Агенти** — один або кілька інтелектуальних асистентів, навчених на даних компанії
* **Інтеграції** — підключені канали (widget, VoIP, месенджери, реклама, CRM)
* **Аналітика** — відстеження відвідувачів, дані сесій та історія розмов
Один акаунт Revol може керувати кількома компаніями з повністю ізольованими даними — ідеально для агентств або мультибрендових бізнесів.
***
## Продукти та послуги
**Продукти** — це структуровані моделі даних, що описують те, що пропонує ваш бізнес. На відміну від звичайних текстових документів, продукти надають AI агентам точну, структуровану інформацію для пошуку.
Кожен продукт включає:
| Поле | Призначення |
| ------------- | ----------------------------------------------------------------- |
| **Назва** | Назва продукту або послуги |
| **Опис** | Детальний текст, який агент використовує для відповідей |
| **Ціна** | Інформація про ціну |
| **URL** | Посилання на сторінку продукту на вашому сайті |
| **Наявність** | Чи доступний продукт наразі |
| **Фото** | Зображення продукту, які агент може надсилати |
| **Параметри** | Структуровані пари ключ-значення (розмір, колір, тривалість тощо) |
**Параметри** — найпотужніша частина — структуровані характеристики, які дозволяють агентам давати точні відповіді замість інтерпретації неструктурованого тексту. Дивіться [Швидкий старт → Параметри продуктів](/uk/quickstart#product-parameters) для прикладів.
***
## База знань
**База знань** — це контент, на якому навчаються ваші AI агенти. Вона використовує **RAG (Retrieval-Augmented Generation)** — документи розбиваються на фрагменти, перетворюються на векторні embeddings і семантично шукаються під час розмов.
### Типи контенту
| Тип | Формати | Як це працює |
| ------------- | --------------- | ------------------------------------------------- |
| **Документи** | PDF, DOCX, TXT | Текст витягується та розбивається на фрагменти |
| **Посилання** | Будь-який URL | Вміст веб-сторінки завантажується та індексується |
| **Текст** | Довільний текст | Додається безпосередньо як фрагменти знань |
| **Відео** | MP4, WebM, MOV | Аудіо транскрибується в текст через STT |
| **Фото** | JPG, PNG | Текст витягується через OCR |
### Два рівні знань
* **Файли на рівні компанії** — доступні всім агентам компанії
* **Файли на рівні продукту** — прикріплені до конкретного продукту, використовуються коли агент обговорює цей продукт
***
## AI Агенти
**AI Агент** — це інтелектуальний асистент, який налаштовується незалежно зі своєю особистістю, знаннями та поведінкою. Агенти можуть працювати в трьох режимах:
| Режим | Опис |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Активний** | AI повністю веде комунікацію з клієнтами — відповідає на повідомлення, викликає інструменти, дотримується воркфлоу |
| **Пасивний** | Ваша команда веде всю комунікацію. Агент працює у фоновому режимі — моніторить розмови, аудитує дотримання стандартів комунікації та надає аналітику |
| **Гібридний** | Комбінація: AI автоматично обробляє рутинні взаємодії, а команда підключається для складних випадків. Агент безперервно аналізує всі розмови незалежно від того, хто відповідає |
Пасивний режим ідеальний для команд, які хочуть AI-контроль якості без заміни живих операторів. Агент моніторить кожну розмову, перевіряє дотримання скриптів та стандартів і видає інсайти — без прямої відповіді клієнтам.
### Компоненти агента
Основний набір інструкцій — визначає роль агента, тон, мову та обмеження. Чим конкретніший ваш промпт, тим краще працює агент.
Оберіть, з яких продуктів та файлів агент має навчатися. Після вибору натисніть **Тренувати**, щоб згенерувати векторні embeddings для семантичного пошуку.
Візуальний редактор на основі вузлів для логіки розмови. Кожен агент отримує [стандартний workflow](/uk/quickstart#default-workflow), який покриває більшість випадків використання з коробки.
Функції, які агент може викликати під час розмов — пошук продуктів, перевірка наявності, отримання фото, завантаження документів, отримання інформації про компанію.
Налаштування зовнішнього вигляду чат-віджета — кольори, підписи, розташування, привітальні повідомлення, умови використання.
Підключення агента до каналів комунікації — віджет на сайті, Telegram, WhatsApp, Instagram, Facebook Messenger, VoIP.
### LLM Провайдери
Кожен агент (або окремий вузол workflow) може використовувати різну AI модель:
| Провайдер | Стандартні моделі | Преміум моделі |
| ------------- | ----------------- | ----------------- |
| **OpenAI** | GPT-4o-mini | GPT-4o |
| **Anthropic** | Claude 3.5 Haiku | Claude 3.5 Sonnet |
| **Google** | Gemini 2.0 Flash | Gemini 2.5 Pro |
| **Groq** | Llama 3.1 8B | Llama 3.3 70B |
Стандартні моделі швидші та споживають стандартні токени. Преміум моделі пропонують вищу якість та споживають преміум токени.
***
## Workflows
**Workflow** — це візуальний редактор на основі вузлів для визначення того, як ваш агент обробляє розмови. Вузли з'єднані зв'язками, що визначають потік даних.
### Типи вузлів
| Вузол | Опис |
| ---------------------- | ---------------------------------------------------------------- |
| **Start** | Точка входу — отримує повідомлення користувача |
| **LLM** | Надсилає контекст до AI моделі та отримує відповідь |
| **Condition** | Розгалужує потік на основі правил (ключові слова, намір, змінні) |
| **Tool Call** | Виконує зовнішню функцію (пошук продуктів, перевірка наявності) |
| **Voice Input (STT)** | Перетворює мовлення в текст для голосових взаємодій |
| **Voice Output (TTS)** | Перетворює текстову відповідь у мовлення |
| **Response Formatter** | Об'єднує виходи з кількох вузлів в одну відповідь |
### Стандартний Workflow
Кожен новий агент має попередньо побудований workflow:
```
Start → Product Agent ─┐
├→ Media Agent ─┤→ Response Formatter
└→ Company Agent ─┘
```
Три спеціалізовані агенти працюють **паралельно** — кожен обробляє свою область (продукти, медіа, інформація про компанію), а Formatter об'єднує їхні виходи. Це покриває більшість випадків використання без будь-якого налаштування.
Для складних сценаріїв — умовне розгалуження, власні виклики інструментів, багатокрокові потоки — використовуйте [Редактор Workflow](/uk/agents/workflow).
***
## Розмови
**Розмова** — це чат-сесія між відвідувачем та AI агентом. Усі розмови зберігаються та доступні зі сторінки **Розмови**.
### Канали
Розмови можуть відбуватися через:
* **Віджет на сайті** — вбудований чат на вашому сайті
* **VoIP** — телефонні дзвінки через Twilio, Ringostat або Binotel
* **Месенджери** — Telegram, WhatsApp Business, Instagram DM, Facebook Messenger
* **API** — програмний доступ
### Можливості
* **Єдина скринька** — всі розмови з усіх агентів та каналів в одному місці
* **Фільтри** — за агентом, статусом, датою, каналом
* **Транскрипти** — повна історія повідомлень з мітками часу
* **Відтворення аудіо** — прослуховування записів голосових дзвінків
* **Рейтинги** — оцінки задоволеності клієнтів за кожну розмову
***
## Трекінг
**Tracker** вбудований у той самий скрипт віджета та автоматично відстежує активність відвідувачів на вашому сайті.
### Що відстежується
| Дані | Опис |
| ---------------------- | ------------------------------------------------------------------------------- |
| **Сесії** | Сесії перегляду відвідувачів — пристрій, браузер, ОС, локація, джерело переходу |
| **Перегляди сторінок** | Окремі відвідування сторінок в межах сесії |
| **Події** | Користувацькі події — кліки, відправки форм, телефонні дзвінки |
| **Кампанії** | Групування на основі UTM (source, medium, campaign, term, content) |
### Автоматизація
* **Тригери** — автоматичні дії на основі поведінки відвідувачів (час на сторінці, глибина прокрутки, збіг UTM, тип пристрою). Можуть показувати оверлеї чату або користувацькі повідомлення.
* **Підміна номерів** — динамічна заміна телефонних номерів для відстеження та атрибуції дзвінків.
***
## Інтеграції
**Інтеграції** підключають ваших AI агентів до зовнішніх сервісів та каналів комунікації.
| Категорія | Провайдери | Що це робить |
| -------------------- | ------------------------------------------------- | ------------------------------------------------------------------ |
| **VoIP** | Twilio, Ringostat, Binotel | Телефонні дзвінки — агент відповідає на вхідні дзвінки |
| **Месенджери** | Telegram, WhatsApp, Instagram, Facebook Messenger | Чат через месенджери |
| **Google Workspace** | Gmail, Docs, Sheets, Drive, Calendar, Meet | Читання та взаємодія з сервісами Google |
| **Реклама** | Google Ads, Facebook Ads | Перегляд ефективності кампаній та управління рекламою |
| **Webhook** | Будь-який HTTP endpoint | Надсилання даних лідів, подій або сповіщень до CRM чи інших систем |
Кожна інтеграція налаштовується для кожної компанії окремо та може бути підключена до одного або кількох агентів.
***
## Білінг та плани
Revol використовує модель білінгу **на основі токенів**. Кожна AI взаємодія споживає токени — вхідні токени (ваше повідомлення + контекст) та вихідні токени (відповідь агента).
### Плани
**\$0/місяць** — спробуйте Revol з базовими лімітами
| Ресурс | Ліміт |
| -------------------- | -------------- |
| Компанії | 1 |
| AI Агенти | 1 |
| Стандартні токени | 20K / день |
| Преміум токени | — |
| Голос | — |
| Сховище | 100 MB |
| Документи бази знань | 10 |
| Розмови | 100 |
| Зберігання трекінгу | 30 днів |
| Інтеграції | — |
| Брендинг віджета | Брендинг Revol |
**\$29/місяць** — для бізнесів, що зростають
| Ресурс | Ліміт |
| -------------------- | ---------------- |
| Компанії | 3 |
| AI Агенти | 5 |
| Стандартні токени | 5M / місяць |
| Преміум токени | 1M / місяць |
| Голос (STT) | 60 хв |
| Голос (TTS) | 200K символів |
| Сховище | 5 GB |
| Документи бази знань | 100 |
| Розмови | 5,000 |
| Зберігання трекінгу | 180 днів |
| Інтеграції | VoIP, Месенджери |
| Брендинг віджета | Власний брендинг |
**\$79/місяць** — для агентств та підприємств
| Ресурс | Ліміт |
| -------------------- | -------------------------------- |
| Компанії | 10 |
| AI Агенти | Необмежено |
| Стандартні токени | 25M / місяць |
| Преміум токени | 2M / місяць |
| Голос (STT) | 300 хв |
| Голос (TTS) | 500K символів |
| Сховище | 50 GB |
| Документи бази знань | 1,000 |
| Розмови | 50,000 |
| Зберігання трекінгу | 730 днів (2 роки) |
| Інтеграції | Усі (вкл. Google Workspace, Ads) |
| Брендинг віджета | White Label |
### Що вважається токеном
Кожна AI взаємодія має дві частини:
* **Вхідні токени** — ваше повідомлення + системний промпт + отримані фрагменти бази знань + історія розмови
* **Вихідні токени** — відповідь агента
Різні моделі споживають різні типи токенів:
| Тип токенів | Моделі | Плани |
| -------------- | ------------------------------------------------------------- | --------- |
| **Стандартні** | GPT-4o-mini, Claude 3.5 Haiku, Gemini 2.0 Flash, Llama 3.1 8B | Усі плани |
| **Преміум** | GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro, Llama 3.3 70B | Premium+ |
### Додаткові пакети
Потрібно більше ресурсів? Придбайте додаткові пакети без оновлення плану:
| Пакет | Що ви отримуєте | Ціна |
| ------------------ | ----------------------------- | ---- |
| Token Pack S | 5M стандартних токенів | \$4 |
| Token Pack M | 20M стандартних токенів | \$15 |
| Token Pack L | 50M стандартних токенів | \$35 |
| Premium Token Pack | 2M преміум токенів | \$20 |
| Voice Pack | 60 хв STT + 100K символів TTS | \$3 |
| Storage Pack | 10 GB сховища | \$1 |
Додаткові пакети діють **3 місяці** після покупки. Невикористані токени не переносяться між білінговими періодами.
### Що відбувається при досягненні ліміту
| Ресурс | Поведінка |
| --------------------------- | ----------------------------------------------------------------------------- |
| Стандартні / Преміум токени | Агент перестає відповідати до наступного білінгового циклу або покупки пакету |
| Сховище | Неможливо завантажити нові файли |
| Голос | Голосові функції вимкнено |
| Розмови | Нові розмови заблоковано |
Revol надсилає сповіщення при **80%** (попередження) та **90%** (критичне) використання, щоб ви могли діяти до досягнення ліміту.
***
## Наступні кроки
Налаштуйте компанію та першого агента за кілька хвилин
Детальний огляд конфігурації та можливостей агентів
Встановіть чат-віджет на ваш сайт
Інтегруйте Revol програмно