第 2/2 节课 · 7 分钟
使用预设
把模型、提示词和路由规则保存在一个名称下,并在任何应用中调用它。
预设会把某项任务的模型、系统提示词、参数和提供商规则保存在一个名称下,例如 @support-triage。调用方把这个名称作为 model 发送,只需附上输入。Phaseo 会在选择提供商之前补齐其余内容。在 设置 -> 预设 下创建预设,或使用管理密钥调用 POST /v1/presets 创建。
curl https://api.phaseo.app/v1/responses \
-H "Authorization: Bearer $PHASEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "@support-triage",
"input": "Customer says the invoice total is wrong."
}'
没有单独的 preset 字段。用 @support-triage@v3 指定某个版本,或用 @support-triage@production 跟随某个标签,这样移动标签就能回滚。
当请求和预设都设置了同一项内容时,按以下规则处理:
- 参数用于补缺。 预设的默认值只作用于请求中没有提供的字段。请求中的值始终优先。
- 系统提示词会叠加。 预设的提示词在前,然后是请求自己的提示词。
- 请求中的提供商设置优先。 请求中的
provider.order或provider.max_price会替换预设中该字段的值。 - 允许列表只会收窄,不会放宽。 不在预设允许模型范围内的模型会以
validation_error失败,不会被改路由。
检验你的理解
你的预设把 temperature 设为 0.2。一个请求发送了 "model": "@support-triage" 和 "temperature": 0.8。使用哪个值?
学以致用
三个服务用复制粘贴的提示词和提供商规则调用同一个客服模型。一次提示词修改只发布到了其中一个服务,现在它们的回答不一致。如何防止这种情况再次发生?
显示答案隐藏答案
把共享的模型、系统提示词和提供商规则移到一个预设中,让每个服务都发送 "model": "@support-triage@production"。把更改发布为新版本,移动 production 标签来上线,或把它移回去来回滚。
要点
把共享设置放进预设,在
model 中按名称调用它,需要时让请求中的值覆盖预设的默认值。相关链接
进度保存在此浏览器中。
最后核对于 2026年11月17日