多 Agent 模式决策记录(PDR)
用于记录一次多 Agent 协作模式选择。重点不是证明方案“先进”,而是说明它为什么比更简单的基线更适合当前约束,以及何时应回退。
1. 基本信息
| 字段 |
内容 |
| PDR 编号 |
PDR-000 |
| 决策名称 |
|
| 状态 |
Proposed / Accepted / Superseded |
| 日期 |
|
| 决策者 |
|
| 关联 ADR / 需求 / 事故 |
|
2. 任务与约束
目标
为什么考虑多个 Agent
| 候选边界 |
是否存在 |
证据 |
| 领域边界 |
|
|
| 数据边界 |
|
|
| 工具边界 |
|
|
| 权限边界 |
|
|
| 状态边界 |
|
|
| 故障边界 |
|
|
| 团队边界 |
|
|
关键约束
- 延迟 / SLO:
- 成本预算:
- 数据与权限:
- 风险与审批:
- 可用性与降级:
- 证据与审计:
3. 控制模型
| 问题 |
决定 |
| 谁决定下一步? |
|
| 谁拥有全局目标和结果? |
|
| Agent 怎样连接? |
|
| 每个 Agent 的真实边界是什么? |
|
| 怎样完成、部分完成或停止? |
|
4. 候选方案
| 方案 |
优点 |
风险 / 代价 |
是否进入验证 |
| 确定性工作流 |
|
|
|
| 单 Agent |
|
|
|
| Handoff |
|
|
|
| Supervisor |
|
|
|
| Router + Fan-Out/Join |
|
|
|
| 其他 |
|
|
|
5. 决策
选择的模式及组合方式
为什么不选择更简单的基线
所有权与状态写入者
| 状态 / 产物 |
所有者 |
并发与版本策略 |
| Global Task |
|
|
| Agent Local State |
|
|
| Delegation Ledger |
|
|
| Artifact / Evidence |
|
|
| Policy / Approval |
|
|
协作合同
- Delegation Contract:
- Result Contract:
- Evidence Contract:
- Join Contract:
权限与风险边界
- 委托后的有效权限计算:
- 是否允许继续委托:
- 自动执行的最高风险级别:
- 人工审批点:
6. 失败与收敛
| 场景 |
处理 |
| 单 Agent 超时 |
|
| Result Schema 非法 |
|
| 证据冲突 |
|
| 依赖不可用 |
|
| 重复消息 / 结果 |
|
| 预算耗尽 |
|
| 连续无进展 |
|
| 高风险动作未审批 |
|
7. 验证计划
| 指标 |
简单基线 |
目标 |
观察窗口 |
| 任务成功率 |
|
|
|
| 结果证据覆盖率 |
|
|
|
| 端到端延迟 P95 |
|
|
|
| 单任务成本 P95 |
|
|
|
| 可降级完成率 |
|
|
|
| 未授权副作用 |
|
0 |
|
故障注入
8. 回退与重审
回退方案
重审条件
- 多 Agent 没有显著改善质量或延迟;
- 协作成本超过收益;
- Supervisor / Join 成为主要瓶颈;
- 权限、证据或状态边界无法持续满足;
- 业务目标、风险等级或团队所有权发生变化。
9. 结果