《AI Agent 技术原理与架构·运行时、协议与系统架构》附录 B 案例事实表

卷三使用的三工作负载事实表与运行时实验参数:幂等键、崩溃恢复、调度背压、沙箱隔离、工具契约、熔断器、部分结果、追踪与统计有效性的教学设定值,逐项给出定义与复算公式;正文所有数字以本表为唯一来源,与卷一、卷二共用同一套 W1/W2/W3 约束。

本附录是卷三实验参数的唯一来源。三卷共用 W1/W2/W3 三条工作负载,本卷在其上叠加执行线实验参数。

所有数字为教学设定值,不代表任何真实系统或真实供应商。

一、三条工作负载(与卷一、卷二共用)

W1 检索问答W2 代码修复W3 运维处置
时间跨度3–8 步10–40 步2–6 步
可逆性只读,可重试写分支,可回滚不可逆,需审批与补偿
延迟预算p95 ≤ 8 sp95 ≤ 5 minp95 ≤ 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 调工具
A2AAgent 间消息、任务、状态
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)) / δ²(δ 为可分辨差异)
恢复判据      = 只补做未发生的事实,不重复已生效的副作用

十四、禁用与易错清单

  1. 不把教学参数写成"实测"或"生产数据"。
  2. 三卷共用 W1/W2/W3,不得新增第四种负载。
  3. 不编造供应商协议实现、论文结论或生产指标。
  4. 不把"重试"当"恢复"——恢复策略是幂等键 + 事件日志 + 补偿。
  5. 不把"统计显著"当"值得上线"——还要看效应量与错误预算(与卷二回归门口径一致)。
  6. 任何"对比"必须说明负载与实验配置。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图