预设

​

快速入门

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。

​

版本和 Marketplace 分支

• 顺序编号：v1、v2、v3。
• **语义化版本：**明确的 SemVer 标签，例如 1.2.0、2.0.0-beta.1 或 1.4.2+build.7。
• 日期版本：YYYY.MM.DD；同一天发布多个版本时追加数字后缀，例如 2026.08.02.2。

​

预设的合并方式

• 默认参数只填充请求正文中缺失的字段，不会覆盖调用方已提供的值。
• 如果请求已有系统消息，预设提示会添加到该消息前面。如果请求使用 Anthropic 风格的 system 字段，提示会添加到该字段前面。
• 提供商允许和忽略列表会在提供商选择之前应用，因此它们会缩小回退范围，而不是仅作为装饰标签。
• 使用预设模型允许列表之外模型的请求会尽早被拒绝，不会悄悄改路由到其他模型。

​

当前公开的预设功能

• 系统提示注入
• 模型允许列表
• 提供商允许或忽略列表形式的路由限制
• 解码和生成默认值
• 推理默认值

​

管理预设

​

何时使用预设

• 在多个服务之间统一系统提示。
• 为满足合规要求，将路由限制为获批提供商。
• 在不同环境之间保持默认参数一致。
• 为迁移项目提供持久位置来保存提示、路由和参数默认值，同时基本不改动应用代码。

​

相关指南

• 收集预设反馈
• 路由与回退
• 推理参数
• 功能对等矩阵