为 AI 应用添加 eval
把预期行为和失败模式转成可运行评估套件,让 AI 应用可以回归测试。
场景定位
这个案例属于“质量、安全与评估”。它适合把一个经常需要人工整理、判断或验证的流程交给 Codex 做第一轮处理,然后由你审阅关键结果。
| 项目 | 内容 |
|---|---|
| 适合任务 | 把预期行为和失败模式转成可运行评估套件,让 AI 应用可以回归测试。 |
| 常用能力 | AI eval、Promptfoo、行为测试 |
| 产出形态 | 清单、草稿、补丁、报告、截图、表格或可运行原型,取决于具体任务 |
适合谁
- AI 应用行为不稳定
- 需要上线前评估
- 想防止提示词或模型改动带来回归
Codex 可以帮你做什么
- 提取关键场景和失败模式
- 编写评估用例
- 运行基线评估
- 输出改进建议
推荐工作流
- 先列真实用户场景
- 定义好答案和坏答案
- 使用 Promptfoo 或类似工具
- 保存基线结果
- 每次改动后重复运行
示例提示词
请为这个 AI 应用添加 eval。先提取关键用户场景和失败模式,再用 Promptfoo 写测试集。运行 eval,输出基线结果和下一步改进建议。
案例重点展开
- 先确定要评估的行为:正确性、grounding、工具使用、格式或业务规则。
- 在编辑代码前让 Codex 写 eval 计划。
- 用 Promptfoo 或类似工具生成测试数据和配置。
- 运行基线,保存结果,再迭代提示词或模型。
- 强的第一版应该包含可审阅代码、测试数据和运行结果。
完整用法拆解
1. 先把任务范围说清楚
这个案例的重点不是让 Codex 猜你的真实需求,而是把“把预期行为和失败模式转成可运行评估套件,让 AI 应用可以回归测试。”拆成一组可以检查的步骤。开始时先说明输入来源、时间范围、目标对象和最终产物。如果任务涉及多个工具,也要告诉 Codex 哪些工具可以读、哪些动作只能准备草稿。
可以把范围写成三句话:我要处理什么资料、希望得到什么结果、哪些事情不能自动执行。对于“质量、安全与评估”这类任务,范围越清楚,Codex 越容易把注意力放在真正有价值的判断上。
2. 让 Codex 先输出中间结果
不要一上来要求最终答案。更稳妥的方式是先让 Codex 完成“提取关键场景和失败模式”,再让它解释判断依据。这样你可以在中间阶段纠偏,避免它把不重要的信息写进最终产物。
如果任务比较长,可以要求 Codex 先给你一个小型样例,例如前 5 条记录、前 3 个页面、一个模块或一封邮件。样例通过后,再扩大到完整范围。
3. 把工具和证据写进交付物
这个场景常用能力包括:AI eval、Promptfoo、行为测试。让 Codex 使用这些能力时,最好要求它把依据也写出来:读了哪些文件、参考了哪些消息、运行了哪些命令、看到哪些截图或日志。
证据不是为了增加篇幅,而是为了让你能判断结果是否可靠。特别是 AI 应用行为不稳定,更应该看到来源、假设和未确认问题。
4. 逐轮校准,而不是一次到位
第一次结果通常是校准样本。你可以告诉 Codex 哪些判断正确、哪些内容太泛、哪些边界必须更严格。经过几轮之后,再考虑把流程保存为技能、自动化或长期 goal。
一个可用的校准顺序是:先列真实用户场景;定义好答案和坏答案;最后 每次改动后重复运行。这样既能提高产出质量,也能减少误操作。
更多提示词案例
入门版
请为这个 AI 应用添加 eval。先提取关键用户场景和失败模式,再用 Promptfoo 写测试集。运行 eval,输出基线结果和下一步改进建议。
请先只处理一个小范围样例,并说明你的判断依据、输出结构和需要我确认的问题。
进阶版
请把“为 AI 应用添加 eval”作为一个完整工作流来执行。
目标:把预期行为和失败模式转成可运行评估套件,让 AI 应用可以回归测试。
可用能力:AI eval、Promptfoo、行为测试
请按以下步骤进行:
1. 先确认输入来源和任务范围。
2. 输出执行计划和风险边界。
3. 生成第一版结果。
4. 标注每个关键结论的依据。
5. 列出需要我确认的问题。
不要执行发送、删除、付款、发布、承诺等不可逆动作。
复盘版
请复盘刚才这次“为 AI 应用添加 eval”任务。
请输出:
1. 哪些输入最有用;
2. 哪些判断仍然不确定;
3. 哪些步骤可以下次自动化;
4. 哪些动作必须继续人工确认;
5. 下一次我应该怎样给你更好的上下文。
自动化前校准版
我想把这个流程以后重复使用,但现在先不要自动化。
请根据本次任务整理一个可复用流程:触发条件、输入来源、处理步骤、输出格式、验证方式、停止条件和人工确认点。
尤其注意:eval 要覆盖真实失败模式。
交付物检查清单
完成这类任务后,建议检查以下内容:
- 是否清楚说明了输入来源、处理范围和时间范围。
- 是否把“提取关键场景和失败模式”和“编写评估用例”的依据写出来。
- 是否列出了不确定信息、缺失材料和需要你确认的问题。
- 是否避免了越权动作,尤其是发送、删除、付款、发布、承诺和修改生产数据。
- 是否留下了下一步可以继续执行的清单、文件、补丁、报告或验证结果。
使用边界
- eval 要覆盖真实失败模式
- 不要只放理想样例
- 模型变化后要重跑基线