メインコンテンツへスキップ
プリセットは、1 つの用途に使うモデル、システムプロンプト、パラメーター、プロバイダールールを @support-triage のような名前で保存したものです。呼び出し元はその名前を model として送り、入力だけを渡します。Gateway はプロバイダーを選ぶ前に残りの設定を補います。 リクエストのフィールドを切り替えて、どちらの値が優先されるかを確認してください。 ルールは次のとおりです。
  • パラメーターは不足分を補います。 プリセットの既定パラメーターは、リクエストが省略したフィールドにのみ適用されます。リクエストに値があれば、常にそちらが優先されます。
  • システムプロンプトは重ねられます。 プリセットのプロンプトが先に来ます。リクエストに独自のシステムプロンプトや instructions がある場合は、空行を挟んでその後に続きます。
  • リクエストのプロバイダー設定が優先されます。 リクエスト内の provider.order や provider.max_price などのフィールドは、そのフィールドについてプリセットの値を置き換えます。
  • 許可リストは絞り込むだけで、広げることはありません。 プリセットのプロバイダー許可リストと除外リストはプロバイダー選択の前に適用されるため、フォールバックで使えるプロバイダーも制限されます。プリセットの許可モデル以外のモデルは、詳細キーワード preset_model_not_allowed を含む validation_error で失敗し、別のルートには回されません。

プリセットを作成して使う

1

プリセットを作成する

ダッシュボード -> 設定 -> プリセット を開き、support-triage のようなスラッグでプリセットを作成します。すべての呼び出し元で共有する既定値だけを追加してください。スクリプトから作成するには、管理キーを使って POST /v1/presets を呼び出します。
2

名前で呼び出す

3

適用された内容を確認する

Gateway -> 使用量 でリクエストを開くと、どのプリセットの既定値が適用され、どのプロバイダーが処理したかを確認できます。

プリセットに保存できる設定

呼び出し元ごとのロジックはアプリケーション側に置き、ワークフローごとにプロンプト、ルーティング、キャッシュが異なる場合は別々のプリセットを使ってください。

プリセットを名前で指定する

プリセットは model フィールドで送ります。プロンプトテンプレートがある場合は prompt.id でも送れます。preset という専用のフィールドはありません。 公開プリセットを公開するには、公開プロフィールを有効にし、ユーザー名を設定する必要があります。ユーザー名は Phaseo 全体で一意です。スラッグは 1 人の公開者の中で一意であれば十分です。スラッグは小文字に変換され、英字、数字、-、_、.、: を使えます。

バージョンを管理してロールバックする

保存すると非公開の下書きが更新されます。新しいバージョンを公開 を押すと、下書きが変更不可の番号付きリリースになり、以前のリリースもすべて残ります。 リリースラベルの形式を選びます。 production のような名前付きラベルをバージョンに割り当て、ロールバックするときは以前のバージョンに戻します。バージョンとラベルを参照してください。 スクリプトからは、管理キーを使って POST /v1/presets/{id}/versions で公開し、PUT /v1/presets/{id}/labels/{label} でラベルを移動します。CLI のサインインや Phaseo でサインインを使うアプリは、プリセットを読み取れますが変更はできません。

マーケットプレイスのプリセットをフォークする

マーケットプレイスのプリセットのコピーは、コピーしたバージョンに固定されたままです。公開者が更新をリリースすると、コピーに通知が表示されます。適用しても変わるのは自分の下書きだけなので、自分で公開するまで本番には何も反映されません。 Phaseo は各フォークの元と系譜全体を記録するため、マーケットプレイスのページでは直接のフォークとすべての派生を分けて表示できます。 プリセットの回答に対する評価を集めるには、プリセットのフィードバックを収集するを参照してください。
最終更新日 2026年11月7日