用途:部署、调试、运行和拆除 RTVI-CV(Real Time Video Intelligence CV)2D 检测/跟踪微服务,并驱动其 REST API。技能按用户意图路由到 DEPLOY、TEARDOWN、DEBUG 或 API USAGE 流程,每次只加载一个参考文档。
主要能力:部署/操作/调试/拆除本地 RTVI-CV 容器;调用运行实例的 REST API(流、健康、指标、嵌入)。服务为 rtvi-cv(metropolis_perception_app),REST 端口 9000(/api/v1,含 /live、/ready、/startup、/metrics、/stream/add、/stream/remove、embeddings)。支持 x86/aarch64 dGPU(T4、A100、L40、H100、B200、RTX)、SBSA(Spark、Grace-Hopper)、Jetson(Thor、Orin、Xavier)。
使用方式:先读 SKILL.md 路由,匹配意图后加载对应参考文档并逐步执行。脚本位于 scripts/,从技能根目录通过 run_script("scripts/<name>") 调用,如 load_defaults.sh、fetch_resources.sh、apply_config.sh、run_app_and_wait.sh、add_streams.sh、collect_metrics.sh、discover_streams.sh、synthesize_docker_run.sh、calibration_manager.py 等。DEPLOY 流程要求每步输出固定宽度框(128 字符、浅色制表符),Step 5 后经 AskUserQuestion 提供后续操作菜单。
前提:VSS 部署在 $HOST_IP 可达;NGC 凭据存于 $NGC_CLI_API_KEY 和 $NVIDIA_API_KEY;调用方需有 curl、jq、Docker。
限制:需匹配的 VSS profile/微服务已部署且可达;NGC 托管模型和 NIM 可能受速率限制、GPU 显存要求和许可限制;并发、显存与存储上限取决于主机硬件和 profile 的 compose 文件。常见问题包括连接被拒(服务未运行,探测 /docs 或 /health 后重新部署)、NGC 拉取 401/403(密钥缺失或过期,docker login nvcr.io 后重试)、容器 OOM 或模型加载失败(显存不足,换更小变体或 docker compose down 释放)。