跳转至

多 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

故障注入

  • 一个 Agent 超时;
  • 一个 Agent 返回非法 Schema;
  • 两个 Agent 提交冲突结论;
  • 消息或结果重复投递;
  • Supervisor 超过深度、宽度或预算;
  • 高风险动作缺少审批;
  • Artifact 哈希或版本不匹配。

8. 回退与重审

回退方案

重审条件

  • 多 Agent 没有显著改善质量或延迟;
  • 协作成本超过收益;
  • Supervisor / Join 成为主要瓶颈;
  • 权限、证据或状态边界无法持续满足;
  • 业务目标、风险等级或团队所有权发生变化。

9. 结果