> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# プリセット

> チームで再利用できる Gateway 設定を保存します。

プリセットは、プロンプト、モデルの優先設定、ルーティングの既定値をチームで統一するための再利用可能な設定です。Phaseo ダッシュボードで管理し、チーム内で共有できます。

## クイックスタート

<Steps>
  <Step title="プリセットを作成する">
    **ダッシュボード -> 設定 -> プリセット** を開き、`release-summary` のような分かりやすいスラッグでプリセットを作成します。呼び出し元の間で共有する既定値だけを追加してください。
  </Step>

  <Step title="リクエストでプリセットを参照する">
    呼び出し元はユーザー入力に集中し、プロンプト、パラメーター、ルーティングの安定した既定値はプリセットから適用します。

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.phaseo.app/v1/responses \
        -H "Authorization: Bearer $PHASEO_API_KEY" \
        -H "Content-Type: application/json" \
      	  -d '{
      	    "model": "@release-summary",
      	    "input": "Generate a release summary for the last 24 hours."
      	  }'
      ```

      ```typescript TypeScript theme={null}
      import Phaseo from "@phaseo/sdk";

      const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });

      const response = await client.generateResponse({
      	  model: "@release-summary",
      	  input: "Generate a release summary for the last 24 hours.",
      });
      ```

      ```python Python theme={null}
      from phaseo import Phaseo

      client = Phaseo(api_key="YOUR_API_KEY")

      response = client.generate_response({
      	    "model": "@release-summary",
      	    "input": "Generate a release summary for the last 24 hours.",
      })
      ```
    </CodeGroup>
  </Step>

  <Step title="ルーティング結果を確認する">
    **Gateway -> 使用状況** でリクエストを開き、適用された既定値とリクエストを処理したプロバイダーを確認します。
  </Step>
</Steps>

## プリセットに含められるもの

* すべてのリクエストの先頭に追加するシステムプロンプト。
* 許可するモデルまたはモデルファミリー。
* ルーティングの優先設定に使うプロバイダー許可リストまたは無視リスト。
* temperature、top\_p、max\_tokens などの既定パラメーター。
* 対応モデルに適用する任意の推論既定値。

プリセット名は `@` で始まり、簡単に判別できます。

プリセットの呼び出しにはリクエストの `model` フィールドのみを使用します。Phaseo は専用の `preset` リクエストフィールドを提供しません。

* 非公開プリセットとワークスペースプリセットは `@{slug}` を使い、API キーのワークスペース内で解決されます。
* 公開プリセットは `@{username}/{slug}` を使い、どのワークスペースからも解決できます。例：`@octavia/release-summary`。

公開するには、公開プロフィールを有効にし、ユーザー名を設定する必要があります。公開スラッグの競合は公開者ごとに管理されるため、異なる公開者が同じスラッグを使っても曖昧になりません。ユーザー名は全体で一意です。スラッグは小文字に正規化され、文字、数字、ハイフン、アンダースコア、ピリオド、コロンを使用できます。

## バージョンとマーケットプレイスのフォーク

変更を保存すると非公開ドラフトが更新されます。公開できる状態になったら **新しいバージョンを公開** を選択してください。Phaseo は変更できない番号付きリリースを作成し、過去のバージョンも確認用に保持します。

プリセットの所有者は、バージョンラベルの表示方法を選択できます。

* **連番:** `v1`、`v2`、`v3`。
* **セマンティックバージョニング:** `1.2.0`、`2.0.0-beta.1`、`1.4.2+build.7` などの SemVer ラベル。
* **日付:** `YYYY.MM.DD`。同じ日に複数のリリースを公開した場合は、`2026.08.02.2` のように数値の接尾辞が付きます。

Phaseo は内部で別の単調増加するリリース番号を管理します。公開ラベルの形式にかかわらず、時系列、上流との比較、系譜が決定的に保たれます。

マーケットプレイスのコピーは、コピー元の正確な上流バージョンに固定されます。公開者が更新をリリースすると、コピーに更新通知が表示されます。適用するとコピーのドラフトだけが更新されるため、ワークスペースの所有者は内容を確認して明示的に公開できます。上流の作者が本番の動作を直接変えることはありません。

Phaseo は各フォークの直近のコピー元と完全な系譜を保持します。そのため、何度もコピーして再公開されたプリセットでも、マーケットプレイスのページで直接のフォークとすべての子孫を区別できます。

## プリセットのマージ方法

Gateway コンテキストでリクエストにプリセットが適用される場合、プロバイダーのルーティング前にプリセットが適用されます。

* 既定パラメーターはリクエスト本文にないフィールドのみを補い、呼び出し元が指定した値を上書きしません。
* リクエストにすでにシステムメッセージがある場合、プリセットのプロンプトをその前に追加します。Anthropic 形式の `system` フィールドを使う場合は、そのフィールドの先頭に追加します。
* プロバイダーの許可リストと無視リストは選択前に適用されます。見た目だけのラベルではなく、フォールバック候補を絞り込みます。
* プリセットのモデル許可リストにないモデルを使うリクエストは、無言で別モデルへルーティングせず、早い段階で拒否されます。

このため、プリセットは再利用可能なリクエスト既定値や軽量な互換性変換を設定する主な公開インターフェイスです。呼び出し元ごとに同じプロンプトやパラメーターのロジックを複製する必要がありません。

## 現在の公開プリセット機能

ダッシュボードのプリセット機能は、リクエスト設定のうち、安定して明示できる次の項目に意図的に限定されています。

* システムプロンプトの挿入
* モデル許可リスト
* プロバイダー許可リストまたは無視リストによるルーティング制限
* デコードと生成の既定値
* 推論の既定値

呼び出し元ごとに複雑な変換が必要な場合は、アプリケーション境界の 1 か所にまとめ、プリセットにはチームで再利用する既定値を保持してください。

## プリセットを管理する

**ダッシュボード -> 設定 -> プリセット** でプリセットを作成、管理します。プロンプト、ルーティング、キャッシュの動作が大きく異なるワークフローには、別のスラッグを使ってください。

## プリセットを使う場面

* 複数サービスでシステムプロンプトを統一する。
* コンプライアンス要件に合わせて、承認済みプロバイダーだけにルーティングする。
* 環境間で既定パラメーターを統一する。
* アプリケーションコードをほぼ変更せず、移行プロジェクトがプロンプト、ルーティング、パラメーターの既定値を保持できるようにする。

## 関連ガイド

* [プリセットへのフィードバックを集める](./preset-feedback.mdx)
* [ルーティングとフォールバック](./routing-and-fallbacks.mdx)
* [推論パラメーター](./inference-parameters.mdx)
* [機能パリティマトリクス](../migration-guides/feature-parity-matrix.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.