← 返回概念解读

Concept Fable精修版

版本控制

Version Control · Operations/Auditability

先读故事。这里不急着给定义,先让问题自己长出来。

寓言故事

找不到旧配方的药铺,治不好新病

青石街药铺有一本配方册。掌柜每天根据病人反馈改几味药,学徒也会在边上补几句提醒。小铺子里大家都记得昨天改了什么。

药铺接入自动抓药木偶后,配方册变成了提示词、那套机器、工具说明、禁忌表和客户标签。改动更多,速度也更快。

某天木偶突然开始给同类病人开出不同剂量。掌柜问是谁改了配方,学徒们只记得有人优化过摘要,有人换过药材表,还有人调整过禁忌顺序。

天真修补是把当前配方复制一份命名为“最新版最终”。两天后又出现“最新版最终二”“临时可用版”“不要删版”。没人知道哪一个真的上线。

新来的医案师把所有会影响抓药行为的东西放进版本柜:配方文本、药材表、木偶型号、工具权限、测试病例和发布说明。每次改动都有作者、时间、原因和差异。

他们还给生产药柜贴上版本号。若病人出现异常反应,可以回看当时使用的配方组合;若新版本出问题,可以恢复到上一个已验证版本。

版本柜不仅服务回滚,也服务学习。哪次改动降低误诊,哪次改动增加副作用,哪类客户受影响,都能沿着版本历史查到。

药铺后来敢更频繁地试新配方,因为每次尝试都不再抹掉过去。变化有了轨迹,错误也有了返回路。掌柜明白,版本控制不是给文件取名字,而是让系统行为的每一次变化都能被追溯、比较和恢复。后来,又来了一件更棘手的活。表面看只是旧问题放大,实际把藏在流程里的缝隙都逼了出来:谁先接手、谁能改动、出了错怎样回到上一步,过去靠熟人默契混过去的地方,现在都必须说清楚。主事人没有再催大家更用心,而是把现场重新走了一遍。他让人记录每次交接、每次失败和每次补救,哪些地方只是慢,哪些地方会误伤结果,哪些地方一旦错了就很难追回。

揭示

这个故事讲的是:版本控制

Version Control tracks changes to artifacts that determine system behavior. For enterprise Agents, this extends beyond code to prompts, model choices, datasets, tool schemas, policies, workflows, configurations, and evaluation suites. Version control enables auditability, reproducibility, rollback, change review, incident investigation, and controlled experimentation.

它重要的地方在于:它不只是一个术语,而是在真实 AI / Agent 系统里会反复出现的结构性问题。理解它,才能判断什么时候该加模型,什么时候该改流程,什么时候该补治理。

隐喻映射

  • 配方册:决定 Agent 行为的提示词、模型、工具和策略
  • 最新版最终:没有版本控制时的混乱命名
  • 版本柜:Git、registry 或配置版本系统
  • 作者、时间、原因和差异:commit metadata 与 change diff
  • 生产药柜版本号:线上运行版本的可追踪标识
  • 恢复旧配方:rollback 到已知良好状态
  • 最后洞察:版本控制让 Agent 行为可以复现、审计和回退

Soloharness 判断

这个概念的实战价值,是帮你把“看起来聪明的 AI 功能”拆成可交付、可验收、可治理的工作单元。

prompt versioningmodel versioningconfiguration managementaudit trail