docs_content/how_to_use.md

Как пользоваться ботом

Самый простой сценарий

Если вы впервые открыли бот, идите так:

  1. Спросите один простой факт.
  2. Посмотрите Интерпретацию вопроса.
  3. Если всё понято верно, переходите к более сложным запросам.

Пример первого сообщения:

@metrik_ai_bot сколько было лидов за март 2026

1. Упомяните бота

В групповом чате пишите вопрос с упоминанием:

@metrik_ai_bot какой был бюджет за февраль 2026

2. Если бот попросил уточнение, ответьте reply

Пример:

@metrik_ai_bot какая рекламная кампания была самая эффективная?

Бот может спросить, что считать эффективностью. Тогда можно ответить reply:

romi

Если дальше нужен период, тоже отвечайте reply:

за март 2026

3. Проверяйте блок Интерпретация вопроса

Перед результатом бот показывает, как он понял вопрос:

  • какую метрику выбрал;
  • какой период использовал;
  • какую атрибуцию применил;
  • какой тип даты взял;
  • какой срез построил;
  • какие значения подставил по умолчанию.

Если Интерпретация вопроса неверна, проще задать вопрос ещё раз точнее, чем пытаться "додумать" за бота.

4. Формулируйте один запрос за раз

Лучше всего бот работает на одном аналитическом намерении в сообщении.

Хорошо:

@metrik_ai_bot сколько было лидов за февраль 2026

Хуже:

@metrik_ai_bot сколько было лидов, почему они упали и как считается ROMI

Если вопрос смешанный, разбивайте его на два сообщения.

5. Если ответ хороший или плохой, нажмите оценку

Под успешными ответами бот показывает:

  • ✅ Отлично
  • ❌ Плохо

Если выбрать ❌ Плохо, бот попросит указать причину. Это помогает быстрее исправлять системные ошибки в бета-периоде.

6. Для более свободных аналитических вопросов используйте отдельный тип формулировки

Если вы хотите не просто число, а аналитическую оценку по заданной логике, формулируйте это явно.

Примеры:

@metrik_ai_bot Оцени вероятность оплаты по воронке фдк26 за 3 месяца
@metrik_ai_bot Посчитай ожидаемое число оплат по подрядчику Илья Серов для воронки фдк26 за 3 месяца

Сейчас такие вопросы обрабатываются agent-only веткой свободного анализа.

Подробности и примеры формулировок вынесены на страницу Свободный анализ.

7. Если нужен именно свободный анализ, задавайте критерий и срез явно

Лучше всего работают вопросы, где явно названы:

  • период;
  • срез: подрядчик, канал, воронка, кампания, объявление, utm_source;
  • критерий: ROMI, CPL, расход, лиды, оплаты, выручка;
  • желаемое действие: сравнить, найти просадку, оценить вероятность, подобрать кандидатов.

Примеры:

  • Какие подрядчики убыточны по ROMI за 14 дней
  • Куда перераспределить бюджет по каналам за 30 дней
  • Где узкое место по воронке фдк26 за 14 дней

Важно:

  • бот сначала понимает, что это ANALYZE;
  • затем запускается общий agent;
  • agent сам выбирает внутренние query_data запросы;
  • raw SQL у agent-а нет.

8. Какие бывают аналитические ответы

Сейчас аналитический ответ строит один agent-only runtime.

Примеры:

  • оценить вероятность оплаты;
  • сравнить соседние периоды;
  • найти просадку;
  • подсказать перераспределение бюджета;
  • найти узкое место в воронке;
  • где у нас аномалии;
  • где просадка;
  • где мы теряем деньги;
  • что выглядит подозрительно;
  • какие сегменты провалились.

Что происходит:

  • бот запускает agent-а;
  • agent запрашивает нужные данные через безопасный query_data;
  • сравнивает строки, периоды и срезы;
  • возвращает рекомендации, данные и параметры запроса.

Чем отличается результат

  • Чем точнее формулировка, тем точнее agent выберет данные.
  • Чем шире вопрос, тем больше риск неполного или дорогого анализа.