疑難排解
常見錯誤說明,以及如何讀取追蹤紀錄來對路由決策進行除錯。
沒有模型通過篩選下限
過濾器排除了所有候選模型,請求因此以明確的錯誤失敗(
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,定位失敗的跳轉。