版本 1
100/100 · 46 tokenSummarize the incident report below for the on-call engineering team in 5 bullet points. Include the root cause, the customer impact, and the fix. Return a markdown list.
<report>
{{report}}
</report>提示词测试
把提示词当作源文件对待。一条命令即可对照质量标准、token 预算和严重级别阈值检查仓库中的每个提示词,一旦有问题就让构建失败。
上个月还好用的提示词,可能被一次好心的修改弄坏:一段重复的段落、一个被删掉的输出格式、一个粘贴进来的密钥。提示词测试能在审查阶段而不是生产环境中发现这些问题。
promptflow check 命令会读取你指定的提示词文件,当某个文件得分低于你的下限、token 超过你的上限,或存在达到所选严重级别的问题时,命令就会失败。默认阈值是 critical,因此泄露的凭据总会导致失败。配置保存在仓库根目录的 .promptflowrc.json 文件中。
这些是静态测试。它们检查提示词文本,从不调用模型,因此快速、免费,且每次运行结果都相同。它们不能取代用模型进行的输出测试,而是位于其前面,消除那些不需要模型就能发现的失败。基于模型的测试已在路线图中,目前尚未提供。
实际示例
同一提示词的两个版本,由引擎在构建本页面时进行比较。那次修改看似无害,却删掉了输出格式。 引擎的检查结果和生成的提示词以英文显示,与引擎和 API 返回的内容完全一致。
Summarize the incident report below for the on-call engineering team in 5 bullet points. Include the root cause, the customer impact, and the fix. Return a markdown list.
<report>
{{report}}
</report>Summarize the incident report below for the on-call engineering team. Include the root cause, the customer impact, the fix, and some other details if relevant.
{{report}}由引擎在构建本页面时计算得出。 按照下面的配置,版本 2 能以最低 70 分通过门禁。
{
"include": ["prompts/**/*.md"],
"model": "gpt-4.1",
"minScore": 70,
"maxTokens": 2000,
"failOn": "critical"
}promptflow check
promptflow compare prompts/summary.v1.md prompts/summary.v2.md同一个文件总是产生同样的结果,因此构建变红就意味着提示词变了。
不向任何服务商发送内容,因此没有要管理的密钥,也无需按次付费。
一个满是提示词文件的仓库几秒钟就能检查完。
每次失败都会指出文件、规则和修复方法,并链接到规则参考。
门禁本身:针对一组 glob 设定最低分数、最大 token 数和触发失败的严重级别。
出现任何严重问题时退出码为 1,用于简单的通过或失败判断。
同一提示词两个版本之间的 token、质量和问题差异。
仅做安全检查,出现严重安全问题时失败。
每个命令都支持 --json,便于在脚本和仪表板中使用。
在 .promptflowrc.json 中设置包含的 glob、模型、阈值和要忽略的规则。
在 GitHub Actions 任务中运行 check,让低于标准的提示词变更无法合并。
设置 maxTokens,让系统提示词保持在你规划的额度之内。
把 fail-on 保持为 critical,一旦提交了密钥或密码就会立即失败。
对暂存的提示词文件运行 validate,在推送之前获得反馈。
不会。这些检查是静态的:用确定性规则分析提示词文本。用模型运行提示词并为输出打分的功能已在路线图中,目前尚未提供。
还没有。在软件包发布之前,请从仓库检出的代码构建 CLI。CLI 文档中列有相关命令。
任何文本文件。把 include 的 glob 指向存放提示词的文件即可,例如 Markdown 或 .prompt.txt 文件。
可以。在 .promptflowrc.json 的 ignore 下列出规则代码,即可在整个仓库中跳过它们。
所有产品都运行同一个引擎,组合使用时不会出现意外差异。
来自提示词工程知识中心的指南,讲解本产品所运用的理念。