unhardcoded
出现问题时

问题排查

常见错误说明,以及如何读取追踪记录来调试路由决策。

没有模型通过下限过滤
过滤器排除了所有候选模型,请求因此以明确的错误失败(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,定位失败的跳转。
← 返回文档