自动化与运维 ✓ NVIDIA · 官方 docker-composevideo-analyticsbehavior-analyticsngckafkaruntime-configuration

VSS 行为分析独立部署

指导你在不启动完整仓库栈的情况下独立部署和运行 VSS 行为分析服务。

FollowSkills 评估 · FSRS-2.0
不推荐
51/ 100 五分制 2.6 / 5
信任安全14 / 25 · 2.8/5

文档明确说明NGC密钥处理、避免命令行明文传递、外部仓库登录及容器挂载风险,并限定为独立服务;但部署会修改Compose并拉取外部镜像,缺少明确的执行前确认、最小权限要求、回滚方案和敏感数据流完整说明,且许可证元数据为NOASSERTION,因此扣分。

可靠稳定8 / 20 · 2.0/5

入口、配置、校准、broker行为及多种故障现象均有较详细说明,包含诊断命令和失败反馈;但本次仅静态阅读,未见可核验的CI与覆盖关键路径的已提交测试执行证据,部分依赖路径和版本要求也较脆弱,因此按静态上限保守扣分。

适用触发10 / 15 · 3.3/5

名称、用途、触发语句、独立部署与完整栈的边界、入口选择和broker条件都较清楚;但未提供中文操作支持或大陆网络可达性评估,核心镜像和NGC认证依赖海外服务,且负面触发与环境差异覆盖有限,因此扣分。

规范维护10 / 15 · 3.3/5

文档采用概览、引用资料、工作流、故障排查和动态协议分层,声明版本3.2.0、作者、许可证和限制;但引用层级较深,author格式不完整,缺少明确维护责任、变更日志和更新流程,基准报告也显示存在质量与效率问题,因此扣分。

有效结果6 / 15 · 2.0/5

内容能够指导选择入口、挂载配置/校准、启动容器并处理动态更新,核心任务可直接执行;但实际Compose文件和完整依赖环境不在选定技能证据中,校准、broker及NGC条件会显著影响结果,评估仅有单个任务且Codex正确性和有效性各为50%,因此不超过静态中等分。

证据核验3 / 10 · 1.5/5

存在评估清单、基准报告、测试路径和协议细节,提供了一定审计线索;但只有一个评估任务、无负向任务,报告结果不能替代独立复现,未见本技能关键路径的可核验CI测试,因此证据覆盖薄弱。

证据充分度: 评估于 2026年7月20日 审查版本 55f18499943e
使用前请注意
  • 执行会修改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 行为。

  1. VSS 运维人员只想启动行为分析容器,而不部署完整 warehouse 栈时使用。
  2. 需要为 analytics 2D、3D、mv3dt、dev_example 或 fusion_search 选择入口点时使用。
  3. 需要加载自定义行为分析配置或校准 JSON 文件时使用。
  4. 已有运行中的服务和消息代理,需要在线修改配置或校准而不重新部署时使用。

这个 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。

常见问题

是否必须部署完整 VSS warehouse 栈?
不需要。该技能的目标是独立部署行为分析服务;但匹配的 VSS profile 或微服务仍需已部署并可被调用方访问。
消息代理是强制要求吗?
不是。容器可以在没有 Kafka、Redis Streams 或 MQTT 时启动,但 Kafka 客户端会有限次重试,随后应用退出并由 restart: always 循环重启;动态更新需要可达的消息代理。
运行需要哪些凭据和资源?
需要设置 NGC_CLI_API_KEY 以拉取镜像,并使用 Docker Engine 28.3.3 与 Docker Compose plugin v2.39.1+。GPU 内存、并发和存储限制取决于主机硬件与 profile compose 文件。
这个技能是否定义了商业费用?
源材料没有说明费用;它只提醒 NGC 托管模型和 NIM 可能受到速率限制、GPU 内存要求和许可限制。

同仓库的其他 Skills

均来自 NVIDIA/skills

自动化与运维 ✓ NVIDIA · 官方

VSS 视频分析 API 独立部署

帮助运维人员独立部署并验证 VSS 视频分析 REST API。

自动化与运维 ✓ NVIDIA · 官方

VSS 视频嵌入部署技能

部署并运维支持文件、文本和实时视频流的 NVIDIA 视频嵌入服务。

自动化与运维 ✓ NVIDIA · 官方

AutoMagicCalib 校准栈启动器

通过 Docker Compose 部署 AutoMagicCalib 微服务与 Web UI,快速启动摄像头自动标定环境。

自动化与运维 ✓ NVIDIA · 官方

RT-VLM 视频密集描述部署

部署并调用 NVIDIA RT-VLM 微服务,为视频片段生成密集描述并管理实时流。

自动化与运维 ✓ NVIDIA · 官方

VSS 多摄像头三维检测追踪部署

部署基于 DeepStream 与 BEV Fusion 的多摄像头三维感知服务。

自动化与运维 ✓ NVIDIA · 官方

RTVI-CV 二维检测跟踪运维技能

部署并运维 RTVI-CV 二维视频检测与跟踪微服务。

自动化与运维 ✓ NVIDIA · 官方

VSS 视频分析报告

为单个视频片段或事件时间范围生成结构化的视频分析报告。

数据与分析 ✓ NVIDIA · 官方

VSS 视频分析查询

通过 VA-MCP 读取视频分析事件、指标、告警与传感器数据。

开发与工程 ✓ NVIDIA · 官方

NVIDIA DeepStream 开发技能

为 Python pyservicemaker 驱动的 DeepStream 视频分析流水线提供可靠开发指导。

自动化与运维 ✓ NVIDIA · 官方

VSS 配置文件部署助手

为 NVIDIA 视频搜索与摘要蓝图选择、部署并验证 Compose 配置文件。

自动化与运维 ✓ NVIDIA · 官方

NVIDIA AI-Q 部署助手

部署、验证和运维 NVIDIA AI-Q Blueprint 基础设施。

自动化与运维 ✓ NVIDIA · 官方

Holoscan NGC 容器安装助手

通过 NGC Docker 容器安装、验证并启动 NVIDIA Holoscan SDK。

开发与工程 ✓ NVIDIA · 官方

DeepStream SOP 合规推理服务

帮助构建和调试基于 GPU 的工业视频 SOP 顺序与合规检测服务。

开发与工程 ✓ NVIDIA · 官方

DeepStream 性能剖析器

用实测数据调优 DeepStream 管线并定位性能瓶颈。

自动化与运维 ✓ NVIDIA · 官方

NVIDIA RAG Blueprint 运维技能

帮助代理部署、配置、排障和管理 NVIDIA RAG Blueprint。

数据与分析 ✓ NVIDIA · 官方

Hugging Face 本地 GPU 微调助手

在本地 NVIDIA GPU 上,以可复现流程微调 Hugging Face 模型。

开发与工程 ✓ NVIDIA · 官方

NeMo Relay 插件构建指南

帮助将可复用的 NeMo Relay 运行时行为封装为可配置插件。

开发与工程 ✓ NVIDIA · 官方

DOCA 版本一致性助手

帮助验证 DOCA 版本来源、主机与 BlueField 的一致性,并诊断构建与运行时版本漂移。

数据与分析 ✓ NVIDIA · 官方

Cosmos-Embed 视频检索与微调技能

用 Cosmos-Embed1 将视频与文本嵌入用于检索和微调。

自动化与运维 ✓ NVIDIA · 官方

VIOS 视频输入输出与存储管理

通过 VIOS REST API 管理传感器、视频流、录制、快照和视频存储。

相关 Skills