《互联网产品的 AI 架构·多能力编排与任务闭环》附录 C 编排评审清单

把卷三的判断压缩成一份可打印的编排评审清单:结构、契约、执行图、上下文、失败、人工与异步、评测、成本、权限、运维、平台化、演进与收口共十三组六十五问,每组附通过判据与常见驳回理由,末页给出四十五分钟评审流程、结论模板、上线后复盘表与三个常见误区。

清单的定位

编排评审最容易开成“架构图讲一遍”的汇报会。图讲得再漂亮,也回答不了一个问题:这条链路失败时,谁承担、损失多少、多久能恢复。

这份清单把评审拆成十三组、六十五问。每组给通过判据与常见驳回理由。不必每次问完,按方案风险挑三到五组深问;但结构、失败、权限三组,建议每次必问。

一、结构

  1. 这条链路为什么需要多个能力?单能力是否足够?
  2. 串行、并行、条件分支、人机混合、异步交付,选了哪种?为什么?
  3. 哪些步骤是固定流程,哪些真的需要模型判断?
  4. 最长路径是哪一条?关键路径上有哪些节点?
  5. 如果去掉一个节点,质量、成本、延迟各变化多少?

通过判据:有一张结构图,节点、边、汇合点、人工点都标注;每个节点能说出去留理由。

常见驳回:“业界都这么做。”结构不是模仿来的,节点数要能从需求推出来。

二、契约

  1. 节点之间传什么?字段、类型、必填项写在哪?
  2. 交接 token 预算多少?820 是上限还是观测值?
  3. 契约版本如何标识?不兼容变更如何发现?
  4. 空值、超长、格式错误分别如何处理?
  5. 哪些字段是证据,哪些是模型生成的摘要?

通过判据:每条边有 schema 与示例;契约变更走版本;非法输入有拒绝路径。

常见驳回:“模型会自己理解。”理解不是契约,下游无法据此做校验。

三、执行图

  1. 图是有向无环的吗?环在哪里被阻止?
  2. 拓扑序是否稳定?同样输入是否走同样路径?
  3. 并行汇合用 all、any 还是 quorum?失败分支如何标记?
  4. 检查点存在哪里?恢复时从哪一步继续?
  5. 每个节点是否幂等?重复执行会不会产生第二次副作用?

通过判据:图可导出、可校验;检查点与幂等键有定义;恢复演练做过。

常见驳回:“重跑一遍就行。”重跑不是恢复,副作用可能已经发生两次。

四、上下文

  1. 共享上下文 3,200 token 包含什么?谁维护?
  2. 每个节点拿到的是全量还是切片?依据是什么?
  3. 缓存折扣 90% 是否真实命中?缓存键是否稳定?
  4. 上下文超预算时先裁什么?裁完如何验证关键信息还在?
  5. 跨租户或跨用户的数据是否可能进入同一上下文?

通过判据:上下文预算表存在;裁剪有事实探针;租户隔离有明确边界。

常见驳回:“上下文越长效果越好。”成本和泄漏风险都不支持这个结论。

五、失败

  1. 失败分为哪几类?哪些可重试,哪些绝对不可?
  2. 单步失败预算 13.02% 如何得出?关键节点是否更严?
  3. 整链成功率目标是多少?分母是任务数还是成功交付数?
  4. 部分结果能否交付?交付时如何标注缺失?
  5. 重试预算谁持有?重试是否会击穿下游配额?

通过判据:失败分类表、重试预算、部分交付规则三件齐备。

常见驳回:“失败就重试三次。”重试不是失败策略,只是把失败推迟。

六、人工与异步

  1. 哪些节点必须人工?依据是错误代价还是合规要求?
  2. 人工审核的 SLA、队列上限、超时处理是什么?
  3. 人工修改如何回写?是否影响下游契约?
  4. 长任务如何提交、查询、取消、通知?
  5. 异步任务丢失或重复交付时如何发现?

通过判据:人工节点有 SLA 与回写协议;异步任务有终态、幂等键与补偿路径。

常见驳回:“加个人看一眼。”看一眼不是控制,没有 SLA 的人工节点就是新瓶颈。

七、评测

  1. 端到端评测集覆盖哪些链路形态?各多少条?
  2. 通过标准是整体判定,还是分节点判定?
  3. 失败归因能否定位到具体节点与版本?
  4. 回放是否使用当时的模型、提示与上下文?
  5. 评测集多久更新一次?是否包含新出现的失败模式?

通过判据:评测集版本化;归因可下钻;回放可复现。

常见驳回:“抽检感觉还行。”感觉不是评测,样本量与判据都说不清。

八、成本

  1. 每次成功交付成本是多少?分母是任务数还是成功数?
  2. 交接、重试、人工、固定开销是否都计入?
  3. 节点预算如何分配?超支先裁谁?
  4. 复用回本线 28.47% 是否达到?未达到的节点为何还共享上下文?
  5. 成本异常时,多久能定位到节点与版本?

通过判据:成功交付成本可算;裁剪顺序有文档;归因可下钻到节点。

常见驳回:“单价降了就算优化。”单价不等于总成本,失败与重试会把省下的钱吃回去。

九、权限

  1. 用户权限如何传到每个节点?是否有节点用服务账号越权?
  2. 外部动作(写库、发消息、退款)由谁授权?
  3. 注入内容能否从一个节点传播到另一个节点?
  4. 工具调用的白名单与参数校验在哪里?
  5. 审计日志是否记录“谁授权了什么动作”?

通过判据:权限随请求传播;外部动作二次授权;注入有隔离与检测。

常见驳回:“内部服务不用鉴权。”编排放大了越权,一个节点被污染,整条链路都可能执行越界动作。

