cma-management/docs/northstar-layer-maps/02-multi-bot.md

北极星② 多Bot互动 — 一页纸逻辑地图

定位：14个Bot像同事一样读写CMA数据、协同干活。任总10分钟消化层。

数据流（箭头图）

14Bot（研学/财务/项目/运维/创作/商务...）
        │  bot/query  bot/kpis  bot/import
        ▼
   bot_bridge（A2A桥接层，X-BOT-KEY鉴权）
        │  写：kpi-value-with-check / kpi-result / okr/create
        │  读：budget/plans / cost/actual / okr/list
        ▼
   验证引擎（verify + bot-bridge/verify）
        │  passed → 自动回填 + OKR联动 + 通知
        │  failed → 打回Bot重试(≤3次) → 升级人工
        ▼
   CMA数据池（KPI/预算/OKR/ActionPlan）

关键API（核心5个）

核心	API	作用
⭐1	POST /bot/kpi-value-with-check	Bot写KPI值+校验
⭐2	GET /bot/overview	Bot总览（各Bot权限内数据）
⭐3	POST /bot-bridge/verify/{plan_id}	Bot侧轻量验证入口
⭐4	POST /bot/okr/create	Bot创建OKR
⭐5	POST /bot/import	Bot批量导入

决策点（需任总拍板 1-3个）

1. Bot写入权限边界：哪个Bot能写哪些表（L1-L4分级已定，执行中）
2. 验证失败打回策略：打回次数/升级阈值（当前默认3次）
3. Bot间数据一致性：多Bot写同一KPI冲突时谁优先（唯一执行人铁律）

验证点

• ✅ L1自动：bot/iron-law 铁律KPI看板（每日聚合）
• 🟡 L2 Bot验证：bot_bridge读写闭环（QA Bot造数验证）
• 🔴 L3任总抽验：overview总览 / query查询 / 验证桥 3项核心

当前状态

• ✅ A2A + bot_bridge 已落地（14Bot互通）
• ✅ verify引擎已上线（2026-08-30修复4缺陷，commit 6910d90）
• ⏳ 失败打回Bot自动重试链路（cron残留修复派单中）
• 🟡 Bot联合决策（同数据多Bot出结论）——中期规划