公告AI接口网提供各类可接入的人工智能接口
AI接口网AI 接口选型与接入工程手册
首页/评测与数据/Prompt 版本管理:把它当成代码,而不是一段文本

Prompt 版本管理:把它当成代码,而不是一段文本

2026-11-22约 6 分钟读完prompt工程版本

多数团队的 prompt 存在数据库的一个字段里,或者干脆硬编码在服务里。改的时候直接覆盖,没有记录。这在出问题时会让你完全失去排查能力。

最小可行的版本管理

目录
prompts/
  support_reply/
    v1.txt
    v2.txt
    v3.txt
    current -> v3
  invoice_extract/
    v1.txt
    v2.txt
    current -> v2

每个版本文件头部写清元信息:

meta
# id: support_reply
# version: v3
# date: 2026-11-20
# changed: 增加「不确定时转人工」规则;输出限制 3 段
# eval: acc 0.91 (v2: 0.88), avg_len 420 (v2: 610)
# author: ops

三个必须记录的字段

  • 版本 id:写进每次调用的日志,出问题能定位到具体版本。
  • 变更说明:改了什么、为什么改。三个月后你会感谢自己。
  • 评测结果:这个版本在评测集上的分数。没有分数就不该上线。

灰度与回滚

prompt 改动也要灰度。同一个功能,10% 流量走新版本,对比准确率与长度。异常就切回 current 指向旧版本。

不要做的事

  • 不要在 prompt 里写死会变的东西(日期、价格、产品名),用变量注入。
  • 不要把 prompt 拼在代码字符串里,改一次要发版。
  • 不要用「最后一次修改时间」当版本号,你不知道改了什么。
  • 不要保留几十个没人用的历史版本,三个月清理一次。
真实价值
一个反直觉的发现:多数「模型变笨了」的反馈,最后查明是 prompt 被无意改动了。版本管理最大的价值不是优化,而是排除变量。
说明
文中价格、配额、限额均为撰写时的公开口径,会随厂商调整变化;用于估算量级,不构成报价。具体以各厂商官方文档与合同为准。