> ## 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.
# Використання та аналітика
> Моніторинг споживання ресурсів у реальному часі, аналіз подій використання, розуміння токенів та відстеження витрат по всіх компаніях
## Дашборд огляду
Перейдіть до **Білінг** → **Огляд**, щоб відкрити дашборд аналітики використання — єдину сторінку, що дає повну видимість споживання ресурсів, лімітів платформи та детальний журнал кожної платної дії.
Дашборд розділений на чотири секції: **Зведення плану**, **Використання ресурсів**, **Ліміти платформи** та **Події використання**.
***
## Зведення плану
У верхній частині сторінки відображається картка з деталями поточної підписки.
**Ліва сторона:**
* Градієнтний бейдж з назвою вашого плану (Free, Premium або Professional) та іконкою корони
* На платному плані — місячна ціна (напр., **\$29 /міс.**) та дата наступного платежу (напр., "Наступний платіж: 15.04.2026")
* На безкоштовному плані — запрошення до оновлення
**Права сторона:**
* Кнопка **Manage** — відкриває модальне вікно керування підпискою (тільки для платних планів). Див. [Керування підпискою](/uk/billing/plans#керування-підпискою)
* Кнопка **Upgrade Plan** / **Change Plan** — посилання на сторінку [Тарифів](/uk/billing/plans)
***
## Використання ресурсів
Шість карток з прогрес-барами, розташованих у сітці з 3 колонок (2 на планшеті, 1 на мобільному). Кожна картка відстежує один платний ресурс у реальному часі.
| # | Ресурс | Іконка | Що вимірює |
| - | --------------------- | --------------------- | ----------------------------------------------------------------------------------------------------- |
| 1 | **Стандартні токени** | Блискавка (синя) | Токени, спожиті стандартними моделями — GPT-4o Mini, Claude 3.5 Haiku, Gemini 2.0 Flash, Llama 3.1 8B |
| 2 | **Преміум токени** | Блискавка (фіолетова) | Токени, спожиті преміум моделями — GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro, Llama 3.3 70B |
| 3 | **Голос STT** | Мікрофон (блакитний) | Час транскрипції мовлення в текст у хвилинах |
| 4 | **Голос TTS** | Динамік (жовтий) | Синтез тексту в мовлення у символах |
| 5 | **Embeddings** | База даних (зелена) | Токени для тренування бази знань (розбивка на чанки + генерація векторів) |
| 6 | **Сховище** | Папка (рожева) | Загальне файлове сховище по всіх компаніях |
Кожна картка відображає:
1. **Рядок заголовка** — іконка та назва ресурсу зліва, бейдж з відсотком справа
2. **Прогрес-бар** — 8-піксельний бар, що показує поточне споживання як заповнений градієнт
3. **Рядок значень** — "**N** використано" зліва, "з **N**" (ліміт плану) справа
### Кольорові пороги
Бейдж та прогрес-бар змінюють колір залежно від рівня споживання:
| Рівень використання | Колір | Значення |
| ------------------- | ---------------- | --------------------------------------------------------------- |
| Нижче 80% | **Зелений** | Нормально — є значний запас |
| 80% – 89% | **Помаранчевий** | Попередження — варто оновити план або придбати пакет |
| 90% і вище | **Червоний** | Критично — наближення до ліміту, запити можуть бути заблоковані |
Значення сховища відображаються у зрозумілих одиницях — **MB** для обсягів менше 1 GB, **GB** для більших значень. Усі інші ресурси показують форматовані числа з розділювачами тисяч.
***
## Ліміти платформи
Чотири картки-лічильники під метрами ресурсів, розташовані в сітці з 4 колонок (2 на планшеті, 1 на мобільному). Вони показують скільки ресурсів платформи ви створили відносно максимуму плану:
| Іконка | Лічильник | Приклад |
| --------------------- | ------------------------ | ------------- |
| Будівля (синя) | **Компанії** | 2 / 3 |
| Паличка (фіолетова) | **AI-агенти** | 4 / 5 |
| Документ (зелений) | **Документи бази знань** | 45 / 100 |
| Повідомлення (жовтий) | **Розмови** | 1 200 / 5 000 |
Коли ліміт необмежений (напр., AI-агенти на плані Professional), максимум відображається як **∞**.
Коли ви намагаєтесь створити ресурс, що перевищує ліміт плану (напр., 6-й агент на плані Premium), з'являється модальне вікно з поясненням ліміту та пропозицією оновити план або придбати пакет.
***
## Події використання
Нижня секція містить детальну фільтровану таблицю, що логує кожну платну дію по всіх ваших компаніях. Це ваш аудиторський слід для розуміння того, що саме спожило вашу квоту.
### Фільтрація
Натисніть кнопку **+ Filter**, щоб додати фільтр-чіпи. Доступно шість типів фільтрів:
| Фільтр | Тип | Опції |
| -------------- | ----------------- | --------------------------------------------------------------------------------------- |
| **Date From** | Вибір дати | Календарний попап — оберіть початкову дату |
| **Date To** | Вибір дати | Календарний попап — оберіть кінцеву дату |
| **Company** | Випадаючий список | Перелік усіх ваших компаній за назвою |
| **Event Type** | Випадаючий список | Chat, Workflow, STT, TTS, Embedding, Storage |
| **Resource** | Випадаючий список | Standard Tokens, Premium Tokens, STT Minutes, TTS Characters, Embedding Tokens, Storage |
| **Channel** | Випадаючий список | Admin, Widget, System |
Активні фільтри відображаються як чіпи з можливістю видалення над таблицею. Видалення чіпа негайно перезавантажує таблицю з оновленими результатами.
### Колонки таблиці
Кожен рядок таблиці представляє одну платну подію з вісьмома колонками:
| Колонка | Опис | Формат |
| ------------ | ----------------------------------- | ------------------------------------------------------------------- |
| **Date** | Коли подія відбулась | `ДД.ММ.РРРР ГГ:хх` |
| **Company** | Агент якої компанії ініціював подію | Назва компанії, або `—` для системних подій |
| **Event** | Тип платної дії | Кольоровий бейдж (див. нижче) |
| **Resource** | Яка квота ресурсу була спожита | Текстова мітка |
| **Channel** | Звідки прийшла взаємодія | Сірий бейдж (Admin, Widget, System), або `—` |
| **Model** | Яка LLM-модель використовувалась | Моноширинний шрифт (напр., `gpt-4o-mini`), або `—` для не-LLM подій |
| **Amount** | Кількість спожитого | Розумне форматування (див. нижче) |
| **Cost** | Орієнтовна вартість у USD | Жирний шрифт, табулярні цифри (див. нижче) |
### Бейджі типів подій
Кожен тип події має окремий кольоровий бейдж для швидкого візуального сканування:
| Тип події | Колір бейджа | Опис |
| ------------- | ------------ | ------------------------------------------- |
| **Chat** | Синій | LLM-інференс з чат-розмови |
| **Workflow** | Фіолетовий | LLM-інференс з виконання вузла workflow |
| **STT** | Блакитний | Транскрипція мовлення в текст |
| **TTS** | Жовтий | Синтез тексту в мовлення |
| **Embedding** | Зелений | Тренування бази знань (генерація векторів) |
| **Storage** | Рожевий | Завантаження файлу або операція зі сховищем |
### Форматування суми
Колонка Amount адаптує формат відображення залежно від типу ресурсу:
| Ресурс | Формат | Приклад |
| ------------------------------------- | -------------------------------- | ------------------ |
| Токени (Standard, Premium, Embedding) | Число з розділювачами + "tokens" | `4,521 tokens` |
| STT Minutes | Хвилини та секунди | `2m 34s` |
| TTS Characters | Число з розділювачами + "chars" | `1,250 chars` |
| Storage | MB або KB | `3.2 MB`, `450 KB` |
### Форматування вартості
Колонка Cost показує орієнтовну вартість у USD з точністю, адаптованою до значення:
* \*\*$0.01 і вище** — відображається з 2 знаками після коми (напр., `$1.25\`)
* \*\*Нижче $0.01** — відображається з точністю до 8 знаків, без зайвих нулів (напр., `$0.00042\`)
* **Нуль або не застосовується** — відображається як `—`
### Пагінація
Таблиця завантажує 25 подій на сторінку з асинхронною пагінацією. Нижній бар показує:
* **"Showing X–Y of Z"** — поточний діапазон та загальна кількість
* **Кнопки сторінок** — перша сторінка, остання сторінка та вікно ±2 сторінки навколо поточної, з крапками (`…`) для пропусків
Під час завантаження таблиця відображає анімований скелетон з 8 рядками мерехтіння. Якщо жодна подія не відповідає фільтрам, з'являється повідомлення: "No usage events found."
***
## Як працюють токени
Кожна AI-взаємодія складається з двох частин:
* **Вхідні токени** — ваше повідомлення + системний промпт + контекст бази знань (RAG-чанки) + історія розмови + описи інструментів
* **Вихідні токени** — відповідь агента
Обидва типи зараховуються до вашої квоти. Загальна кількість за взаємодію залежить від:
1. **Довжина системного промпту** — довші промпти споживають більше вхідних токенів на повідомлення
2. **Контекст бази знань** — більше отриманих RAG-чанків = більше вхідних токенів. Контролюйте через **RAG Settings → Chunk Limit**
3. **Історія розмови** — довші розмови накопичують контекст з попередніх повідомлень
4. **Довжина відповіді** — контролюється повзунком **Response Length** у налаштуваннях особистості агента
5. **Виклики інструментів** — кожен раунд виклику додає вхідні токени (описи інструментів) та вихідні токени (аргументи + результати)
### Типи токенів
| Тип токенів | Моделі | Профіль вартості |
| ------------- | ------------------------------------------------------------- | --------------------------------------------------- |
| **Standard** | GPT-4o Mini, Claude 3.5 Haiku, Gemini 2.0 Flash, Llama 3.1 8B | Нижча вартість, швидші відповіді |
| **Premium** | GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro, Llama 3.3 70B | Вища вартість, краща якість |
| **Embedding** | text-embedding-ada-002 | Використовується лише під час тренування бази знань |
Для оптимізації використання токенів: тримайте системні промпти стислими, обмежте кількість RAG-чанків на запит (RAG Settings → Chunk Limit), використовуйте стандартні моделі для простих задач, а преміум моделі резервуйте для складних відповідей.
***
## Використання голосу
Голосові взаємодії споживають два окремих ресурси:
* **STT (Speech-to-Text)** — вимірюється в хвилинах. Кожне голосове повідомлення транскрибується, і тривалість (округлена вгору до найближчої хвилини) списується з квоти.
* **TTS (Text-to-Speech)** — вимірюється в символах. Текстова відповідь агента синтезується в аудіо, і кількість символів списується.
Один голосовий поворот розмови зазвичай споживає і STT хвилини (аудіо відвідувача), і TTS символи (голосова відповідь агента). Вони відображаються як окремі рядки в таблиці подій використання — подія **STT** (блакитний бейдж) та подія **TTS** (жовтий бейдж).
***
## Використання сховища
Сховище споживається при завантаженні файлів у [Файловий менеджер](/uk/file-manager):
* **Документи** — PDF, Word, Excel, TXT
* **Фото** — JPG, PNG
* **Відео** — MP4, WebM, MOV
* **Аудіозаписи** — файли аудіо розмов
Використання сховища відстежується двонаправлено — завантаження збільшує використання, видалення файлів зменшує. Метр сховища на дашборді показує поточний загальний обсяг по всіх компаніях.
***
## Сповіщення про квоти
Revol моніторить ваше використання та надсилає попередження перед досягненням лімітів:
| Поріг | Рівень | Сповіщення |
| ------- | ------------ | ----------------------------------------------------------------------------------------------------------- |
| **80%** | Попередження | Email + банер в додатку: "Ви використали 80% вашого \[ресурсу]. Розгляньте оновлення або придбання пакету." |
| **90%** | Критичне | Email + банер в додатку: "Ви використали 90% вашого \[ресурсу]. Запити будуть заблоковані при 100%." |
Кожне попередження спрацьовує **один раз за білінговий період** на тип ресурсу. Критичні попередження мають пріоритет — якщо використання стрибнуло з 75% до 92%, надсилається лише критичне сповіщення.
Банери в додатку відображаються у верхній частині кожної сторінки дашборду. Ви можете закрити їх на поточну сесію, але вони з'являться знову при наступному вході, якщо поріг все ще перевищений.
***
## Що відбувається при досягненні ліміту
| Ресурс | Поведінка |
| --------------------------- | ----------------------------------------------------------------------------- |
| Стандартні / Преміум токени | Агент перестає відповідати до наступного білінгового циклу або покупки пакету |
| Сховище | Неможливо завантажити нові файли у Файловий менеджер |
| Голос (STT/TTS) | Голосові функції вимкнено, текстовий чат продовжує працювати |
| Розмови | Нові розмови заблоковано, існуючі продовжуються |
| Документи бази знань | Неможливо додати нові документи до баз знань агентів |
Коли ліміт досягнуто і ви намагаєтесь виконати заблоковану дію, з'являється модальне вікно з поточним використанням, лімітом плану та опціями оновлення плану або придбання додаткового пакету.
***
## Білінговий період
* **Безкоштовний план** — щоденний період. Використання токенів скидається щодня опівночі UTC.
* **Платні плани** — щомісячний період. Використання скидається у річницю дати підписки (напр., якщо ви підписались 15 березня, наступне скидання — 15 квітня).
Додаткові пакети незалежні від білінгового періоду — вони мають власний 3-місячний термін дії від дати придбання. Коли включена квота плану вичерпана, споживання автоматично переключається на найстаріший за терміном пакет.