---
title: "Агент-аналітик: що це і як ним користуватись"
description: Пояснення для маркетологів — навіщо потрібен агент-аналітик і як ставити йому питання.
---

*Пояснення для маркетологів і всіх, хто ставить питання до аналітики, — без
технічних деталей. Технічна архітектура для розробників живе окремо:
[Агент-аналітик: архітектура](/backend/analyst-agent-architecture).*

## Навіщо це потрібно

Раніше, щоб відповісти на питання «який CPA у креативів з UGC-хуком за останній
місяць?», треба було або йти до аналітика, або самому збирати вивантаження.

Агент-аналітик — це чат у Kumquat (розділ **Analyst** у боковому меню), якому
таке питання можна поставити звичайною мовою. Агент сам:

1. розуміє, про які метрики й розрізи йдеться;
2. пише запит до аналітичної бази даних;
3. виконує його і повертає відповідь: короткий висновок + таблицю з цифрами.

Ніяких SQL, вивантажень і чекання в черзі до аналітика.

## Як користуватись

1. Відкрийте розділ **Analyst** у боковому меню Kumquat (потрібен звичайний
   акаунт Kumquat — той самий логін, що й для решти системи).
2. Натисніть «Новий тред» або просто напишіть питання внизу екрана.
3. Дочекайтеся відповіді. Під час складного аналізу агент показує план — список
   кроків, які він виконує, — тож видно, що відбувається, а не просто «крутилка».
4. Уточнюйте далі в тому ж треді: агент пам'ятає контекст розмови. «А тепер те
   саме, але тільки iOS» — працює.

Треди зберігаються: можна повернутись до вчорашньої розмови і продовжити з того
самого місця. Кожен бачить лише свої треди.

## Які питання можна ставити

Агент працює з даними про **перформанс рекламних креативів**: спенд, покази,
кліки, інстали, тріали, покупки, LTV — у розрізі продуктів, платформ, каналів,
країн, кампаній і окремих креативів. Плюс **атрибути самих креативів**: тип
задачі, формат хука, джерело (AI чи дизайнерський), статус тестування,
результати VLM-розмітки відео.

Приклади:

- «Топ-10 креативів по спенду за минулий місяць на Meta»
- «Порівняй CPA по каналах за останні 30 днів»
- «Які формати хуків дають найкращий CPA?»
- «Покажи динаміку ROAS по тижнях для PlantIn на iOS»
- «Чиї креативи найчастіше долітають до статусу scale?»
- «AI-креативи проти дизайнерських: де дешевша покупка?»

## Що агент вміє «з коробки»

- **Знає командні домовленості.** Тиждень — це понеділок–неділя; «минулий
  тиждень» — останній повний, а не «сім днів назад»; тестові кампанії
  виключаються автоматично; ratio-метрики рахуються правильно (сума на суму,
  а не «середнє середніх»).
- **Показує свою роботу.** Під кожною таблицею є кнопка «SQL» — можна
  розгорнути й побачити точний запит, яким отримані цифри. Якщо цифра дивує —
  завжди видно, звідки вона взялась.
- **Таблиці можна забрати з собою.** Кнопка CSV під таблицею вивантажує
  результат у файл для Excel/Google Sheets.
- **Чесний з застереженнями.** Якщо вибірка мала або період закороткий для
  висновків — агент скаже про це сам.

## Обмеження, про які варто знати

- **Дані за сьогодні відсутні.** Статистика доїжджає з рекламних кабінетів
  кілька разів на день; за вчора цифри можуть бути неповними приблизно до
  11:00 за Києвом. «Все обвалилось у нуль за вчора» зранку — майже завжди
  саме це, а не реальний обвал.
- **ROAS — прогнозний.** Він рахується на модельному LTV, який перераховується
  заднім числом ще ~60 днів. ROAS свіжих когорт «пливе» — агент нагадує про
  це у відповідях.
- **Атрибути креативів оновлюються щогодини.** Щойно доданий у Kumquat креатив
  з'явиться в аналітиці протягом години, не миттєво.
- **Агент тільки читає.** Він фізично не може нічого змінити чи видалити в
  даних — доступ обмежений на рівні бази, а не «чесного слова».
- **Агент може помилятися.** Як і людина-аналітик. Для важливих рішень
  перевіряйте несподівані цифри — кнопка «SQL» під таблицею для цього і
  існує. Якщо агент систематично неправильно розуміє якийсь термін — скажіть
  команді розробки: словник агента поповнюється саме з таких випадків.

## Звідки беруться дані

Дві складові, обидві оновлюються автоматично:

- **Статистика закупівлі** (спенд, покази, покупки тощо) — імпортується з
  рекламних джерел кілька разів на день, як і для розділу Analytics.
- **Картки креативів** (тип, хук, джерело, статус тесту, VLM-розмітка) —
  щогодини синхронізуються з основної бази Kumquat.

Тобто агент відповідає по тих самих даних, що й дашборди, — просто ним можна
питати словами.

## Куди звертатися

- Питання «чому цифра така» — спершу кнопка «SQL» під таблицею; якщо все одно
  незрозуміло — до команди розробки з посиланням на тред.
- Ідеї нових метрик чи термінів, які агент має розуміти («фатіг», «когорта»,
  внутрішні назви кампаній) — теж до команди розробки: додати нове поняття у
  словник агента — справа кількох рядків, а якість відповідей росте помітно.