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 字段，即可渲染出相同的效果。