外观
接入方式
蓝精灵不直接对外开放接口。业务系统都经智悟调用它，智悟负责取口径、鉴权、留痕与回流。这一页说清两条调用链路怎么走，主备路线怎么切，模型版本怎么登记与回退。
谁在调用它
| 调用方 | 场景 | 走哪条路 |
|---|---|---|
| 安全随手拍的 AI 识别服务 | 员工上报照片后给类型、等级、描述建议 | 调智悟的照片判定接口 |
| 智悟响应引擎 | 边缘节点上行的行为候选事件二次判定 | 智悟内部直接调蓝精灵 |
随手拍链路：蓝精灵优先，云端兜底
随手拍的 AI 识别服务开启"经智悟"开关后，一张照片按下面的顺序找模型：
| 顺序 | 路线 | 说明 |
|---|---|---|
| 1 | 智悟照片判定接口 POST /api/mind/photo/judge | 提示词从虹元取当前生效版本，判定走蓝精灵，结果带口径版本与追踪编号 |
| 2 | 蓝精灵直连 | 智悟不可用时，随手拍 AI 服务用自己的提示词直接调蓝精灵 |
| 3 | 云端通用模型 | 前两路都失败时，退回阿里云百炼的通用多模态模型，保证上报不中断 |
响应里带 _provider 字段，标明这一张实际走的是哪一路（经智悟为 mind）。运维看这个字段就能知道主路线有没有在跑。
三条路线的输出格式一致，随手拍后端的后处理（类型编号校验、等级强制、父子类型对调）对三路一视同仁。
主备提示词不同步
经智悟那一路的提示词登记在虹元，带版本；直连那一路的提示词在随手拍 AI 服务里。两份刻意不同，不要互相"同步"。要改口径，改虹元里登记的那一版。
智悟怎么调它
智悟以两组配置分别指向蓝精灵：
| 用途 | 配置项 | 说明 |
|---|---|---|
| 行为候选判定 | JUDGE_LLM_URL、JUDGE_LLM_MODEL | 两项必须同时设置才会构造判定客户端，单设模型名不生效 |
| 行为判定阈值 | JUDGE_MIN_CONF | 置信低于它的候选直接判误报，默认 0.6 |
| 照片判定 | PHOTO_LLM_URL、PHOTO_LLM_MODEL、PHOTO_LLM_TIMEOUT_S | 不配时从行为判定的地址推导；模型名默认与行为判定相同 |
照片判定走模型服务的原生生成接口并要求 JSON 输出。行为判定与摘要各自独立，摘要走别的模型，判定过的任务不再补摘要。
智悟服务的状态接口 GET /api/uanmind/status 能看到当前判定模型名、照片判定次数与最近错误；分租户计数要带管理密钥或以运营身份登录后才给。
部署与网络
- 蓝精灵推理服务与虹元底座同网，部署在企业中心机房或现场边缘节点。
- 智悟部署在云侧时，经加密通道访问现场推理节点；图片与视频只在通道两端流动，不经第三方。
- 云端多租户部署时，模型按租户隔离调用，口径与字典按租户取。
版本登记、灰度与回退
每个模型版本发布前登记进虹元模型台账，记录名称、版本、运行时、制品指纹、评测引用与状态。切换分三步：
- 影子对比。 新旧模型对同一批线上最近事件各判一次，分歧样本人工逐条看图，确认没有新增误报。
- 切换。 改智悟配置里的模型名并重启服务，状态接口确认判定模型已换。
- 回退。 改回上一个模型名并重启，台账里留下切换记录。
切换与回退都是生产动作，按企业的发布流程审批后执行。