Агент-аналітик: що це і як ним користуватись

Пояснення для маркетологів — навіщо потрібен агент-аналітик і як ставити йому питання.

Пояснення для маркетологів і всіх, хто ставить питання до аналітики, — без технічних деталей. Технічна архітектура для розробників живе окремо: Агент-аналітик: архітектура.

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

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

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

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

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

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

Відкрийте розділ Analyst у боковому меню Kumquat (потрібен звичайний акаунт Kumquat — той самий логін, що й для решти системи).
Натисніть «Новий тред» або просто напишіть питання внизу екрана.
Дочекайтеся відповіді. Під час складного аналізу агент показує план — список кроків, які він виконує, — тож видно, що відбувається, а не просто «крутилка».
Уточнюйте далі в тому ж треді: агент пам’ятає контекст розмови. «А тепер те саме, але тільки 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» під таблицею; якщо все одно незрозуміло — до команди розробки з посиланням на тред.
Ідеї нових метрик чи термінів, які агент має розуміти («фатіг», «когорта», внутрішні назви кампаній) — теж до команди розробки: додати нове поняття у словник агента — справа кількох рядків, а якість відповідей росте помітно.