问题排查
常见错误说明,以及如何读取追踪记录来调试路由决策。
没有模型通过下限过滤
过滤器排除了所有候选模型,请求因此以明确的错误失败(
no_candidates),而非静默降级。请放宽某个 cmp 约束或硬性 ["is", …] 条件,然后运行 /x/rank 查看哪条规则淘汰了每个模型。未知字段或算子
准入阶段拒绝了引用宿主不提供的字段或解释器不支持的算子的项(
invalid_policy)。请使用 GET /x/fields 返回的真实字段名,例如应使用 price_out,而非 price。提供商密钥缺失
所选模型的提供商未在宿主上配置,导致上游调用无法完成鉴权。请在宿主中添加该提供商的密钥;推理始终通过你自己的账号运行。
提供商超时或错误
所选模型返回错误或超时,路由器将回退到下一个通过的候选模型,并将该跳转写入追踪记录。若所有候选均失败,请求本身将报错。可通过
["top_k", N, ["argmax"]] 扩大级联范围。工作流超出限制
工作流仅在限制范围内被准入(
≤ 256 个节点,入度 ≤ 32);超出限制将在运行前被拒绝。请拆分工作流。演习通过,实际调用失败
/x/rank 和 /x/*/normalize 会准入并评估该项(term),但不执行推理,因此实际调用失败属于提供商/运行时问题(频率限制、超时、鉴权),而非策略错误。请读取追踪记录的 decision path,定位失败的跳转。