用途:部署、运行、调试、拆除 RTVI-CV(metropolis_perception_app)2D 检测/追踪微服务,并驱动其 REST API。技能按用户意图分流为 DEPLOY(部署/拆除/调试)与 API USAGE(调用运行中实例)两条互斥流程,先在本文件路由表中匹配表述,再只加载一个对应参考文档。
主要能力:部署与操作本地 RTVI-CV 容器(含 tearing down、故障排查);调用 REST 接口,端口 9000,路径 /api/v1 下的 /live、/ready、/startup、/metrics、/stream/add、/stream/remove 及 embeddings 等;随附 scripts/ 下 23 个 bash 与 python 辅助脚本,如 load_defaults.sh、fetch_resources.sh、apply_config.sh、run_app_and_wait.sh、add_streams.sh、collect_metrics.sh、discover_streams.sh、calibration_manager.py 等,按名字从技能根目录调用。
必要用法:前置条件为 VSS 部署在 $HOST_IP 可达,NGC 凭据存于 $NGC_CLI_API_KEY 与 $NVIDIA_API_KEY,调用方具备 curl、jq、Docker。DEPLOY 流程有固定的启动契约与每步固定宽度方框输出、Step 6 菜单式后续操作要求;默认 stream_mode=static,仅在用户明确要求时才用 dynamic。
适用场景:仓库 2D 检测追踪部署、smartcity gdino、带 N 路流部署、停止容器、健康检查失败诊断、增删流、查看指标与 FPS、生成文本嵌入等。
限制:需要匹配的 VSS profile/微服务已部署且调用方可达;NGC 托管模型与 NIM 可能受速率限制、显存要求与许可限制;并发、显存与存储上限取决于主机硬件和 profile 的 compose 文件。镜像标签由部署时用户提供,具体硬件支持包括 x86/aarch64 dGPU(T4、A100、L40、H100、B200、RTX)、SBSA(Spark、Grace-Hopper)与 Jetson(Thor、Orin、Xavier)。