用途:当用户说“给我看这个错误的回放”或“为 issue X 找一段录像”时,从大量关联会话中挑出最能展示错误成因的一段,而非任意关联会话。
主要能力与工具:使用 posthog:query-error-tracking-issue 获取问题详情(指纹、状态、数量);用 posthog:execute-sql 查询异常事件找出关联会话;用 posthog:query-session-recordings-list 获取候选会话元数据;用 posthog:session-recording-get 获取所选录像详情;用 posthog:vision-observations-list、posthog:vision-scanners-list、posthog:vision-scanners-scan-session 处理 Replay Vision AI 摘要。
使用方式:先取 issue 详情并记录指纹;再执行 SQL 查询 $exception 事件,按 $exception_fingerprint 过滤,取最近 30 天、最多 20 个候选会话;随后过滤掉 10 秒以下和 1 小时以上的会话,按 2-15 分钟时长、活跃时间占比高于 0.3、activity_score 高、较新等标准排序;选定后获取完整详情,向用户展示链接、选择理由、错误前上下文和错误出现次数。如需 AI 摘要,采用“先检查再扫描”,先看是否已有 summarizer 观察,若无则查找 summarizer 扫描器并异步扫描,轮询直到成功。
适用场景与限制:适合错误问题已有关联回放、需要快速定位有用录像的排查工作。候选会话少于 3 个时可跳过排序;若候选均短于 10 秒,说明错误可能立即崩溃页面;若 $session_id 大量为空,可能未启用会话回放。Replay Vision 没有单次调用的 focus 参数,摘要焦点取决于扫描器自身提示词。相关技能包括 investigating-error-issue、investigating-replay、diagnosing-missing-recordings。