用途:独立部署 vss-behavior-analytics 容器(即行为分析仓库中的空间 AI 分析流水线),不随完整仓库蓝图栈一起部署。适合只想运行分析服务、切换入口(如 fusion_search、dev_example、analytics 3D、mv3dt)、使用自有配置或校准 JSON,或指向 warehouse-3d/mv3dt 配置而不启动其余仓库配置的场景。
主要能力:提供入口选择、配置来源选择、可选校准、部署与验证,以及运行时动态配置和动态校准。动态更新通过 broker 的 mdx-notification 主题进行:动态配置使用 Kafka key behavior-analytics-config,event.type 为 upsert、upsert-all、request-config 或 ack,消息经 envelope 与 payload 校验后持久化并广播 ACK;动态校准使用 Kafka key calibration,event.type 为 upsert-all、upsert 或 delete,带 ISO-8601 时间戳,校验失败会记录警告并丢弃,保留此前可用校准。
使用方式:需先检出仓库并让 VSS_APPS_DIR 指向 <repo>/deploy/docker/,设置 NGC_CLI_API_KEY 以供拉取镜像,Docker Engine 28.3.3 配合 Compose 插件 v2.39.1+。最小独立启动示例:cd $REPO/deploy/docker;export VSS_APPS_DIR=$(pwd);docker compose -f services/analytics/behavior-analytics/compose.yml up -d vss-behavior-analytics-base。完整流程可参考 references/deploy-behavior-analytics-service.md,动态配置与校准的协议见 references/dynamic-config.md 与 references/dynamic-calibration.md。
限制:需要匹配的 VSS profile/微服务已部署且调用方可达;NGC 托管模型与 NIM 可能受速率限制、GPU 显存要求和许可限制影响;并发、显存与存储取决于主机硬件和 profile 的 compose 文件;broker 为可选,未连接时容器会重试并进入 Restarting 状态,连接后才可使用动态更新。常见问题包括目标微服务未运行导致连接被拒、NGC 拉取返回 401/403 需重新登录并导出密钥、显存不足导致容器 OOM 或模型加载失败,需切换更小变体或释放 GPU。完整仓库栈部署应改用 vss-deploy-profile。