docs_content/index.md

Metrik AI Bot

Metrik AI Bot — это бот для вопросов по маркетинговой аналитике в Telegram-чате.

Что бот умеет лучше всего:

  • узнать факт по данным: бюджет, лиды, выручку, ROMI, цену заявки и другие метрики;
  • вернуть сразу несколько метрик в одном запросе, если у них общий период, срез и фильтры;
  • разложить результат по срезам: подрядчик, канал, тип трафика, воронка, кампания, объявление;
  • показать динамику по времени: по дням, месяцам и годам;
  • найти сильные отклонения, аномалии и зоны риска через agent-only анализ;
  • объяснить, как бот понял ваш запрос: период, атрибуцию, тип даты, срезы и фильтры;
  • уточнять вопрос reply-сообщением, если бот попросил метрику, период или другой параметр.

Для быстрых стартовых материалов удобнее всего открыть:

  • Старт для бета-теста
  • Как пользоваться
  • Метрики и срезы
  • Свободный анализ
  • Архитектура: ANALYZE agent-only
  • Примеры вопросов

Быстрый старт за 30 секунд

  1. В групповом чате напишите вопрос через @metrik_ai_bot.
  2. Начните с простого fact-вопроса: одна метрика, один период, один срез.
  3. Посмотрите блок Интерпретация вопроса: там видно, как бот понял запрос.
  4. Если бот попросил уточнение, просто ответьте reply на его сообщение.

Хорошие первые вопросы:

  • @metrik_ai_bot сколько было лидов в этом месяце
  • @metrik_ai_bot какая выручка по подрядчикам за март 2026
  • @metrik_ai_bot покажи расход по каналам за последние 30 дней

Что важно знать сразу

  • Бот работает только в разрешённых групповых чатах.
  • В группе вопрос нужно задавать через @metrik_ai_bot.
  • Если бот попросил уточнение, можно просто ответить reply на его сообщение.
  • Если какой-то параметр не указан, бот может подставить значение по умолчанию и явно показать это в блоке интерпретации.
  • Под успешными ответами бота есть кнопки feedback: ✅ Отлично и ❌ Плохо.

Свободный анализ

Сейчас Свободный анализ работает через общий agent-only runtime. Ему можно задавать вопросы про:

  • взвешенная вероятность оплаты;
  • экран эффективности по ROMI;
  • сравнение соседних периодов;
  • диагностика просадки и скачков;
  • перераспределение бюджета;
  • диагностика узкого места по этапам.

Это не отдельные hard-coded ветки. Agent сам выбирает внутренние безопасные query_data запросы. Примеры формулировок есть на странице Свободный анализ.

Какие задачи бот решает лучше всего

  • "Какой был бюджет за февраль 2026"
  • "Сколько было лидов в этом месяце"
  • "У кого из подрядчиков больше всего лидов"
  • "Какая кампания дала лучший ROMI"
  • "Покажи выручку за последние 12 месяцев по месяцам"
  • "Выведи выручку за все время по годам"
  • "Покажи лиды, расход и выручку по подрядчикам за март 2026"
  • "Найди аномалии за последнюю неделю"
  • "Проведи анализ, где мы сливаем деньги в этом месяце"
  • "Как считается ROMI 2"

С чего лучше не начинать

На бета-этапе хуже всего работают слишком длинные смешанные вопросы, где в одном сообщении сразу:

  • много метрик;
  • несколько разных смыслов;
  • сложная сортировка;
  • и факт, и анализ, и объяснение одновременно.

Вместо:

  • покажи расход, выручку, прибыль, конверсии, а потом объясни почему всё упало

лучше:

  • сначала спросить факт;
  • потом отдельным сообщением спросить анализ;
  • потом при необходимости уточнить explanation.

Как устроен ответ

Обычно ответ состоит из двух или трёх частей:

  • Интерпретация вопроса — как бот понял вопрос: метрика, период, атрибуция, тип даты, срезы и фильтры;
  • Результат — само значение или список значений;
  • для аналитического режима дополнительно могут быть Аномалии, Зоны риска и AI-Интерпретация.

Блок Интерпретация вопроса можно свернуть или раскрыть.