追蹤紀錄與重現
追蹤紀錄的 schema 結構、重現機制如何復現決策過程,以及一致性保障說明。
追蹤紀錄 schema
每次補全請求都帶有一條追蹤紀錄:一份結構化、可重現的記錄,說明模型是如何被選定的。它是證明物件——哪些候選模型被納入考量、每個模型通過或遭到排除的原因、最終使用了哪個,以及如何重現該決策。
deepseek-v4-flashrejected · cmp bench_intelligence ge 0.5
minimax-m2.7rejected · cmp bench_intelligence ge 0.5
deepseek-v4-proranked #1 · chosen
glm-5.1ranked #2 · cascade
gpt-5.5ranked #3 · cascade
deepseek-v4-prodecision_path · attempted · 412 ms
policy_fingerprint 301140696-1054914287 · sigma-pol/v2
policy_fingerprint
正規化策略的輕量快取鍵,格式為兩條十進位數字通道,如
301140696-1054914287;相同的項(term)共享同一指紋(fingerprint)。完整身份識別是主機端對規範編碼的 sha256。chosen
處理本次呼叫之模型的
{ model_family, served_model_id, price_in, price_out }。ranked[]
依選取順序排列的通過候選模型:
{ provider, model_family, served_model_id, tier, price_out, score }。排序最前的即為最終選定模型,其餘為備援串聯(cascade)。rejected[]
每個遭過濾排除的候選模型及其排除規則:
{ model_family, reason },例如 cmp bench_intelligence ge 0.5。decision_path[]
有序的嘗試記錄:
{ event, provider_id, attempt, latency_ms, error_kind? }。每次備援跳轉都以 attempted 項目記錄於此。total_latency_ms
路由加推理的總耗時。工作流程則返回
flow_fingerprint 與 flow_nodes[],每個節點各含一條追蹤紀錄。重現。身份識別是策略規範編碼的 sha256,因此給定追蹤紀錄與目錄快照,相同的策略與輸入在主機端或本地端均可復現相同的決策。
一致性
策略應在任何執行環境下具有相同的語義。規範編碼、sha256 身份識別、參考直譯器,以及一組共享的黃金向量共同保障了這一點。
same policy = same inputs = same catalog = same seed = same result。語義僅使用正確捨入的算術,因此符合規範的主機可重現黃金向量(tests/golden/sigma_pol_v2.json,位於 engine 儲存庫),逐位元復現每一個決策。相同的項編碼為相同的位元組,因此跨主機共享同一個 sha256 身份識別。