十、运维

  1. 每条链路的最低观测字段是什么?trace_id 能否串起所有节点?
  2. 节点级 SLO 与整体 SLO 的关系是否清楚?
  3. 哪个指标先报警?告警接收人是谁?
  4. 止血时先关哪个开关?降级后是否仍满足最低质量?
  5. 上一次事故的防复发措施是否落地?

通过判据:追踪字段齐全;SLO 可分解;止血开关有演练记录。

常见驳回:“有监控。”有监控不等于能定位,字段不全的 trace 只是一串时间戳。

十一、平台化

  1. 编排用声明式还是代码?边界在哪?
  2. 新节点如何注册?能力目录是否有一致的契约?
  3. 扩展点是否允许绕过权限与预算?
  4. 多团队共享节点时,版本与 SLA 如何约定?
  5. 平台升级是否会破坏已有编排?

通过判据:扩展有边界;目录有 owner;升级有兼容策略。

常见驳回:“先接进来再说。”接进来容易,治理与下线难。

十二、演进

  1. 这条编排的下一个版本要改什么?退出条件是什么?
  2. 灰度按什么维度切?观察期多长?
  3. 回滚只回编排版本,还是也要回节点版本?
  4. 从固定编排到自主 Agent 的边界在哪里?
  5. 哪些节点未来可能被模型能力吞并?

通过判据:有版本与灰度计划;回滚演练过;Agent 边界有可判定的条件。

常见驳回:“以后再说。”没有退出条件的编排,会变成下一任维护者的历史包袱。

十三、收口

  1. 基线数字(成本、延迟、成功率)是否可复现?
  2. 评审结论是否写成可验证的条件,而不是“同意”?
  3. 每个条件是否有负责人和复查日期?
  4. 上线后复盘表由谁填?差异超过 20% 怎么办?
  5. 这次评审暴露的系统性缺口是什么?谁来补?

通过判据:结论有条件、有 owner、有日期;复盘表已预填。

常见驳回:“先上线,有问题再复盘。”复盘不是事后补文档,条件必须在放行前写死。

进评审前的三个快速判据

时间不够时,先用三问筛掉准备不足的方案:

  • 能不能一句话说清“为什么不是单能力”? 说不清,说明结构还没成立。
  • 失败时用户看到什么,团队能否在十分钟内说清? 说不清,说明失败路径没设计。
  • 这次改动的退出条件是什么? 说不清,说明方案没有回滚预案。

三问有一问答不上来,方案先回去补材料,不进入详细评审。它们不保证方案正确,但能挡掉大部分“先画一张图再说”的方案。

四十五分钟评审流程

时间动作产出
0–5 分钟方案方讲结构、基线、目标与改动一句话结论
5–15 分钟按风险挑三组深问三到五个待确认项
15–30 分钟逐项给结论通过 / 有条件通过 / 驳回
30–40 分钟核对失败路径、权限与回滚门禁与回滚条件
40–45 分钟指定负责人、复查日期与证据行动项

评审的产出不是“同意”,而是“可验证的条件”。没有条件的通过,等于把风险留给上线之后。

结论模板

方案:        回声售后编排 v3(拆分为小模型 + 校验两节点)
结论:        有条件通过
基线:        2026-10-27 至 2026-11-03,按链路拆分,含重试与失败任务
改动:        拆节点、共享上下文 3,200 token、新增两次交接
预期:        成本 4,240 → 3,786 微元(-10.71%)
             端到端 1,200 → 1,269ms(+5.79%)
             整链成功率不低于 49.8%,单步失败预算 13.02%
条件:        1) 交接契约补齐版本与空值处理(负责人:编排组)
             2) 校验节点保留独立预算下限(负责人:平台)
             3) 灰度 10% 观察 48 小时,失败率超标自动回滚(负责人:平台)
复查:        2026-11-12,带成功交付成本、整链成功率与回放样本

模板里的数字是示例值,不是承诺值。评审要确认的是“这些数字怎么算出来”,而不是“数字好不好看”。

上线后复盘表

项目预期实际差异原因
每次成功交付成本8,004 微元
整链成功率≥49.8%
单步失败率≤13.02%
交接 token820/次
端到端 p951,269ms
复用率≥28.47%
人工介入率基线不变
部分交付率基线不变

复盘表在灰度结束后一周填写。差异超过预期 20% 的项目必须给出原因;给不出原因的,视为实验设计有缺陷,而不是“模型不稳定”。

评审中最常见的三个误区

误区一:只审结构图,不审失败路径。 图能说明“正常情况下怎么走”,说明不了“某个节点超时后谁来收尾”。评审要把每条边的最坏情况问一遍。

误区二:只审单节点,不审交接。 每个节点单独看都达标,接在一起却失败,问题通常出在契约、上下文与重试预算。交接是编排特有的成本,也是最容易漏审的部分。

误区三:只审这一次,不审退出条件。 编排会随模型、提示、业务规则一起漂移。没有灰度、回滚与复查日期的方案,上线那天就是它最后一次被认真检查。

小结

编排评审的本质,是问四个问题:结构是否成立、失败是否可控、成本是否算清、权限是否收得住。

六十五问不必一次问完。先问结构、失败与权限三组,大多数方案的风险会在这三组里暴露;成本与评测放在第二轮,演进与平台化留到方案稳定之后再谈。

评审结束前,把结论写成条件,把条件写进复盘表。清单只有被下一次复盘引用,才算真正生效。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

  1. 《互联网产品的 AI 架构·平台化与治理》附录 C 平台化评审清单
  2. 《互联网产品的 AI 架构·平台化与治理》附录 B 能力目录与配额字段速查
  3. 《互联网产品的 AI 架构·平台化与治理》附录 A 治理角色与职责速查