レッスン 2/2 · 7 分

プリセットを使う

モデル、プロンプト、ルーティングルールを 1 つの名前で保存し、どのアプリからでも呼び出します。

プリセットは、1 つの用途に使うモデル、システムプロンプト、パラメーター、プロバイダーのルールを、@support-triage のような名前で保存したものです。呼び出す側は、その名前を model として送り、入力だけを渡します。Phaseo はプロバイダーを選ぶ前に残りを埋めます。プリセットは 設定 -> プリセット で作成するか、管理キーを使って POST /v1/presets で作成します。

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "@support-triage",
    "input": "Customer says the invoice total is wrong."
  }'

preset という別のフィールドはありません。@support-triage@v3 でバージョンを指定するか、@support-triage@production でラベルに従うようにすれば、ラベルを移動するだけでロールバックできます。

リクエストとプリセットの両方が同じ項目を設定している場合は、次のルールで決まります。

  • パラメーターは空きを埋めます。 プリセットの既定値は、リクエストが省略したフィールドにだけ適用されます。リクエストの値が常に優先されます。
  • システムプロンプトは重なります。 プリセットのプロンプトが先に、その後にリクエスト自身のプロンプトが続きます。
  • リクエストのプロバイダー設定が優先されます。 リクエストの provider.order や provider.max_price は、そのフィールドについてプリセットの値を置き換えます。
  • 許可リストは絞り込むだけで、広げることはありません。 プリセットの許可モデル以外のモデルは validation_error で失敗し、別のルートには回されません。

理解度チェック

プリセットで temperature を 0.2 に設定しています。リクエストが "model": "@support-triage" と "temperature": 0.8 を送ります。どちらの値が使われますか?

実践してみる

3 つのサービスが、コピー&ペーストしたプロンプトとプロバイダーのルールで、同じサポート用モデルを呼び出しています。プロンプトの変更が 1 つのサービスにだけ反映され、ほかには反映されず、回答に差が出ています。再発を防ぐにはどうしますか?

答えを表示

共通のモデル、システムプロンプト、プロバイダーのルールを 1 つのプリセットにまとめ、すべてのサービスが "model": "@support-triage@production" を送るようにします。変更は新しいバージョンとして公開し、production ラベルを移動して展開します。ロールバックするときはラベルを戻します。

ポイント

共通の設定はプリセットにまとめ、model で名前を指定して呼び出し、必要な箇所ではリクエストの値でプリセットの既定値を上書きします。

関連リンク

進捗はこのブラウザーに保存されます。

最終確認日:2026年11月17日