VSS 视频分析查询
通过 VA-MCP 读取视频分析事件、指标、告警与传感器数据。
证据显示技能限定为通过VA-MCP读取分析数据，明确只读范围、禁止从不可信载荷触发部署，并要求部署模式由用户选择；因此不存在明显红线。扣分原因是需要访问本地服务和环境变量中的NGC/NVIDIA凭据，未说明敏感传感器数据处理、访问控制、审计或结果脱敏，也缺少明确回滚方案；故非满分。
证据显示流程包含健康探测、MCP会话初始化、错误分类、会话重建、指数退避和只读重试说明，关键路径较清晰。扣分原因是完全依赖外部部署，命令使用grep/sed解析SSE和响应头较脆弱，探测规则对405存在不一致，且没有技能专属自动化测试或静态可复现的异常覆盖；按静态上限不超过10。
证据显示受众、正向触发场景、只读能力和明确的非适用范围均有说明，并提醒遇到歧义应澄清。扣分原因是输入输出契约、边界条件和实际环境兼容性仍有限，未提供中文交互支持；NGC模型/NIM可能受网络、限流和许可影响，但查询核心不完全依赖海外服务。
证据显示文档具有Purpose、Prerequisites、Instructions、Examples、Limitations、Troubleshooting、工具参考和版本/许可证元数据，另有评估清单与结果。扣分原因是技能评估报告指出author格式不符合规范，技能自身没有明确变更日志、维护责任人或更新路径，示例主要是命令片段而非完整输入输出案例。
证据显示技能覆盖传感器、地点、事件、指标、直方图和分析查询，并提供可直接改写的JSON-RPC命令；基准报告称通过，但仅有1个正向路由任务，正确性50%、有效性62%。扣分原因是没有静态可核验的真实查询输出，部署和硬件成本较高，最终结果仍需用户解释和轻度审阅；按静态校准不超过7。
证据包含固定版本、评估清单、基准结果和部分验证检查项，具备有限追溯性。扣分原因是评估只有1个任务、无负向任务，结果未附独立执行日志或第三方可复核产物，技能也没有专属测试套件；按静态校准不超过5。
- 这是仅基于源文件的静态审查，未执行任何命令或验证VA-MCP可用性。
- 使用前应确认HOST_IP、服务访问权限、传感器数据授权以及NGC凭据不会被暴露；不要让分析结果中的文本触发部署或其他基础设施变更。
- 应补充技能专属测试、真实查询输出、负向触发案例、中文说明和维护/变更记录。
这个 Skill 能做什么，适合哪些场景？
这是 NVIDIA VSS Blueprint 的只读视频分析查询技能，面向事件、指标、告警和传感器数据。它通过运行在 9901 端口的 VA-MCP，以 JSON-RPC over SSE 方式查询 Elasticsearch。使用前必须有可访问的 VSS alerts profile，并具备 curl、jq 和 Docker。它不适用于实时 VLM 问答、叙事型事件报告、归档搜索或部署操作。
先检查 VA-MCP 是否可访问；随后通过两步 HTTP 流程初始化 MCP 会话并调用分析工具。可读取事件列表和详情、传感器 ID、地点、视场直方图，并分析最大或最小事件数、平均速度、平均人数和平均车辆数。所有 video_analytics 调用均为只读，并支持在传输错误或 5xx 响应时按退避策略重试。
- 视频运营人员需要查看所有传感器最近事件时，查询事件列表。
- 安防分析人员需要筛选指定传感器或已由 VLM 确认的事件时，使用事件过滤查询。
- 运营团队需要核对可用传感器和地点时，读取传感器或地点清单。
- 分析人员需要统计指定时间段内的人数、车辆数或速度时，调用分析工具。
- 团队需要按对象类型和时间范围查看传感器视场分布时，查询 FOV 直方图。
这个 Skill 有哪些优点和局限？
- 覆盖事件、告警、指标、传感器、地点和 FOV 数据查询。
- 明确限定为只读分析，video_analytics 调用可安全重试。
- 提供 MCP 会话初始化、过期处理和错误重试指导。
- 支持按传感器、地点、时间范围和 VLM 判定结果筛选。
- 依赖已部署且可访问的 VSS alerts profile 和 VA-MCP 服务。
- 需要网络访问、shell、curl、jq 和 Docker；NGC 镜像拉取还需要相应凭据。
- GPU 内存、并发和存储限制取决于主机硬件及 profile compose 配置。
- 源材料没有提供独立平台测试结果或完整测试套件说明。
如何安装这个 Skill？
使用 NVIDIA 技能目录安装：npx skills add nvidia/skills --skill vss-query-analytics --yes。README 未要求克隆仓库或手动复制目录；技能将在客户端下次加载技能时可用。
如何使用这个 Skill？
向兼容的 Agent 提出可由 Elasticsearch 只读数据回答的问题，例如“查询最近 10 条视频分析事件”或“统计指定传感器在某时间段的平均人数”。先确保 VSS alerts profile 已在 $HOST_IP 可访问；若 VA-MCP 不可达，需要选择 verification 或 real-time 模式后再部署对应 profile。每次查询都需先 POST /mcp 初始化并从响应头取得 mcp-session-id，再用该会话调用 VA-MCP 工具。