本附录定义卷三出现的核心术语与指标。正文使用这些词时,以本表的口径为准;同一概念不在别处另设定义。
一、运行时结构
控制面 / 执行面 / 数据面
运行时三个平面的职责划分。控制面管"决定做什么",执行面管"实际执行动作",数据面管"状态与日志的读写"。故障先归平面,再谈修复。
引擎 / 服务 / Worker / 存储
四种组件的职责边界。引擎持有状态机与调度逻辑,服务暴露 API 并校验输入,Worker 执行动作,存储持久化事件与状态。
依赖方向 / 架构不变量
依赖必须单向(引擎→服务→Worker→存储,或同层不互相依赖),不变量是运行时"不坏"的最小集合(如"副作用必须幂等"“状态必须可重放”)。
二、状态机与执行语义
状态机
状态、转移、守卫、终态四件套。执行被建模成状态转移:每个动作是转移,守卫决定能不能转,终态决定何时停。
事件溯源
把每次转移写成不可变事件,当前状态由事件重放得到。事件日志是可审计、可重放的最小单位。
持久化执行
执行进度持久化到存储,崩溃后从最后一致点继续。不是"重启整个任务",而是"从状态恢复"。
幂等键
由执行标识 + 动作标识构成,副作用执行前先登记。幂等键保证同一动作只生效一次,重试不造成重复副作用。
崩溃恢复
在副作用已完成、确认前崩溃的场景下,用幂等键判断"这次副作用要不要补做"。重放指重放事件日志,补偿指撤销已生效的副作用。
三、调度与并发
队列 / 优先级 / 公平
任务进入队列按优先级调度。反饥饿:低优先级任务必须有机会执行,不能无限等待。
并发上限 / 背压 / 取消
并发上限来自资源预算(显存、连接、Worker),不是配置。背压是"下游忙时上游减速",取消是"任务中途停止的路径要明确"。
长任务 / 定时任务
长任务跨多次调用周期,要能恢复、能终止;定时任务依赖时钟,要处理时钟回拨与重复触发。
四、沙箱与隔离
进程 / 容器 / 微虚拟机
三种隔离粒度。进程隔离最轻,微虚拟机隔离最强,成本依次上升。隔离粒度由威胁模型决定,不是越大越好。
系统调用隔离
对文件系统、网络、系统调用的访问控制。隔离回答的是"Agent 能碰什么",不是"Agent 需要什么"。
能力边界 / 逃逸面
最小权限原则下 Agent 能触达的资源集合。逃逸面是"从能力边界内突破到边界外"的路径,要定期审计。
五、工具契约与副作用
工具契约
工具输入输出 schema、错误类型与版本。契约是 Agent 与工具之间的最小共识。
校验 / 幂等 / 重试
校验在调用前兜底参数错误;幂等防重复副作用;重试是"失败后重做一次"的决策,要区分可重试与不可重试失败。
补偿 / 回滚 / Saga
部分成功后的逆操作。补偿是业务逆动作,回滚是状态还原,Saga 是多步骤的补偿编排。
六、协议与协作
MCP
模型上下文协议:把工具调用标准化为客户端—服务器的请求/响应。解决的是"Agent 怎么调工具"。
A2A
Agent 间协作协议:消息、任务、状态。解决的是"Agent 怎么把任务交给另一个 Agent"。
AG-UI / 事件协议
面向用户的 Agent 事件流协议。解决的是"Agent 运行过程怎么被观测与接管"。版本兼容策略决定协议演进不破坏已有客户端。
七、上下文与缓存
上下文组装
系统、任务、记忆、工具四路信息如何拼进一次请求。每路的信息口径要固定,避免混入脏数据。
压缩 / 摘要 / 预算分配
上下文超过预算时的降载手段。压缩是有损的,损失要有度量;预算分配决定什么该放前面。
前缀缓存
重复的请求前缀被缓存复用。命中率决定 token 成本,缓存失效要处理上下文变更。
八、记忆存储与一致性
向量 / 倒排 / 图存储
三种索引的适用边界:向量管相似检索,倒排管关键词,图管关系查询。混合使用要明确各自的职责。
版本仲裁 / TTL 过期
记忆冲突按显式覆盖 > 时间新近仲裁;过期记忆按 TTL 规则淘汰。遗忘是设计,不是缺陷。
审计 / 软删 / 清除
记忆的审计日志、软删标记与彻底清除。合规要求决定哪些记忆必须可删除。
九、多 Agent 拓扑与协作
层级 / 市场 / 黑板 / 群体
四种拓扑的职责分配。层级有明确的上级,市场有竞价,黑板共享状态,群体无中心。
通信成本 / 扇出
多 Agent 的通信是成本,扇出是"一条消息触达多少个接收方"。扇出越高,成本与一致性压力越大。
委托 / 交接 / 仲裁
委托是"把任务交给别人做",交接是"责任转移要有确认",仲裁是"多个结果冲突时怎么定"。
死锁
Agent 互相等待对方完成导致的停滞。环检测发现依赖环,预算兜底(超时强制结束)。
十、容错与观测
失败分类 / 扩散
失败按"可重试 / 不可重试"与"局部 / 全局"分类;扩散指一个失败波及整条链的路径,要有熔断。
熔断器
闭合(正常)/ 开路(拒绝请求)/ 半开(试探恢复)三态。开路后按超时进入半开,试探成功转闭合。
部分结果
子任务部分失败时,已完成的结果如何合成。合成规则要显式,不能"有就拼"。
调用链追踪 / token 成本
跨 Agent、跨调用的追踪与 token 成本归因。成本按调用归因,追踪按 trace id 串联。
确定性评估 / 统计有效性
把模型输出变成可判定的断言,再用样本量与显著性判定结论成立。两条腿:断言可判定 + 样本够统计。
十一、安全与治理
威胁建模 / STRIDE
伪造、篡改、否认、信息泄露、拒绝服务、权限提升六类威胁的建模方法。先列威胁,再谈防御。
纵深防御
多层防线,每层失效假设明确。防御的目标不是"不坏",而是"坏了能发现、能止损"。
ADR(架构决策记录)
把架构决策写成"背景、方案、备选、结论"四段记录。ADR 让演进可追溯,是运行时治理的最小单位。
十二、易混淆点
- 控制面与执行面:控制面决定做什么,执行面做动作;把"决定"当"执行"是常见的归因错误。
- 重放与补偿:重放是"重新执行未生效的副作用",补偿是"撤销已生效的副作用",方向相反。
- 幂等与重试:幂等让重试安全,没有幂等键的重试是重复副作用。
- 隔离与权限:隔离回答"碰不到",权限回答"能碰什么";两者都要。
- MCP 与 A2A:MCP 是 Agent 调工具,A2A 是 Agent 间协作,不是一回事。
- 熔断与重试:熔断拒绝上游请求,重试重复下游调用;无熔断的重试会把故障放大。
- 统计显著与实用:统计显著不等于值得上线,还要看效应量与错误预算(与卷二回归门口径一致)。
- 威胁建模与安全检查:威胁建模先列威胁,安全检查后验防御;跳过威胁建模的检查是查了个寂寞。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。