SuperAPI AI 工具集

session-replay

数据与分析

查看项目

更新于 10-15 20:09

技能介绍

用途:该技能面向 Analytics 模板中的会话回放(session replay),用于检查、排查和扩展录制,涉及 /sessions 页面、回放摄取与回放存储,以及智能体对浏览器录制的问答。

主要能力:回放摄取写入 session_recordings 与 session_replay_chunks;UI 与智能体通过 list-session-recordings、get-session-replay-summary、get-session-replay-events 读取。/sessions/:recordingId 以 session_recordings.id 为键,而非 analytics_events.session_id。录制时核心客户端会补丁 console、window error/unhandledrejection、fetch 与 XHR,发出带 agent-native.console 和 agent-native.network 标签的 rrweb 自定义事件;摄取时 deriveReplaySignals 计算 errorCount。

使用方式:排查用户报告的问题时,在 /sessions 搜索用户邮箱找到录制,打开 /sessions/:recordingId 并点击 Copy for agent 生成两小时令牌链接;智能体先读 agent-context.json 的 diagnostics 与时间线标记,再按需查询 agent-diagnostics.json 与 agent-events.json。人类可在回放播放器的 Dev Tools 面板中按 Console/Network 行跳转定位。

限制:不得向浏览器或智能体暴露对象存储 URL 或原始 session_replay_chunks 行;回放字节须经校验访问权限的服务端辅助函数。SQL 内联块仅作本地/开发回退,生产应使用私有或加密 blob 存储。本地应用连生产库需设置 ANALYTICS_SECRETS_ENCRYPTION_KEY,不要替换 BETTER_AUTH_SECRET。不要为让智能体检查而公开录制,应使用令牌化链接。请求体与请求头从不捕获;仅 5xx 响应体捕获有界脱敏片段。每会话预算为 1000 条 console 事件与 2000 条 network 事件。回放默认对已登录托管用户开启,采样率 100%,无第一方分析密钥或本地开发时不自动开启;输入默认掩码,可用 .an-mask、.an-block 等标记敏感区域。播放器须等所有分块完成后再构建 rrweb Replayer,事件原样传入,不得改写 href、src、_cssText 等,也不得添加视口钳制或指针坐标投影。