theo.routingPreferences— 共享偏好對象（一套規則集，可綁定多個密鑰）。theo.routingRules— 無需顯式偏好對象即可編輯單個密鑰的規則。theo.keys.getRoutingPreference/setRoutingPreference— 將共享偏好綁定到某個密鑰。
共享偏好
列出
獲取
創建
scope: "team" 需要一個有效的組織以及團隊配置權限。通過 Idempotency-Key 請求頭實現冪等。
更新
rules 或 examples 會替換整個集合。
刪除
會級聯移除所有指向該偏好的密鑰綁定。測試（針對路由引擎重放）
會將同一條提示重放兩次——一次不應用偏好（基線），一次應用偏好——以便你渲染出並排對比的差異。routing 遙測數據一致。
按密鑰的路由規則
這是無需偏好對象的快捷方式：服務端會在後台自動查找或創建一個隱藏的按密鑰偏好，並確保綁定行指向它。當你只需調整單個密鑰時，可以使用這種方式。獲取
生效規則
這是當前實際驅動該密鑰補全請求的快照，並附帶一個source 枚舉，方便你渲染繼承來源的上下文信息。
設置
替換該密鑰的規則 / 示例 / 覆蓋項，並確保綁定指向那個隱藏行。清除
會移除綁定（該密鑰隨後回退到組織默認 → 用戶默認 → 無），並刪除那個隱藏的偏好行。指向共享偏好的現有綁定不受影響。密鑰綁定（共享偏好）
將一個已存在的共享偏好綁定到某個密鑰，或清除該綁定。類型
SDK 為每種數據結構都導出了一等類型——switch 和 if 分支無需使用 as any 即可完成類型收窄：
RoutingPreferenceSummary— 完整的偏好行。RoutingRuleInput— 單條關鍵詞/正則規則（pattern、target_mode，可選的target_engine、confidence，可選的description）。RoutingExampleInput— 少樣本（few-shot）示例（prompt、expected_mode，可選的expected_engine）。RoutingPreferenceTestResult—test返回的{ baseline, with_preference }數據封裝。KeyRoutingRulesSnapshot— 按密鑰的快照，包含active與shared_binding。KeyEffectiveRouting— 帶有source枚舉的生效路由快照。
遙測
當某個偏好參與了一次補全請求的路由決策時，meta 和 done 這兩個 SSE 事件會附帶一個 customer_preference 數據塊：
meta 事件的 routing 字段，即可渲染出相同的效果。