プリセット

​

クイックスタート

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."
	  }'

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.",
});

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.",
})

​

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

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

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

​

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

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

​

プリセットのマージ方法

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

​

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

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

​

プリセットを管理する

​

プリセットを使う場面

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

​

関連ガイド

• プリセットへのフィードバックを集める
• ルーティングとフォールバック
• 推論パラメーター
• 機能パリティマトリクス