バージョン 1
100/100 · 46 トークン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>プロンプトテスト
プロンプトをソースファイルとして扱いましょう。ひとつのコマンドで、リポジトリ内のすべてのプロンプトを品質基準、トークン予算、重大度のしきい値に照らしてチェックし、壊れたものがあればビルドを失敗させます。
先月うまく動いていたプロンプトも、善意の編集で壊れることがあります。重複した段落、削除された出力形式、貼り付けられたキーなどです。プロンプトテストは、それを本番ではなくレビューの段階で捕まえます。
promptflow check コマンドは指定したプロンプトファイルを読み込み、スコアが最低値を下回る、トークン数が上限を超える、または選んだ重大度以上の検出結果がある場合に失敗します。デフォルトのしきい値は critical なので、漏えいした認証情報は必ず失敗になります。設定はリポジトリのルートにある .promptflowrc.json ファイルに記述します。
これらは静的テストです。プロンプトのテキストを調べるだけでモデルは一切呼び出さないため、高速・無料で、毎回同じ結果になります。モデルを使った出力テストの代わりにはなりませんが、その前段に置くことで、モデルなしで見つかる失敗を取り除きます。モデルベースのテストはロードマップにあり、現時点では提供していません。
実例
同じプロンプトの 2 つのバージョンを、このページのビルド時にエンジンが比較しました。一見無害な編集で、出力形式が削除されていました。 エンジンの検出結果と生成されたプロンプトは、エンジンと 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}}このページのビルド時にエンジンが計算しました。 以下の設定では、最低スコア 70 のゲートにバージョン 2 は合格します。
{
"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 の集合に対して、最低スコア、最大トークン数、失敗とみなす重大度を判定します。
重大な検出結果があれば終了コード 1 を返す、シンプルな合否判定です。
プロンプトの 2 つのバージョン間のトークン、品質、検出結果の差分。
重大なセキュリティの検出結果があると失敗する、セキュリティ専用の実行。
すべてのコマンドが --json に対応し、スクリプトやダッシュボードで使えます。
対象の glob、モデル、しきい値、無視するルールを .promptflowrc.json に記述します。
GitHub Actions のジョブで check を実行し、基準を下回るプロンプトの変更がマージされないようにします。
maxTokens を設定し、システムプロンプトを計画した範囲内に収めます。
fail-on を critical のままにしておけば、コミットされたキーやパスワードで即座に失敗します。
ステージしたプロンプトファイルに validate を実行し、push 前にフィードバックを得ます。
いいえ。チェックは静的で、決定論的なルールでプロンプトのテキストを分析します。プロンプトをモデルで実行して出力を採点する機能はロードマップにあり、現時点では提供していません。
まだです。パッケージが公開されるまでは、リポジトリのチェックアウトから CLI をビルドしてください。手順は CLI のドキュメントにあります。
あらゆるテキストファイルです。Markdown や .prompt.txt など、プロンプトを含むファイルを include の glob で指定してください。
はい。.promptflowrc.json の ignore にルールコードを列挙すると、リポジトリ全体でそのルールをスキップできます。
すべての製品が同じエンジンで動くので、組み合わせても予想外の違いは生じません。
この製品が応用している考え方を解説した、プロンプトエンジニアリング ナレッジセンターのガイドです。