VSS 视频分析 API 独立部署
帮助运维人员独立部署并验证 VSS 视频分析 REST API。
文档明确要求交互式读取NGC_CLI_API_KEY、避免提交或记录密钥，并披露Elasticsearch、Kafka、NGC和Docker数据流；但使用host网络、长期高权限NGC凭据，且缺少明确的执行前确认、最小权限说明和完整回滚方案，因此扣分。
路由、前置条件、配置选项、健康检查和故障排查基本一致；但本次仅静态阅读，未执行关键路径，测试覆盖有限，Kafka配置与无Kafka场景仍可能造成运行时失败，因此不超过静态上限并扣分。
触发语句、适用场景和不适用的完整warehouse部署边界清楚，也说明了Elasticsearch必需、Kafka可选；但未提供中文交互或中国大陆网络可达性分析，NGC和相关文档可达性存在环境不确定性，因此扣分。
文档分层较好，包含配置、部署、故障排查、限制、版本3.2.0、Apache-2.0和维护来源；但Benchmark指出引用嵌套较深，作者格式不符合检查要求，且没有清晰的变更日志、维护责任人和更新流程；仓库许可证元数据为NOASSERTION，也增加治理不确定性。
技能提供可直接改用的Docker Compose命令、配置路径、依赖启动和livez验证，并有一项正向评测报告；但报告仅覆盖一个任务且未在本次审查中复现，输出仍依赖用户环境、凭据和外部服务，实际结果完整性只能部分确认。
存在提交的evals、期望行为、benchmark结果和静态校验摘要，提供了一定审计线索；但只有一个正向任务、无负向触发覆盖，也没有可由本次静态审查确认的CI和完整测试套件，因此证据有限。
- 执行前确认Docker Compose操作、host网络暴露、Elasticsearch/Kafka连接和数据目录权限；不要在无审查情况下使用长期NGC密钥。
- service-shipped配置默认启用Kafka；无Kafka部署应明确切换为空brokers配置，否则Kafka相关功能会失败。
- 本评估未执行命令，且未验证NGC镜像、Docker版本、外部文档或中国大陆网络可达性。
这个 Skill 能做什么，适合哪些场景？
该技能用于独立部署 vss-video-analytics-api REST 服务，而不是完整的 VSS warehouse 栈。它指导用户选择配置来源、设置数据日志挂载，并连接必需的 Elasticsearch 与可选 Kafka。技能还覆盖容器启动、健康检查、REST API 路由和常见故障排查。使用前需要准备 VSS 仓库、NGC 凭据、Docker，以及可访问的 Elasticsearch。
指导代理使用 NVIDIA skills CLI 安装该技能；检查 VSS 仓库路径、NGC_CLI_API_KEY、Docker 版本和 Elasticsearch 可达性；创建数据日志目录并运行 Docker Compose；通过 /livez、/docs 或 /health 验证服务；根据需要配置 Kafka，并说明动态配置、动态校准和 RTLS/AMR 功能的 Kafka 依赖；在连接拒绝、NGC 权限错误或容器 OOM 时提供排查方向。
- 需要只运行视频分析 REST API、而不部署完整 warehouse 栈的 VSS 运维人员。
- 需要使用自定义 video-analytics-api 配置或更换 Elasticsearch、Kafka 地址的部署人员。
- 希望在不使用 Kafka 的情况下启动 API，并接受 Kafka 相关功能暂不可用的用户。
- 需要通过 REST API 管理配置、校准数据，或访问 RTLS/AMR 数据的 VSS 操作人员。
这个 Skill 有哪些优点和局限？
- 明确限定为 video-analytics-api 的独立部署，避免误用于完整 warehouse 栈。
- 覆盖配置来源、数据日志挂载、Elasticsearch、可选 Kafka、验证和故障排查。
- 提供可执行的 Docker Compose 启动命令和健康检查命令。
- 说明动态配置、动态校准及 RTLS/AMR 的 Kafka 运行时依赖。
- 必须使用指定的 Docker Engine 和 Compose 版本要求，并准备 NGC 凭据。
- Elasticsearch 是硬性依赖；Kafka 虽可选，但多个功能在无 Kafka 时不可用。
- 需要匹配的 VSS profile 或微服务可被调用方访问，不能替代完整栈部署。
- 提供的材料没有展示平台矩阵、自动化测试结果或性能基准。
如何安装这个 Skill？
使用 NVIDIA skills CLI 安装：npx skills add nvidia/skills --skill vss-setup-video-analytics-api --yes。也可以使用 --agent codex、--agent claude-code 等参数指定客户端。仓库 README 未规定该技能的手工安装目录；CLI 会提示安装目标。
如何使用这个 Skill？
向兼容的代理提出“deploy video analytics api”或“run video-analytics-api standalone”。典型启动步骤是：设置 VSS_APPS_DIR 指向仓库的 deploy/docker 目录；设置并安全加载 NGC_CLI_API_KEY；准备可写的 VSS_DATA_DIR；确认 Docker Engine 28.3.3、Compose v2.39.1+ 和 Elasticsearch；然后运行 docker compose -f services/analytics/video-analytics-api/compose.yml up -d vss-video-analytics-api，并用 curl -sf http://localhost:8081/livez 检查服务。完整配置字段、端点表和部署流程位于 references/ 中。
这个 Skill 与同类方案有什么区别？
相较于 vss-deploy-profile 的 warehouse 或 alerts 完整栈部署，该技能只部署 vss-video-analytics-api 容器，不包含 UI、agent 或 perception。若目标是行为创建或事件检测，应改用 vss-setup-behavior-analytics。