Skip to main content
通过路由引擎重放一次测试用提示词两次——一次在禁用该偏好设置的情况下(基线),一次在应用该偏好设置的情况下——这样你就能在保存之前,准确看到你的调整会带来什么变化。 两个路由共享相同的响应结构:
  • POST /api/v1/routing-preferences/{id}/test — 针对已保存的偏好设置进行重放。
  • POST /api/v1/routing-preferences/test — 针对未保存的草稿请求体进行重放(不写入数据库)。仪表盘的测试台在每次按键时都会调用它。

身份验证

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

已保存偏好设置的请求体

string
必填
要重放的提示词。最多 4096 个字符。
string
必填
要模拟的调用方模式(例如 "auto"、"fast"、"think")。

草稿请求体

string
必填
要重放的提示词。最多 4096 个字符。
string
必填
要模拟的调用方模式。
object
必填
未保存的偏好设置数据体。结构与创建请求体相同,但不含 scope 和 is_default。字段包括:name、可选的 description、rules、examples、confidence_floor_overrides。其品牌安全校验、正则表达式编译校验以及供应商名称清理规则,与已持久化的路由完全一致。

请求示例

响应

两个路由返回相同的结构。每个数据块都与你的调用方在真实补全请求中收到的 routing 遥测数据格式一致。

错误

  • 400 routing_preference_invalid — 草稿校验失败(供应商名称、无法编译的正则表达式等)。
  • 404 not_found — 已保存的偏好设置不存在,或调用方无权查看。