Skip to main content
获取、修改或彻底删除单个路由工作室(Routing Studio)偏好设置。可见范围:创建者本人或所属组织的任意成员。非成员将收到 404,以确保团队偏好设置的存在性不会被泄露。

身份验证

需要携带具有 billing API 密钥作用域的 Bearer 令牌。

GET

获取完整的偏好设置快照。

PATCH

更新现有偏好设置中的字段。发送 rules 或 examples 会替换整个集合——两者在保存时都被视为单一文档。至少需要提供一个字段。
string
偏好设置名称(1–128 个字符)。
string
自由文本描述(≤512 个字符)。
object[]
替换用的规则集(≤50 条规则)。
object[]
替换用的少样本(few-shot)示例(≤30 个)。
object
替换用的按模式设置的置信度下限。
boolean
在不删除的情况下暂停/恢复。
boolean
设为/取消默认。每个作用域内只能有一个默认项。
团队作用域的偏好设置需要在当前活动组织上具有 manageWebhooks 权限。

DELETE

彻底删除。级联移除所有指向此偏好设置的密钥绑定——之前绑定的密钥将回退到解析级联链(组织默认 → 用户默认 → 无)。

错误

  • 400 routing_preference_invalid — PATCH 时的校验失败。
  • 404 not_found — 偏好设置不存在,或调用方不可见。
  • 409 conflict — 违反了默认项唯一性约束。