Как запрашивать PostHog с помощью ИИ и проверять результат
Запрашивайте данные о событиях PostHog через Leina в чате, избегайте типичных ошибок с метриками и сверяйте дневные значения, границы времени и итоги за период с исходными данными.
Попросить ИИ-агента в командном чате «построить график использования нашей новой функции за эту неделю» звучит просто. Но аналитические запросы подвержены тонким ошибкам: путаница между общим числом кликов по событию и уникальными активными пользователями, разбивка по дням в UTC вместо местного часового пояса вашей команды или восприятие половины сегодняшних неполных данных как внезапного «падения использования».
С Leina вы можете запрашивать аналитику PostHog прямо из Slack или командного чата. Чтобы результат вызывал доверие, запрашивайте исходные дневные данные вместе с визуальным графиком и сравнивайте результат с вашей панелью PostHog, прежде чем вставлять его в презентацию или еженедельный обзор.
Начните с события, которое ваша команда уже использует в отчёте, чтобы у вас было готовое сравнение с источником.
Определите параметры метрики перед запросом
Расплывчатые запросы вроде «Насколько активно использовалась эта функция?» приводят к неоднозначным графикам. Перед формированием запроса определите эти ключевые параметры:
| Параметр | Что указать | Почему это важно |
|---|---|---|
| Проект | Название подключённого проекта PostHog | Определяет источник данных; для production и staging также могут потребоваться отдельные фильтры. |
| Имя события | Точный идентификатор события (например, billing_upgrade_clicked) | Позволяет избежать запроса устаревших или неправильно написанных пользовательских событий. |
| Мера | Общее число срабатываний или Уникальные пользователи | Срабатывания измеряют объём событий; уникальные пользователи считают людей, которые их вызвали. Указывает ли это на adoption, зависит от события. |
| Диапазон дат и часовой пояс | Явные метки начала/конца и часовой пояс отчётности (например, America/Los_Angeles) | Не даёт событиям около полуночи смещаться в соседние дни. |
| Фильтры | Окружение, тестовые аккаунты или конкретные свойства пользователей | Определяет, какие записи включать; используйте фильтры, соответствующие вашим фактическим свойствам событий. |
| Неполные дни | Исключить сегодняшний день или пометить его как неполный | Не даёт неполному дню выглядеть как тревожное падение. |
Запрашивайте табличные значения вместе с визуальным графиком
При запросе в чате всегда просите и дневную сводную таблицу, и график. Визуальным графиком легко поделиться, но именно таблица данных позволяет проверить расчёты.
Скопируйте и адаптируйте этот запрос в подключённом чате:
В нашем подключённом проекте PostHog
[project]рассчитай [общее число срабатываний / уникальных пользователей] для[event_name]с[start timestamp]по[end timestamp].
- Часовой пояс: Используй
[timezone]для границ дней.- Фильтры: Примени
[e.g. environment = production, exclude internal staff].- Формат: Верни и дневную таблицу данных, и визуальную столбчатую диаграмму.
- Метаданные: Укажи проект, меру, окно отчётности, точные фильтры и время получения данных. Включи запрос или ссылку на источник, если доступно; иначе приведи условия, которые я могу воспроизвести.
- Неполные даты: Помечай даты, которые ещё не завершены в часовом поясе отчётности.
- Пробелы в получении данных: Сообщай об отсутствующих или неполных данных отдельно от подтверждённых нулевых значений.
Выполняй только операции чтения.
Подключите аккаунт, который может читать целевой проект PostHog, через Connections. Если вы используете Slack, руководство по Slack (English) описывает настройку чата. Руководство PostHog по инсайтам объясняет, какие типы анализа подходят для разных вопросов.
Проверьте одну дату, затем всё окно
Прежде чем вставлять график в отчёт для руководства, проверьте числа по PostHog с помощью этих двух проверок:
1. Выборочно проверьте одну завершённую дату в PostHog
Откройте PostHog Insights в браузере, настройте то же событие и фильтры для одного завершённого дня (например, прошлой среды) и сравните счётчик с таблицей агента. Совпадение — полезная первая проверка. Оно не подтверждает весь запрос: разные фильтры могут дать одинаковый счётчик за один день. Затем сравните всё окно отчётности, включая записи около начальной и конечной границ, и убедитесь, что оба запроса используют один и тот же проект, меру, часовой пояс и фильтры.
2. Проверьте расчёт общего числа и уникальных пользователей
- Общее число срабатываний аддитивно: Если вы запрашивали общий объём событий, дневные строки, покрывающие всё окно без пересечений, должны в сумме давать итог за период, когда оба запроса используют одну и ту же область и одни и те же исходные данные.
- Уникальные пользователи не аддитивны: Пользователь, активный и в понедельник, и во вторник, учитывается один раз в дневной корзине понедельника и один раз в дневной корзине вторника, но только один раз в итоге за несколько дней.
Следующие значения приведены для примера:
| День | Срабатывания событий (аддитивно) | Уникальные пользователи (не аддитивно) |
|---|---|---|
| Понедельник | 4 события | 2 пользователя (Alice, Bob) |
| Вторник | 3 события | 2 пользователя (Alice, Charlie) |
| Итог за два дня | 7 событий (4 + 3) | 3 пользователя (Alice, Bob, Charlie) |
Если агент сообщает итог уникальных пользователей за несколько дней, просто складывая дневные значения уникальных пользователей, расчёт неверен.
Быстрая диагностика несовпадающих чисел
Когда числа в чате не совпадают с тем, что вы видите в интерфейсе PostHog, используйте эти проверки, чтобы сузить различие:
| Симптом | Первопричина для проверки |
|---|---|
| Все дневные счётчики стабильно ниже | Проверьте, включена ли в PostHog фильтрация внутренней команды или исключение ботов, но пропущена в запросе (или наоборот). |
| Пики и провалы сдвинуты на один день | Сравните часовой пояс и границы дней, используемые в каждом запросе. |
| Резкое падение в последний день | Проверьте, был ли день завершён на момент выполнения запроса. Если был, исследуйте изменение, а не предполагайте неполные данные. |
| Пропущенные даты в середине диапазона | Проверьте, подтверждает ли источник ноль событий или запрос вернул неполные данные. |
| Исторические числа изменились по сравнению с прошлой неделей | Проверьте наличие поздно пришедших событий, бэкфиллов или изменений фильтров и исходных записей. |
Вы можете использовать рабочий лист для проверки графика PostHog, чтобы записать параметры запроса и заметки о разрешении расхождений.
Отделяйте наблюдаемые метрики от гипотез
Например, используя вымышленные числа, отчёт может разделять такие утверждения:
- Наблюдаемое изменение: «Клики по кнопке оформления заказа выросли на 34% с понедельника по четверг.»
- Гипотеза: «Релиз мобильного приложения v2.4 во вторник может быть связан с этим. Сравните затронутых пользователей с другими сегментами и проверьте изменения в трекинге; одно это сравнение не установит причинно-следственную связь.»
После проверки запроса вы можете попросить Leina выполнять его по расписанию. Укажите часовой пояс и место доставки, затем проверьте первый результат по расписанию. Перепроверяйте запрос при изменениях инструментации или фильтров; повторяющееся выполнение не заменяет проверку.
PostHog также предлагает собственные возможности ИИ-анализа. Выберите рабочий процесс, подходящий к тому, где работает ваша команда, и сохраняйте условия источника вместе с любым графиком, которым делитесь.