AI Knowledge

外观

模型、Prompt、语料、索引和工作流如何做版本追踪？ ​

3 分钟速学卡 ​

30 秒口述： 我会为每次候选发布生成不可变的版本 Manifest，分别记录模型 ID、参数、Prompt 模板、语料快照、解析与切片器、Embedding、索引、检索配置、工具 Schema、工作流和评测集版本。在线每个 Run 保存 Manifest ID 与实际生效版本，候选先经过离线门禁和灰度，再通过原子指针切换发布，失败时回滚到最近健康 Manifest。不能只用一个模糊的 rag_version，因为它无法回答哪一层改变、是否混用版本以及如何精确重放。

  • 本质： 用不可变 Manifest 固定完整 AI 行为组合，用 Run 记录实际生效版本。
  • 核心机制： 模型、Prompt、语料、索引、工具和工作流独立版本化；候选经门禁和灰度后原子发布，失败回滚健康版本。
  • 关键判断： 缓存与派生数据绑定内容和策略版本；记录声明版本与实际路由，才能重放和发现混版。
  • 项目落地： 故障演练：新 Prompt 上线后只有部分节点回答异常。先固定在线指针并停止扩流，再按 Run 的 Prompt、模型、索引和缓存版本分桶。
  • 边界与坑： “Git Commit 就是全部版本”：外部模型、数据快照、索引和运行配置不一定包含在代码提交中；“统一用 rag_version”：无法定位解析、Embedding、索引或 Prompt 的具体变化。

目录 ​

面试官为什么问 ​

这道题考察可复现性、发布治理、数据血缘和故障定位。重点是将“代码版本”扩展到 AI 行为依赖的完整版本图。

小白先看懂 ​

电影制作要保留剧本版、演员档期、素材批次、剪辑工程和成片版，不能只写“电影 v3”。剧本对应 Prompt，演员对应模型，素材对应语料，剪辑工程对应索引与工作流，放映拷贝对应发布 Manifest。

技术上，各组件独立版本化，再由 Manifest 固定一次候选组合。类比没有覆盖在线灰度和缓存，因此还要把缓存命名空间、策略和实际路由写入 Run，避免新旧组合混用。

主题图与核心原理 ​

图：教学图片｜模型、Prompt、语料、索引和工作流如何做版本追踪？

替代文本： 围绕“模型、Prompt、语料、索引和工作流如何做版本追踪？”组织的中文教学图，通过分区、箭头和标签解释核心机制。

模型、Prompt、语料、索引和工作流如何做版本追踪？教学图片

读图结论： 不要只记一个总版本；必须能重放每一次真实运行。

这张图片用于建立主题机制的直觉。精确公式、参数、失败分支和事实边界仍以正文与 Mermaid 为准。

图片生成记录： model=gpt-image-2，generated=2026-07-15，prompt_version=v1，reviewed=2026-07-16，review_basis=user-confirmed；查看生成 Prompt。

图：AI 候选版本的 Manifest 与原子发布

替代文本： 模型、Prompt、语料、索引、工具和工作流版本汇聚为不可变 Manifest，通过评测和灰度后原子切换，在线 Run 记录实际版本。

图表加载中…

读图结论： 版本追踪不是给文件改名，而是把一次行为所依赖的全部组件组合成可发布、可回滚、可重放的证据。

Manifest 应不可变，派生数据由内容哈希与稳定 ID 关联；索引先写候选空间，门禁通过后切别名；缓存键绑定内容、索引、Prompt、模型、权限与策略版本。Run 记录“声明版本”和“实际路由版本”，便于发现漂移。

项目和生产视角 ​

故障演练： 新 Prompt 上线后只有部分节点回答异常。先固定在线指针并停止扩流，再按 Run 的 Prompt、模型、索引和缓存版本分桶；如果发现节点缓存仍使用旧模板，清理错误命名空间并回滚。长期通过 Manifest 校验、启动时版本上报和混版告警防复发。

回归要证明同一 Manifest 可重放、旧 Manifest 可回滚、删除或撤权能传播到索引与缓存，以及灰度失败不会污染健康版本。

常见错误回答 ​

  • “Git Commit 就是全部版本”：外部模型、数据快照、索引和运行配置不一定包含在代码提交中。
  • “统一用 rag_version”：无法定位解析、Embedding、索引或 Prompt 的具体变化。
  • “记录配置即可复现”：还需保存数据快照、依赖、实际路由和随机性边界。

递进追问 ​

  1. Manifest 至少应包含哪些组件版本？
  2. 如何保证索引发布不会出现半成品可读？
  3. 缓存怎样绑定版本并支持回滚？
  4. 如何发现同一 Run 混用了新旧版本？
  5. 外部供应商模型静默升级时怎样保留证据？

关联阅读 ​

总结 ​

一句话记忆： 用不可变 Manifest 固定完整 AI 行为组合，用 Run 记录实际生效版本。

  • 模型、Prompt、语料、索引、工具和工作流独立版本化。
  • 候选经门禁和灰度后原子发布，失败回滚健康版本。
  • 缓存与派生数据绑定内容和策略版本。
  • 记录声明版本与实际路由，才能重放和发现混版。