@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 でサインインを使うアプリは、プリセットを読み取れますが変更はできません。