VSS 行为分析独立部署
指导你在不启动完整仓库栈的情况下独立部署和运行 VSS 行为分析服务。
文档明确说明NGC密钥处理、避免命令行明文传递、外部仓库登录及容器挂载风险,并限定为独立服务;但部署会修改Compose并拉取外部镜像,缺少明确的执行前确认、最小权限要求、回滚方案和敏感数据流完整说明,且许可证元数据为NOASSERTION,因此扣分。
入口、配置、校准、broker行为及多种故障现象均有较详细说明,包含诊断命令和失败反馈;但本次仅静态阅读,未见可核验的CI与覆盖关键路径的已提交测试执行证据,部分依赖路径和版本要求也较脆弱,因此按静态上限保守扣分。
名称、用途、触发语句、独立部署与完整栈的边界、入口选择和broker条件都较清楚;但未提供中文操作支持或大陆网络可达性评估,核心镜像和NGC认证依赖海外服务,且负面触发与环境差异覆盖有限,因此扣分。
文档采用概览、引用资料、工作流、故障排查和动态协议分层,声明版本3.2.0、作者、许可证和限制;但引用层级较深,author格式不完整,缺少明确维护责任、变更日志和更新流程,基准报告也显示存在质量与效率问题,因此扣分。
内容能够指导选择入口、挂载配置/校准、启动容器并处理动态更新,核心任务可直接执行;但实际Compose文件和完整依赖环境不在选定技能证据中,校准、broker及NGC条件会显著影响结果,评估仅有单个任务且Codex正确性和有效性各为50%,因此不超过静态中等分。
存在评估清单、基准报告、测试路径和协议细节,提供了一定审计线索;但只有一个评估任务、无负向任务,报告结果不能替代独立复现,未见本技能关键路径的可核验CI测试,因此证据覆盖薄弱。
- 执行会修改Compose部署状态并从nvcr.io拉取镜像;应在部署前确认目标主机、镜像来源、权限和回滚方式。
- 未配置broker时容器会因restart: always进入重启循环,并非稳定的空闲运行状态。
- NGC密钥属于敏感凭据,应通过会话或受管密钥注入,避免写入仓库、shell配置或日志。
- 动态校准无ACK,失败主要依赖容器日志;动态配置和校准的协议约束较严格,错误消息可能被丢弃。
- 未提供中文说明或大陆网络可达性证据,使用者需预先验证NGC及相关镜像服务的网络可用性。
这个 Skill 能做什么,适合哪些场景?
该技能面向需要单独运行 vss-behavior-analytics 服务的 VSS 用户。它指导用户选择入口点、配置来源和可选校准,并提供 Docker Compose 启动示例。服务需要 VSS 仓库目录、NGC 凭据、指定版本的 Docker 环境以及可用的 GPU 资源。连接消息代理后,还可以通过 mdx-notification 在运行时更新配置和校准,无需重启。
它检查并说明仓库目录、NGC API 密钥、Docker 版本和可选消息代理等前置条件;指导用户选择 2D、3D、mv3dt、dev_example 或 fusion_search 入口点,使用配置和校准文件;通过 Docker Compose 启动 vss-behavior-analytics-base 容器;说明如何探测 /docs 或 /health、处理 NGC 拉取认证失败和 GPU 内存不足;在消息代理可用时,指导发布动态配置和动态校准消息,并说明持久化、应用到工作进程和 ACK 行为。
- VSS 运维人员只想启动行为分析容器,而不部署完整 warehouse 栈时使用。
- 需要为 analytics 2D、3D、mv3dt、dev_example 或 fusion_search 选择入口点时使用。
- 需要加载自定义行为分析配置或校准 JSON 文件时使用。
- 已有运行中的服务和消息代理,需要在线修改配置或校准而不重新部署时使用。
这个 Skill 有哪些优点和局限?
- 专门覆盖 vss-behavior-analytics 的独立部署,不会把完整 warehouse 栈误作为目标。
- 支持 profile-shipped 或自定义配置和校准。
- 连接消息代理后支持运行时配置与校准更新,无需重启。
- 包含连接拒绝、NGC 认证和 GPU 内存不足等故障排查方向。
- 需要匹配的 VSS profile 或微服务已部署并可达。
- 需要 Docker、NGC 凭据、仓库目录和适合所选 profile 的 GPU 资源。
- 没有消息代理时,容器可能在重启循环中,动态更新不可用。
- 源材料提供了 Tier-3 评估命令,但没有提供实际测试结果或基准数据。
如何安装这个 Skill?
先安装 NVIDIA skills 集合:npx skills add nvidia/skills。也可以直接安装此技能:npx skills add nvidia/skills --skill vss-setup-behavior-analytics --yes。CLI 会提示选择技能和安装目标;源材料未规定具体目标目录。
如何使用这个 Skill?
让兼容的 Agent 执行例如“部署 behavior analytics standalone”或“运行 behavior-analytics,不启动完整栈”。独立启动示例:进入 <repo>/deploy/docker,设置 VSS_APPS_DIR=$(pwd),然后运行 docker compose -f services/analytics/behavior-analytics/compose.yml up -d vss-behavior-analytics-base。完整入口点、配置、校准和动态更新流程位于技能引用的 references 文档中。
这个 Skill 与同类方案有什么区别?
与完整 warehouse 部署相比,该技能只部署 vss-behavior-analytics 容器;需要 UI、agent 或 perception 的完整栈时,应转交 vss-deploy-profile。