本附录是卷三实验参数的唯一来源。三卷共用 W1/W2/W3 三条工作负载,本卷在其上叠加执行线实验参数。
所有数字为教学设定值,不代表任何真实系统或真实供应商。
一、三条工作负载(与卷一、卷二共用)
| W1 检索问答 | W2 代码修复 | W3 运维处置 |
|---|
| 时间跨度 | 3–8 步 | 10–40 步 | 2–6 步 |
| 可逆性 | 只读,可重试 | 写分支,可回滚 | 不可逆,需审批与补偿 |
| 延迟预算 | p95 ≤ 8 s | p95 ≤ 5 min | p95 ≤ 60 s |
| 单任务成本 | ≤ $0.02 | ≤ $0.50 | ≤ $0.05 |
| 失败影响 | 低 | 中 | 高 |
卷三重点落在 W3(2–6 步不可逆任务)——它最能暴露重复副作用、状态丢失与无法恢复的问题;W1/W2 作为对照。
二、状态机与执行语义(第 1–2 章)
| 参数 | 值 |
|---|
| 三平面 | 控制面/执行面/数据面 |
| 状态机四件套 | 状态、转移、守卫、终态 |
| 投递语义 | at-least-once + 幂等消费 = exactly-once |
| 幂等键组成 | run_id + 步骤 ID + 动作 + 资源标识 |
| 崩溃恢复点 1 | 副作用后、结果持久化前 → 重新执行,外部幂等 + 对账 |
| 崩溃恢复点 2 | 结果持久化后、状态转移前 → 读键上结果,推进状态,不重复执行 |
| 恢复判据 | 知道哪些事实已发生,只补做没发生的部分 |
三、调度与并发(第 3 章)
| 参数 | 值 |
|---|
| 生产速率 | 每 2 tick 一个任务(教学设定) |
| 消费速率 | 每 3 tick 消费一个任务(教学设定) |
| 队列模式 | 无界队列(无限积压)/ 有界队列(背压让生产者等待) |
| 背压机制 | 有界队列 + 消费者就绪信号 |
| 取消路径 | 显式取消指令,记录取消原因 |
关键结论:无界队列在消费跟不上时无限积压;有界队列把压力转移给生产者,是背压的起点。
四、沙箱与隔离(第 4 章)
| 参数 | 值 |
|---|
| 隔离粒度 | 进程 / 容器 / 微虚拟机 |
| 隔离对象 | 文件系统、网络、系统调用 |
| 能力边界 | 最小权限:Agent 能触达的资源集合 |
| 逃逸面 | 从能力边界内突破到边界外的路径 |
| 审计 | 逃逸面清单定期复查 |
五、工具契约与副作用(第 5 章)
| 参数 | 值 |
|---|
| 契约三件 | schema、错误类型、版本 |
| 校验时机 | 调用前兜底参数错误 |
| 重试条件 | 可重试失败(超时、瞬时抖动)才重试 |
| 不可重试失败 | 参数错误、契约违约、审批拒绝 |
| 补偿 | 业务逆动作(如"重启服务"补偿"确认已恢复") |
| Saga | 多步骤补偿编排,先定义每步的逆操作 |
六、协议与协作(第 6 章)
| 参数 | 值 |
|---|
| MCP | 客户端—服务器:Agent 调工具 |
| A2A | Agent 间消息、任务、状态 |
| AG-UI | 面向用户的事件流:观测与接管 |
| 版本兼容 | 向后兼容 + 显式弃用周期 |
七、上下文与缓存(第 7 章)
| 参数 | 值 |
|---|
| 上下文四路 | 系统、任务、记忆、工具 |
| 前缀缓存 | 500 个 SYS token 共享前缀(教学设定) |
| 缓存命中率 | 由请求前缀重叠度决定 |
| 压缩 | 有损,需度量损失 |
八、记忆存储与一致性(第 8 章)
| 参数 | 值 |
|---|
| 索引类型 | 向量 / 倒排 / 图存储 |
| 版本仲裁 | 递增版本号,拒绝过时写入并留拒绝日志 |
| TTL 演示值 | 30 秒过期(教学演示;生产按记忆用途配置) |
| 冲突规则 | 显式覆盖 > 时间新近 |
| 软删/清除 | 审计日志 + 软删标记 + 彻底清除 |
九、多 Agent 拓扑与协作(第 9–10 章)
| 参数 | 值 |
|---|
| 拓扑 | 层级 / 市场 / 黑板 / 群体 |
| 通信成本 | 每条消息计入预算与延迟 |
| 扇出 | 一条消息触达的接收方数量 |
| 交接 | 责任转移需确认 |
| 仲裁 | 多数 / 优先级 / 版本 |
| 死锁 | 环检测 + 预算兜底(超时强制结束) |
十、容错(第 11 章)
| 参数 | 值 |
|---|
| 熔断触发 | 连续失败 ≥ 3 次(教学设定) |
| 冷却期 | 打开后等待恢复时间,冷却结束转半开 |
| 半开试探量 | 放行少量请求试探下游 |
| 半开→关闭 | 试探成功恢复 |
| 半开→打开 | 试探失败继续快速失败 |
| 阈值/冷却配合 | 阈值决定多快熔断,冷却决定多久恢复 |
关键结论:无熔断的重试会把故障放大;熔断管"试的窗口",重试管"试几次"。
十一、观测与评估(第 12 章)
| 参数 | 值 |
|---|
| 追踪 | 按 trace id 串联跨调用 |
| token 成本 | 按调用归因到运行/动作 |
| 显著性水平 | 5% |
| z 临界值 | 1.96 |
| 误差界示例 | 500 次样本、胜率 0.7 → ±0.04 |
| 分辨 5% 差异 | 每组 784 次(教学设定) |
| 分辨 10% 差异 | 每组 196 次(教学设定) |
| 常见错误 | 跑 20 次就下结论 |
关键结论:误差界随样本量平方律收缩;样本量不够时,误差吞掉差异,结论是噪音。
十二、安全与治理(第 13 章)
| 参数 | 值 |
|---|
| 威胁建模 | STRIDE 六类:伪造、篡改、否认、泄露、拒绝服务、提权 |
| 纵深防御 | 多层防线,每层失效假设明确 |
| ADR 四段 | 背景、方案、备选、结论 |
十三、口径公式
幂等键 = run_id + 步骤 ID + 动作 + 资源标识
投递语义 = at-least-once + 幂等消费/去重(≈ exactly-once)
熔断触发 = 连续失败次数 ≥ 阈值
误差界 = 1.96 × sqrt(胜率 × (1 − 胜率) / 样本量)
每组样本量 = (1.96² × 2 × p(1−p)) / δ²(δ 为可分辨差异)
恢复判据 = 只补做未发生的事实,不重复已生效的副作用
十四、禁用与易错清单
- 不把教学参数写成"实测"或"生产数据"。
- 三卷共用 W1/W2/W3,不得新增第四种负载。
- 不编造供应商协议实现、论文结论或生产指标。
- 不把"重试"当"恢复"——恢复策略是幂等键 + 事件日志 + 补偿。
- 不把"统计显著"当"值得上线"——还要看效应量与错误预算(与卷二回归门口径一致)。
- 任何"对比"必须说明负载与实验配置。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。