版本与发布
是什么
你编辑并保存的 Prompt 是可变的 —— 它会原地改变。发布会把当前内容 冻结成一个不可变的版本快照。出问题时,你回滚到的就是这些版本。
可以类比 Git:编辑是工作区,发布是一次提交。
为什么重要
- 安全网 —— 新 Prompt 效果不好时,一键回滚。
- 可审计 —— 每个已发布版本都被保留,带时间戳。
- 灰度发布 —— 灰度发布在两个已发布版本之间切分流量, 所以必须先发布,才能做 A/B。
发布一个版本
- 在编辑器里打开一个 Prompt。
- 设置
version标签(例如把v1改成v2)。 - 点击 发布版本。当前内容会以该标签快照保存。
快照记录 version、env、内容和发布时间,之后永不修改。
版本历史与回滚
在 Prompt 编辑器里点击 版本历史,可以看到每一个已发布快照。对每个快照你可以:
- 对比当前 —— 该版本与你当前正在编辑的内容做逐行 diff,改了什么一目了然。
- 回滚 —— 把工作区内容替换成该版本的内容。
对应的 API
| 操作 | 接口 |
|---|---|
| 发布当前内容 | POST /api/prompts/publish |
| 查看版本历史 | GET /api/prompts/:id/versions |
| 回滚到某版本 | POST /api/prompts/rollback |