用途:当用户询问“这个会话里发生了什么”或给出录制/会话 ID 需要调查时,一次性汇总相关上下文,而不是让用户逐项索取。
主要能力:通过 posthog:session-recording-get 获取录制元数据(时长、计数、状态、distinct_id);posthog:persons-retrieve 获取用户画像;posthog:execute-sql 查询同会话事件、异常与页面浏览;posthog:query-error-tracking-issues-list 查找关联错误追踪问题;Replay Vision 相关工具可检查已有 AI 摘要或生成新摘要。
使用方式:录制 id 与事件 $session_id 相同。先用 session-recording-get 取元数据与 distinct_id,再用 persons-retrieve 取画像;用 execute-sql 按 $session_id 查询事件时间线,必要时筛选 $pageview、$pageleave、$autocapture、$exception、$rageclick。若查不到事件,可按 person_id 与录制时间窗口(前后各 100 秒)找回候选 session_id,仅在明确匹配时继续。有控制台错误或异常时,按 $exception_fingerprint 聚合,再用 query-error-tracking-issues-list 搜索对应问题。最后按“谁、做了什么、问题、关联问题、上下文”组织成连贯叙述。
可选 AI 摘要:遵循“先检查再扫描”。先用 vision-observations-list 查看是否已有成功摘要,有则用 vision-observations-retrieve 读取完整结果,无需新扫描。需要生成时用 vision-scanners-inline-scan-create,传入指定 prompt 与 scanner_config(length 为 medium),不要指定 model;该操作异步、耗时数分钟,400 通常表示组织尚未批准 AI 数据处理。读取 results[0].scan_outcome:started 则轮询,already_scanned 则读取已有结果,null 或 skipped_quota 则报告配额、不要轮询。仅当用户想用已保存扫描器自身 prompt 时才用 vision-scanners-list 与 vision-scanners-scan-session;不要为单个问题创建扫描器。
适用场景:会话回放调查、异常与错误追踪关联分析、用户行为时间线梳理。
限制:步骤 1-3 可并行;事件极少说明会话很短,应如实说明;控制台错误数为 0 可跳过错误追踪步骤;person 为 null 表示匿名用户,无画像属性但事件仍可用。资料未提供收费、价格与平台支持信息。