Skip to main content
当某个请求需要优先使用特定提供商路径,但又不想更改整个工作区的路由默认值时,可以使用此方案。

目标

  • 按优先顺序尝试提供商。
  • 将请求限制在已批准的提供商子集中。
  • 无需编辑预设即可临时忽略某个提供商。

1. 按指定顺序尝试提供商

如果已确定首选路由顺序,请使用 provider.order。
列出的提供商会排在候选项前面,然后才是其他符合条件的提供商。

2. 将请求限制在固定的提供商子集中

当请求必须限定在较小的允许列表内时,使用 provider.only。
这样,请求会限制在这些提供商中,然后在该子集中应用所选排序模式。

3. 排除某个提供商

如果要在某个请求或短期推出期间跳过某个提供商,请使用 provider.ignore。
以下情况适用:
  • 某个提供商性能下降
  • 你正在验证另一条提供商路径
  • 你想比较路由结果,但不想编辑预设

4. 谨慎组合这些控制项

你可以组合这些控制项,但意图应保持简单明确:
  • 使用 order 表示偏好
  • 使用 only 限定候选范围
  • 使用 ignore 排除某个提供商
一种实用模式会组合:
  • 使用 only 将请求限制在 google-vertex 和 google-vertex-eu 内
  • 使用 order 优先选择 google-vertex-eu
  • 使用 sort: "latency" 对允许范围内的选项排序

5. 何时将这些规则移入预设

如果多个服务使用相同的提供商规则,请不要在每个请求中重复复制,而应将它们移入预设。 以下情况适合使用请求级路由覆盖:
  • 临时的
  • 特定于调用方
  • 与某个用户流程绑定

相关指南

最后修改于 2026年10月2日