SuperAPI AI 工具集

creating-replay-vision-scanners

编程与开发

查看项目

更新于 10-16 03:45

技能介绍

用途:指导智能体在 PostHog 中创建并合理控制规模的 Replay Vision 扫描器。扫描器是对会话录像持续运行的 LLM 探针,启用后按 Temporal 调度每 5 分钟扫描新匹配录像,结果记为 observation($recording_observed 事件),按模型消耗积分(1 积分 = $0.01)。创建本身不校验配额,超支保护只在观测时生效,因此必须先估算规模。

主要能力:支持四种 scanner_type——monitor(开放式观察)、classifier(固定标签分类)、scorer(按评分标准打分)、summarizer(自由文本摘要,始终启用嵌入)。类型创建后不可更改,需删除重建。查询使用 RecordingsQuery 选择目标会话,date_from/date_to 被忽略;可用 sampling_mode(focused/balanced/comprehensive)与 sampling_rate(0..1)缩小范围。模型为 Google/Gemini:gemini-3.5-flash-lite(2 积分)、gemini-3-flash-preview(5 积分,默认)、gemini-3.8-flash(15 积分)。

使用方式:先确定类型与 scanner_config,再写查询;创建前调用 vision-scanners-estimate 估算月度积分,并用 vision-quota-get 查看剩余额度,按剩余天数折算后与用户确认,再调用 vision-scanners-create。可设 enabled:false 先暂停创建,或设 credit_limit 限制单扫描器每周期花费。emits_signals:true 可把发现推入 Signals 收件箱。创建后结果需数分钟出现,用 vision-scanners-observations-list 或 vision-observations-list 查看。历史录像需另行用 vision-scanners-backfills-estimate 与 vision-scanners-backfills-create 回填。更新用 vision-scanners-update(部分更新),扩大范围或提高价格时需重新估算。

适用场景:需要自动监控未来录像(如发现愤怒点击、分类、打分、摘要)时使用;若只针对已知会话提问,应改用 inline scan,而非创建后删除的临时扫描器。

限制:每个(扫描器, 会话)只产生一条 observation,重跑为无操作;observation 可能为 ineligible(如 too_short、no_recording),需查 error_reason;当前版本仅支持 Google/Gemini 提供商与模型;预算耗尽时定时观测被静默跳过,按需扫描被直接拒绝。