上线、运营与演进

第 7 课 · 共 7 课 约 9 分钟

上线清单、采用度指标、语义版本与破坏性变更纪律、成本与按需、治理节奏,以及接下来学什么。

本课目标

读完这一课,你将能够

  • 写出一份上线清单,每一项都能用命令或页面核对
  • 用日志和 Action 记录算出采用度,并据此决定要不要提高自主程度
  • 按「先加后删、破坏性先确认」的纪律发版,并定下每周、每月、每季度的治理节奏

上线清单

上一课把四个闭环连成了一个系统,这一课让它上线,并长期转下去。打开自动化之前,逐项核对一张清单。每一项都要能用命令或页面确认,不靠感觉:

  1. 验收问题

    一页设计第 6 栏的问题,人和智能体都答对了。

  2. Action

    每个 Action 都做过一次通过、一次失败的 --validate-only。

  3. 工作流

    aidc app deploy --dry-run 没有解释不了的告警,test 通道预演过三种情形。

  4. 通知

    aidc notify test 收到了;收件人都是本公司账号,不超过 5 个。

  5. 权限

    批准类 Action 的 roles 与提交条件、一般访问和分享对象都核对过。

  6. 数据

    绑定状态正常,看门狗已经就位。

  7. 停用版

    一个只保留手动触发的版本已经发布过,运行手册写好了。

运行手册可以直接做成应用的一条 Skill,放在包里的 skills/{name}/SKILL.md。别人(或智能体)复制这个应用时,读到的是同一份手册。

采用度:有没有人真的信任它

自动化上线后,要问的不是「跑没跑」,而是「有没有被信任」。看四个指标:

USE

使用

打开次数、访客、常用操作、最近的错误,都在 aidc semantic observability summary 里。

ACCEPT

采纳率

批准了多少张,除以起草了多少张。两个数都能从 Action Log 数出来。

REVERSE

改回率

自动化写入之后,被人又改回去的比例,用改动历史核对。

FEEDBACK

反馈

未处理的反馈,状态从 open 走到 planned,再到 done。

aidc semantic observability summary procurement-watch --days 7
aidc semantic aggregate log.create-purchase-order --select '{"$count":"unordered"}'
aidc semantic aggregate log.approve-purchase-order --select '{"$count":"unordered"}'
aidc semantic observability events --app procurement-watch --kind feedback --status open

采纳率低,不一定是模型差。先看建议是不是来得太晚、太多,关口是不是设错了地方,再看反馈。使用与错误记录保留 180 天,反馈与操作长期保留,所以趋势可以看得比较久。采纳率稳定、改回率很低的自动化,才有理由升一级自主程度。

版本与破坏性变更

本体(Ontology)和应用各有版本。语义版本由 aidc semantic publish 发出,只增不减,定义没变不占号;应用版本是清单里的 version,改了任何东西都要升。核心模型的原则是:开放扩展,谨慎修改。

只做加法(安全)破坏性(要确认)
对象与属性加对象类型、加属性、加同义词删类型、删属性、改属性类型、改主键
Action加 Action、加可选参数删参数、新增必填参数
怎么发自进化的语义补丁只做加法,自动发新版本提案里要输入资源名确认;先看 30 天的读写次数、活跃用户和下游应用

改名分步做:先加新名字,让调用方迁过去,再把旧属性标为 deprecated 或 experimental,定义或合并该状态后才删除。发布前用 aidc semantic define ontology/ --dry-run 看破坏性变更,用 aidc app registry 看哪些应用在读写它。工作流的 with 参数要与 Action 参数对应,部署时不匹配会被拦下。

成本、节奏与接下来学什么

成本靠按需。每个应用每月缺省 2000 计算分钟,用到 80% 就会有提示,用 aidc app usage 看;触发优先于定时,定时最密每 5 分钟,1 小时以内都会告警。没有人看、没有变化的时候,就不该有东西在跑。

  1. 每周

    审提案:aidc semantic proposals --status OPEN。分支 35 天没有动静会转为 INACTIVE,再过 7 天删除,所以别让提案积压。再看反馈和自进化的提案。

  2. 每月

    看计算分钟与被拦下的通知;对照采纳率,决定要不要提高自主程度。

  3. 每季度

    换一批新的验收问题重测;复查 roles、分享与 Public 的设置。

APPS

在 Semantic 上做应用

把批准按钮和看板做成给人用的界面。

SECURITY

权限、安全与治理

收紧谁能看、谁能改,把提案审核做扎实。

AGENTS

由智能体构建

让智能体发现缺口、开带证据的提案。

AUTOMATION

全自动系统

回头重读条件、效果与可靠性,把这一门里的设计再打磨一遍。

要点

  • 上线清单的每一项都要能用命令或页面核对,其中一项是预先发布好的停用版。
  • 采用度看使用、采纳率、改回率和反馈;采纳率稳定、改回率低,才升一级自主程度。
  • 先加新名,再迁调用方。旧属性先落地 deprecated 或 experimental 状态,才可删除;破坏性变更先看影响面,再在提案里输入资源名确认。
  • 治理有节奏:每周审提案,每月看用量与采纳率,每季度换新问题重测。

练一练

为你的闭环准备上线

拿你在前几课设计的一个闭环,做上线前的最后一遍。

照上面的七项写你自己的上线清单,每项写出用来核对的命令或页面;写不出核对办法的,就是还没准备好。

小测

选一个答案,马上看解析。

Q1上线清单里为什么要有一个预先发布好的「停用版」?

Q2要把属性 status 改名为 state,怎样最稳妥?

Q3起草的采购订单只有三成被批准。第一步该做什么?

延伸阅读