45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
# 北极星② 多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出结论）——中期规划
|