追踪记录与重现
追踪记录的 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 身份标识。