プロンプトテスト

プロンプトテスト

プロンプトをソースファイルとして扱いましょう。ひとつのコマンドで、リポジトリ内のすべてのプロンプトを品質基準、トークン予算、重大度のしきい値に照らしてチェックし、壊れたものがあればビルドを失敗させます。

  • CLI
  • オフライン
  • ソースからビルド

できること

先月うまく動いていたプロンプトも、善意の編集で壊れることがあります。重複した段落、削除された出力形式、貼り付けられたキーなどです。プロンプトテストは、それを本番ではなくレビューの段階で捕まえます。

promptflow check コマンドは指定したプロンプトファイルを読み込み、スコアが最低値を下回る、トークン数が上限を超える、または選んだ重大度以上の検出結果がある場合に失敗します。デフォルトのしきい値は critical なので、漏えいした認証情報は必ず失敗になります。設定はリポジトリのルートにある .promptflowrc.json ファイルに記述します。

これらは静的テストです。プロンプトのテキストを調べるだけでモデルは一切呼び出さないため、高速・無料で、毎回同じ結果になります。モデルを使った出力テストの代わりにはなりませんが、その前段に置くことで、モデルなしで見つかる失敗を取り除きます。モデルベースのテストはロードマップにあり、現時点では提供していません。

実例

compare が見つけたリグレッション

同じプロンプトの 2 つのバージョンを、このページのビルド時にエンジンが比較しました。一見無害な編集で、出力形式が削除されていました。 エンジンの検出結果と生成されたプロンプトは、エンジンと API が返すとおり英語で表示されます。

バージョン 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>

バージョン 2

84/100 · 36 トークン
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}}
品質
-16
トークン
-10
新たな問題
3
  • 警告Template variable not delimited: {{report}}.
  • 情報No output format is specified.
  • 情報No length limit for generated content.

このページのビルド時にエンジンが計算しました。 以下の設定では、最低スコア 70 のゲートにバージョン 2 は合格します。

.promptflowrc.json
{
  "include": ["prompts/**/*.md"],
  "model": "gpt-4.1",
  "minScore": 70,
  "maxTokens": 2000,
  "failOn": "critical"
}
shell
promptflow check
promptflow compare prompts/summary.v1.md prompts/summary.v2.md

主なメリット

機能

対象ユーザー

活用例

よくある質問

プロンプトテストはプロンプトをモデルで実行しますか?

いいえ。チェックは静的で、決定論的なルールでプロンプトのテキストを分析します。プロンプトをモデルで実行して出力を採点する機能はロードマップにあり、現時点では提供していません。

CLI は npm で公開されていますか?

まだです。パッケージが公開されるまでは、リポジトリのチェックアウトから CLI をビルドしてください。手順は CLI のドキュメントにあります。

どのファイル形式をチェックできますか?

あらゆるテキストファイルです。Markdown や .prompt.txt など、プロンプトを含むファイルを include の glob で指定してください。

ルールを無視できますか?

はい。.promptflowrc.json の ignore にルールコードを列挙すると、リポジトリ全体でそのルールをスキップできます。

すべての製品が同じエンジンで動くので、組み合わせても予想外の違いは生じません。

背景にある手法を学ぶ

この製品が応用している考え方を解説した、プロンプトエンジニアリング ナレッジセンターのガイドです。

自分のプロンプトで試してみましょう。

無料、決定論的、プライベート。登録不要。