如何用 AI 查询 PostHog，并核对分析结果
在聊天中通过 Leina 查询 PostHog 事件数据，明确指标与时区，并对照来源核验每日数值、时间边界和统计周期总量。
在团队聊天中，让 AI “画出本周新功能的使用情况”看起来很简单。实际查询却容易混淆事件次数与去重用户数、按 UTC 划分日期而忽略团队时区，或把今天尚未完整的数据解释成使用量骤降。
通过 Leina，可以在 Slack 或团队聊天中查询 PostHog 数据。为了核对结果，应同时索取图表和每日明细，并对照 PostHog 中的来源检查，再放进演示文稿或周报。
第一次可以选择团队已经用于报告的事件，方便找到对照依据。
查询前明确指标参数
“这个功能用了多少次？”这样的请求容易产生歧义。先明确下面的参数：
| 参数 | 需要说明什么 | 为什么需要 |
|---|---|---|
| 项目 | 已连接的 PostHog 项目名称 | 确定数据来源；生产与测试环境可能还需要单独筛选 |
| 事件名称 | 准确的事件标识，例如 billing_upgrade_clicked | 避免查询已停用或拼写错误的自定义事件 |
| 统计指标 | 事件总次数或去重用户数 | 次数表示事件发生量，去重用户数表示触发事件的人数；是否能说明功能采用情况，还取决于事件含义 |
| 日期范围与时区 | 明确的起止时间戳及统计时区，例如 America/Los_Angeles | 避免午夜附近的事件被分到相邻日期 |
| 筛选条件 | 环境、测试账号或用户属性 | 确定纳入哪些记录；条件应匹配实际事件属性 |
| 未完整日期 | 排除今天，或明确标注尚未完整 | 避免把一天的部分数据理解为异常下降 |
同时索取图表与每日明细
查询时，要求返回每日数据表和图表。图表便于分享，明细则便于核对计算。
可以在已接入 Leina 的聊天中复制并修改下面的请求：
在已连接的 PostHog 项目
[项目]中，统计[起始时间戳]到[结束时间戳]的[事件名称]，指标为**[事件总次数 / 去重用户数]**。
- 时区： 使用
[时区]划分每日边界。- 筛选条件： 应用
[例如：environment = production，排除内部员工]。- 输出： 同时返回每日数据表和可视化柱状图。
- 查询信息： 说明项目、指标、统计窗口、准确的筛选条件和获取时间。能够获取时，附查询或来源链接；否则提供我可以复现的条件。
- 未完整日期： 标注在统计时区中尚未结束的日期。
- 获取缺口： 将缺失或未完整获取的数据，与已经确认的零次数分开说明。
只执行读取操作。
在连接中授权能够读取目标 PostHog 项目的账号。使用 Slack 时，可以参考 Slack 接入指南。PostHog 的分析指南介绍了不同分析类型适合回答的问题。
先检查一天，再核对整个窗口
把图表放入团队报告前，按下面两步与 PostHog 对照：
1. 抽查一个已经结束的日期
在浏览器中打开 PostHog Insights，选择一个完整日期，例如上周三，并设置相同的事件和筛选条件，比较计数与 Agent 返回的每日明细。
一天的数值相符，可以作为初步检查，但不同筛选条件也可能在某一天得到同样的数值。还需要核对整个统计窗口，包括起止边界附近的记录，并确认两次查询使用相同的项目、指标、时区和筛选条件。
2. 核对总次数与去重用户数的计算
- 事件总次数可以相加： 每日区间覆盖整个窗口且没有重叠，并使用相同范围和底层数据时，每日事件次数的和应与周期总量一致。
- 每日去重用户数不能直接相加： 同一用户周一和周二都活跃，会分别计入两天，但在两天合计的去重结果中只计一次。
以下为示例数值：
| 日期 | 事件次数（可相加） | 去重用户数（不可直接相加） |
|---|---|---|
| 周一 | 4 次事件 | 2 位用户（Alice、Bob） |
| 周二 | 3 次事件 | 2 位用户（Alice、Charlie） |
| 两天合计 | 7 次事件（4 + 3） | 3 位用户（Alice、Bob、Charlie） |
如果 Agent 用每日去重用户数的简单求和，作为整个周期的去重用户总数，就需要修正这个计算。
数值不一致时怎样排查
聊天结果与 PostHog 界面不一致时，可以用这些检查缩小范围：
| 现象 | 需要检查的原因 |
|---|---|
| 每日计数持续偏低 | 核对 PostHog 与查询是否一致排除了内部员工或机器人 |
| 峰谷整体错开一天 | 比较两次查询的时区与每日边界 |
| 最后一天明显下降 | 检查查询时这一天是否已经结束；如果日期完整，应继续调查变化 |
| 统计窗口中间缺少日期 | 确认来源表示零事件，还是查询返回的数据不完整 |
| 历史数值与上周记录不同 | 检查延迟到达的事件、数据回补、筛选条件及来源记录是否变化 |
可以使用 PostHog 图表核验表记录查询条件和排查结果。
分开记录观察结果与待验证解释
例如，一份报告可以使用以下虚构数值分别描述观察与假设：
- 观察到的变化： “结账按钮点击次数从周一到周四增加了 34%。”
- 待验证的解释： “周二发布的 v2.4 移动端版本可能与此有关。需要比较受影响用户与其他群体，并核对埋点是否变化；仅有这次比较还不能确定因果关系。”
查询检查完成后，可以让 Leina 定期运行，说明时区和交付位置，并检查第一次定期结果。埋点或筛选条件改变时，应重新核对查询；定期执行仍需要检查统计口径。
PostHog 也提供自己的 AI 分析能力。选择适合团队工作位置的流程，并在分享图表时保留来源条件。