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 — 已保存的偏好設置不存在,或調用方無權查看。