返回文章列表

Prompt 模板版本控制:把提示词当成代码资产

说明为什么提示词需要版本号、变更记录、评估集和回滚策略,而不是散落在代码字符串里。

提示词是 AI 应用的核心逻辑之一,但很多项目把它当成普通字符串。等线上行为变化时,团队才发现不知道改了哪一句,也没有回滚策略。

Anthropic prompt engineering 文档强调清晰任务说明和上下文,OpenAI evals 文档适合验证提示词变更是否改善任务表现。[promptv-001][promptv-002]

模板要有版本号

建议记录:

  • 模板 ID。
  • 版本号。
  • 适用任务。
  • 输出 schema。
  • 关联评估集。
  • 变更说明。

没有版本的 prompt,很难被测试、审查和回滚。

概念格式:

id: article-review
version: 4
output_schema: review-result-v2
eval_set: article-review-regression

改提示词要跑评估

每次改模板,不要只看新样例是否表现好,也要看旧样例有没有回退。尤其是审核、分类、工具调用这类任务,局部优化很容易伤到边界案例。

综合提示工程和评估资料可以推断:prompt 应进入工程变更流程,和代码一样接受 review、测试和发布管理。

参考资料

  1. [promptv-001] Anthropic Docs, “Prompt engineering overview”, https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview
  2. [promptv-002] OpenAI Developers, “Evals”, https://developers.openai.com/api/docs/guides/evals