后端API网关模型推理服务AI Agent【免费下载链接】semantic-routerAn open, programmable decision layer for models and compute.项目地址https://gitcode.com/gh_mirrors/sem/semantic-router点击查看免费下载本文是 semantic-router 中 VSRVector Semantic Router决策跟踪响应头x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-model的实战技术指南。它面向需要调试路由结果、监控模型选择与推理模式、以及基于路由元数据做成本核算的开发者与运维人员。读完本文你将掌握这些头字段的完整取值语义、触发条件与排除条件并理解它们如何由语义路由器ext_proc 流水线在响应头阶段写入以及如何在真实请求中验证与消费这些元数据。概述什么是 VSR 决策跟踪响应头semantic-router 作为模型与算力之间的可编程决策层会在请求处理过程中执行分类domain classification、推理模式判定reasoning mode与模型选择model selection等一系列路由决策。为了让这些看不见的决策过程变得可观测路由器会自动在成功的响应上附加一组以x-vsr-selected-为前缀的响应头用于跟踪 VSR 的决策信息。这些头帮助开发与运维团队回答三个核心问题这个请求被 VSR 归到了哪个类别category这个请求是否启用了推理模式reasoning这个请求最终由哪个模型model处理在源码中这些响应头的名称以常量形式集中定义在 src/semantic-router/pkg/headers/headers.go 的 VSR Decision Tracking Headers 区块VSRSelectedCategory x-vsr-selected-category—— 领域分类器domain classifierMMLU 类别选出的类别VSRSelectedReasoning x-vsr-selected-reasoning—— 推理模式判定结果on/offVSRSelectedModel x-vsr-selected-model—— VSR 为该请求选定的模型。三个核心头的字段语义x-vsr-selected-category属性说明描述VSR 在领域分类domain classification阶段为该请求选定的类别示例值math、business、biology、computer_science何时添加VSR 成功将请求分类到某个类别时该值来源于领域分类器MMLU 类别体系。从源码看类别信息既可能来自请求体分类阶段也可能在决策匹配阶段通过extractDecisionCategory从命中的规则中提取——见 src/semantic-router/pkg/extproc/req_filter_classification_runtime.go它扫描形如domain:xxx的匹配规则取出domain:前缀之后的类别名写入ctx.VSRSelectedCategory。x-vsr-selected-reasoning属性说明描述该请求是否被判定为需要启用推理模式取值on—— 启用推理模式off—— 关闭推理模式何时添加VSR 做出推理模式决策时自动模式与显式模型选择均适用在 src/semantic-router/pkg/extproc/recorder.go 的trackVSRDecision中可以看到写入逻辑当useReasoning为真时置on否则置off。推理模式的最终决策由模型选择算法如 entropy 推理判定产出并通过决策记录、指标与链路追踪routing.backend.resolved事件一并暴露。x-vsr-selected-model属性说明描述VSR 为处理该请求而选定的模型示例值deepseek-v31、phi4、gpt-4何时添加VSR 完成模型选择时自动路由或显式模型指定均可触发头字段的添加条件三个前提同时满足根据文档与源码实现只有同时满足以下三个条件时决策跟踪响应头才会被附加请求成功上游返回 HTTP 200-299未命中缓存响应不是从响应缓存response cache直接返回的VSR 实际执行了路由决策在请求处理过程中 VSR 做出了路由判断分类、推理模式或模型选择。这三个条件的判断逻辑集中在响应头处理阶段。在 src/semantic-router/pkg/extproc/processor_res_header.go 中handleResponseHeaders会先从 Envoy 的响应头中解析上游状态码:status随后调用 src/semantic-router/pkg/extproc/processor_res_header_mutation.go 的buildResponseHeaderMutation来组装要写入的响应头。其关键分支如下ctx.VSRCacheHit为真时直接跳过全部 VSR 决策头缓存命中意味着没有重新执行路由isSuccessful为假4xx/5xx时只保留基础契约头不输出决策跟踪头成功且未命中缓存时先输出最终路由事实decision/algorithm/model 等再根据调试开关决定是否输出中间细节头。示例响应一个真实的路由决策跟踪响应头示例如下文档原始示例HTTP/1.1 200 OK Content-Type: application/json x-vsr-selected-category: math x-vsr-selected-reasoning: on x-vsr-selected-model: deepseek-v31 { id: chatcmpl-123, object: chat.completion, created: 1677652288, model: deepseek-v31, choices: [ { index: 0, message: { role: assistant, content: The derivative of x^2 3x 1 is 2x 3. }, finish_reason: stop } ] }注意响应体中的model字段反映的是实际推理模型而x-vsr-selected-model头则是路由器在决策阶段选定的模型二者通常一致但通过头字段你能确认路由决策时的模型选择而不是请求方自行指定的模型。响应头不会被添加的情形文档明确了三种不会添加决策跟踪头的典型场景缓存命中Cache Hit响应直接来自缓存没有发生 VSR 处理。此时连决策头也不会输出在 v0.4 契约下缓存命中响应也不携带x-vsr-schema-version/x-vsr-response-path基础头缓存载荷原样透传。错误响应Error Responses上游返回 4xx 或 5xx 状态码。缺少 VSR 信息Missing VSR InformationVSR 决策信息不可用——正常运行时不应发生例如请求被跳过处理或决策阶段未执行。这些分支在源码测试中有逐一对应的断言。例如 src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersNotAddedOnCacheHit构造了VSRCacheHit: true的上下文断言headerMutation.GetSetHeaders()为空src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersNotAddedOnErrorResponse构造 500 状态码断言错误响应上只保留 2 个基础契约头x-vsr-schema-version与x-vsr-response-path而x-vsr-selected-category、x-vsr-selected-model等决策头一律不出现。源码级实现剖析响应头从决策到落盘1. 头常量定义所有自定义 HTTP 头遵循非标准头的x-前缀约定统一维护在 src/semantic-router/pkg/headers/headers.go。每个常量都有明确的 Go 注释说明取值语义与示例并被 src/semantic-router/pkg/headers/headers_test.go 的TestHeaderConstants断言锁定——防止头名字符串被意外改写。2. 响应头组装responseHeaderMutationBuildersrc/semantic-router/pkg/extproc/processor_res_header_mutation.go 中的responseHeaderMutationBuilder是响应头的组装器核心方法addString有两个值得注意的行为空值跳过value 为空字符串时不输出该头所以部分信息场景下空字段不会以空值头出现去重同一 key 只写入一次防止重复头。在此基础上addFinalDecisionHeaders 负责在每次成功响应上输出最终路由事实决策名、算法、所选模型、路由延迟毫秒数、回退尝试次数等其中包括x-vsr-selected-model而 addDecisionDetailHeaders 负责输出中间细节头x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-modality等。3. v0.4 契约下的默认面与调试面需要特别说明当前仓库源码v0.4 响应头契约已经对三类头做了分级这与 v0.2 文档描述一律附加的语义存在演进差异x-vsr-selected-model属于默认面default surface每次成功、未命中缓存的响应都会携带x-vsr-selected-category与x-vsr-selected-reasoning属于调试面debug surface默认被降级demote只有请求显式携带x-vsr-debug: true时才内联输出否则这些中间细节可通过x-vsr-replay-id在 Router Replay 记录中找回。该开关的判定实现在 src/semantic-router/pkg/extproc/debug_mode.go 的debugHeadersRequested对x-vsr-debug头取值做大小写不敏感、去空白的true匹配。对应测试 src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersAddedOnSuccessfulNonCachedResponse明确断言未开 debug 时x-vsr-selected-category、x-vsr-selected-reasoning不出现在响应头中而 TestVSRDebugHeadersOnSuccessfulResponse 断言带上x-vsr-debug: true后它们恢复内联输出。同时TestVSRHeadersPartialInformation 还验证了空字段被正确省略。如果你在 v0.2 版本上做调试直接使用文档所述的三个头即可如果你面对的是更新版本v0.4记得在调试请求中追加x-vsr-debug: true才能看到分类与推理模式的中间细节。4. 决策信息的来源trackVSRDecision无论是自动路由还是显式模型选择决策信息最终都会汇聚到 src/semantic-router/pkg/extproc/recorder.go 的trackVSRDecisionfunc (r *OpenAIRouter) trackVSRDecision(ctx *RequestContext, categoryName string, decisionName string, matchedModel string, useReasoning bool) { ctx.VSRSelectedCategory categoryName ctx.VSRSelectedDecisionName decisionName ctx.VSRSelectedModel matchedModel if useReasoning { ctx.VSRReasoningMode on } else { ctx.VSRReasoningMode off } }这段代码印证了文档中的核心语义分类来自领域分类结果推理模式被映射为on/off两个枚举值模型选择记录最终选定的模型。实战场景一请求调试Debugging调试时你关心的是这个请求为什么被这样处理。此时你可以携带x-vsr-debug: true发起请求在支持 debug 面的新版本上用curl -i或浏览器开发者工具查看响应头对照三个核心字段判断分类、推理模式与模型是否符合预期。例如curl -i -H Content-Type: application/json \ -H x-vsr-debug: true \ -d {model:auto,messages:[{role:user,content:求 x^2 3x 1 的导数}]} \ http://router-address/v1/chat/completions响应头中如果出现x-vsr-selected-category: math与x-vsr-selected-reasoning: on说明领域分类把该数学问题归入math类别并启用了推理模型——这正是路由器的预期行为。实战场景二可观测与监控Monitoring运维团队可以利用这些头做面向请求的路由可观测性类别分布跟踪聚合x-vsr-selected-category的值分布了解请求的领域构成推理模式使用模式统计x-vsr-selected-reasoning: on/off的比例评估推理模型的启用成本模型选择模式分析跟踪x-vsr-selected-model的取值判断各模型被选中的频率辅助容量规划与配额设计。仓库中的基准测试工具直接消费这些头来做路由与成本核算。例如 bench/reasoning/router_accounting.py 定义了SELECTED_MODEL_HEADER x-vsr-selected-model、COST_HEADER x-vsr-cost等常量其注释明确指出每请求的路由与成本字段来自路由器响应头并通过response_accounting函数把selected_model、routing_latency_ms、cost等信息写入基准报告——这就是监控与分析场景在真实项目中的落地方式。实战场景三分析与产品洞察Analytics产品团队可以利用路由元数据回答以下问题请求分类准确性对照真实业务标签评估领域分类器的准确率推理模式有效性结合下游任务质量指标分析推理模式开/关的收益差异按类别评估模型表现以x-vsr-selected-category为维度切分模型性能与成本数据。端到端测试也把响应头当作断言事实来使用。例如 e2e/testcases/domain_classify.go 通过resp.Header.Get(x-vsr-selected-category)读取实际分类结果与期望类别比对来计算分类准确率result.ActualCategory resp.Header.Get(x-vsr-selected-category) result.ActualReasoning resp.Header.Get(x-vsr-selected-reasoning) result.Correct (result.ActualCategory expectedCategory)同样e2e/testcases/metadata_routing.go 断言x-vsr-selected-decision与x-vsr-selected-recipe的具体取值来验证元数据路由策略。这说明响应头本身就是该项目可验证的对外契约——头缺失或取值不对测试就会失败。兼容性解读与使用建议按版本区分头面在 v0.2 语义下三个决策头在成功非缓存响应上都会出现在更新的 v0.4 契约下x-vsr-selected-category与x-vsr-selected-reasoning被降级到调试面需要x-vsr-debug: true才能内联看到。消费方应优先依赖默认面的最终路由事实如x-vsr-selected-model把中间细节当作诊断信息。空值即省略源码中addString对空值直接跳过因此缺失该头可能意味着该决策未执行或信息不可用而不是解析错误。不要只依赖单头完整的路由故事决策名、置信度、算法、路由延迟、回退尝试次数分散在x-vsr-selected-decision、x-vsr-selected-confidence、x-vsr-selected-algorithm、x-vsr-routing-latency-ms、x-vsr-fallback-attempts等多个默认面头中建议组合消费需要细粒度中间轨迹时通过x-vsr-replay-id关联 Router Replay 记录。成本核算注意事项x-vsr-selected-model反映的是路由决策选定的模型若要按该模型计算费用应结合响应体中的 usage 信息与路由器提供的成本头如x-vsr-cost、x-vsr-cost-currency一起使用——如 bench/reasoning/router_accounting.py 所示其成本基数是配置价格configured pricing而非供应商账单。总结x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-model是 semantic-router 路由决策的黑盒探针把分类、推理与模型选择三个关键决策以标准 HTTP 头的形式暴露在成功响应上。它们既服务于开发者的请求级调试也支撑运维的类别/模式/模型分布监控还能作为产品分析与成本核算的原始数据。理解其触发条件成功、未命中缓存、执行了决策、源码写入链路trackVSRDecision→buildResponseHeaderMutation→ Envoy HeaderMutation以及版本间的头面差异默认面 vs 调试面你就能在真实部署中准确解读每一次路由决策。赞分享后端API网关模型推理服务AI Agent【免费下载链接】semantic-routerAn open, programmable decision layer for models and compute.项目地址https://gitcode.com/gh_mirrors/sem/semantic-router点击查看免费下载相关推荐Semantic Router VSR 决策追踪 Header 完全指南从三个核心响应头到 v0.4 双层合约Semantic Router VSR 决策追踪 Header 完全指南从三个核心响应头到 v0.4 双层合约 导读 本文围绕 Semantic Router后端API网关模型推理服务AI Agentsemantic-router VSR 决策追踪 Header 完整指南类别、推理模式与模型选择的可观测性semantic router VSR 决策追踪 Header 完整指南类别、推理模式与模型选择的可观测性 导读 VSRVector Semantic Ro后端API网关模型推理服务AI AgentBetterDiscordPanel高级技巧自定义翻译、主题切换与消息格式化指南BetterDiscordPanel高级技巧自定义翻译、主题切换与消息格式化指南 BetterDiscordPanel是一款强大的自托管Discord机器人消创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 semantic-router VSR 决策跟踪响应头完全指南：通过 `x-vsr-selected-*` 头实现路由可观测性与调试
后端API网关模型推理服务AI Agent【免费下载链接】semantic-routerAn open, programmable decision layer for models and compute.项目地址https://gitcode.com/gh_mirrors/sem/semantic-router点击查看免费下载本文是 semantic-router 中 VSRVector Semantic Router决策跟踪响应头x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-model的实战技术指南。它面向需要调试路由结果、监控模型选择与推理模式、以及基于路由元数据做成本核算的开发者与运维人员。读完本文你将掌握这些头字段的完整取值语义、触发条件与排除条件并理解它们如何由语义路由器ext_proc 流水线在响应头阶段写入以及如何在真实请求中验证与消费这些元数据。概述什么是 VSR 决策跟踪响应头semantic-router 作为模型与算力之间的可编程决策层会在请求处理过程中执行分类domain classification、推理模式判定reasoning mode与模型选择model selection等一系列路由决策。为了让这些看不见的决策过程变得可观测路由器会自动在成功的响应上附加一组以x-vsr-selected-为前缀的响应头用于跟踪 VSR 的决策信息。这些头帮助开发与运维团队回答三个核心问题这个请求被 VSR 归到了哪个类别category这个请求是否启用了推理模式reasoning这个请求最终由哪个模型model处理在源码中这些响应头的名称以常量形式集中定义在 src/semantic-router/pkg/headers/headers.go 的 VSR Decision Tracking Headers 区块VSRSelectedCategory x-vsr-selected-category—— 领域分类器domain classifierMMLU 类别选出的类别VSRSelectedReasoning x-vsr-selected-reasoning—— 推理模式判定结果on/offVSRSelectedModel x-vsr-selected-model—— VSR 为该请求选定的模型。三个核心头的字段语义x-vsr-selected-category属性说明描述VSR 在领域分类domain classification阶段为该请求选定的类别示例值math、business、biology、computer_science何时添加VSR 成功将请求分类到某个类别时该值来源于领域分类器MMLU 类别体系。从源码看类别信息既可能来自请求体分类阶段也可能在决策匹配阶段通过extractDecisionCategory从命中的规则中提取——见 src/semantic-router/pkg/extproc/req_filter_classification_runtime.go它扫描形如domain:xxx的匹配规则取出domain:前缀之后的类别名写入ctx.VSRSelectedCategory。x-vsr-selected-reasoning属性说明描述该请求是否被判定为需要启用推理模式取值on—— 启用推理模式off—— 关闭推理模式何时添加VSR 做出推理模式决策时自动模式与显式模型选择均适用在 src/semantic-router/pkg/extproc/recorder.go 的trackVSRDecision中可以看到写入逻辑当useReasoning为真时置on否则置off。推理模式的最终决策由模型选择算法如 entropy 推理判定产出并通过决策记录、指标与链路追踪routing.backend.resolved事件一并暴露。x-vsr-selected-model属性说明描述VSR 为处理该请求而选定的模型示例值deepseek-v31、phi4、gpt-4何时添加VSR 完成模型选择时自动路由或显式模型指定均可触发头字段的添加条件三个前提同时满足根据文档与源码实现只有同时满足以下三个条件时决策跟踪响应头才会被附加请求成功上游返回 HTTP 200-299未命中缓存响应不是从响应缓存response cache直接返回的VSR 实际执行了路由决策在请求处理过程中 VSR 做出了路由判断分类、推理模式或模型选择。这三个条件的判断逻辑集中在响应头处理阶段。在 src/semantic-router/pkg/extproc/processor_res_header.go 中handleResponseHeaders会先从 Envoy 的响应头中解析上游状态码:status随后调用 src/semantic-router/pkg/extproc/processor_res_header_mutation.go 的buildResponseHeaderMutation来组装要写入的响应头。其关键分支如下ctx.VSRCacheHit为真时直接跳过全部 VSR 决策头缓存命中意味着没有重新执行路由isSuccessful为假4xx/5xx时只保留基础契约头不输出决策跟踪头成功且未命中缓存时先输出最终路由事实decision/algorithm/model 等再根据调试开关决定是否输出中间细节头。示例响应一个真实的路由决策跟踪响应头示例如下文档原始示例HTTP/1.1 200 OK Content-Type: application/json x-vsr-selected-category: math x-vsr-selected-reasoning: on x-vsr-selected-model: deepseek-v31 { id: chatcmpl-123, object: chat.completion, created: 1677652288, model: deepseek-v31, choices: [ { index: 0, message: { role: assistant, content: The derivative of x^2 3x 1 is 2x 3. }, finish_reason: stop } ] }注意响应体中的model字段反映的是实际推理模型而x-vsr-selected-model头则是路由器在决策阶段选定的模型二者通常一致但通过头字段你能确认路由决策时的模型选择而不是请求方自行指定的模型。响应头不会被添加的情形文档明确了三种不会添加决策跟踪头的典型场景缓存命中Cache Hit响应直接来自缓存没有发生 VSR 处理。此时连决策头也不会输出在 v0.4 契约下缓存命中响应也不携带x-vsr-schema-version/x-vsr-response-path基础头缓存载荷原样透传。错误响应Error Responses上游返回 4xx 或 5xx 状态码。缺少 VSR 信息Missing VSR InformationVSR 决策信息不可用——正常运行时不应发生例如请求被跳过处理或决策阶段未执行。这些分支在源码测试中有逐一对应的断言。例如 src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersNotAddedOnCacheHit构造了VSRCacheHit: true的上下文断言headerMutation.GetSetHeaders()为空src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersNotAddedOnErrorResponse构造 500 状态码断言错误响应上只保留 2 个基础契约头x-vsr-schema-version与x-vsr-response-path而x-vsr-selected-category、x-vsr-selected-model等决策头一律不出现。源码级实现剖析响应头从决策到落盘1. 头常量定义所有自定义 HTTP 头遵循非标准头的x-前缀约定统一维护在 src/semantic-router/pkg/headers/headers.go。每个常量都有明确的 Go 注释说明取值语义与示例并被 src/semantic-router/pkg/headers/headers_test.go 的TestHeaderConstants断言锁定——防止头名字符串被意外改写。2. 响应头组装responseHeaderMutationBuildersrc/semantic-router/pkg/extproc/processor_res_header_mutation.go 中的responseHeaderMutationBuilder是响应头的组装器核心方法addString有两个值得注意的行为空值跳过value 为空字符串时不输出该头所以部分信息场景下空字段不会以空值头出现去重同一 key 只写入一次防止重复头。在此基础上addFinalDecisionHeaders 负责在每次成功响应上输出最终路由事实决策名、算法、所选模型、路由延迟毫秒数、回退尝试次数等其中包括x-vsr-selected-model而 addDecisionDetailHeaders 负责输出中间细节头x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-modality等。3. v0.4 契约下的默认面与调试面需要特别说明当前仓库源码v0.4 响应头契约已经对三类头做了分级这与 v0.2 文档描述一律附加的语义存在演进差异x-vsr-selected-model属于默认面default surface每次成功、未命中缓存的响应都会携带x-vsr-selected-category与x-vsr-selected-reasoning属于调试面debug surface默认被降级demote只有请求显式携带x-vsr-debug: true时才内联输出否则这些中间细节可通过x-vsr-replay-id在 Router Replay 记录中找回。该开关的判定实现在 src/semantic-router/pkg/extproc/debug_mode.go 的debugHeadersRequested对x-vsr-debug头取值做大小写不敏感、去空白的true匹配。对应测试 src/semantic-router/pkg/extproc/extproc_test.go 的TestVSRHeadersAddedOnSuccessfulNonCachedResponse明确断言未开 debug 时x-vsr-selected-category、x-vsr-selected-reasoning不出现在响应头中而 TestVSRDebugHeadersOnSuccessfulResponse 断言带上x-vsr-debug: true后它们恢复内联输出。同时TestVSRHeadersPartialInformation 还验证了空字段被正确省略。如果你在 v0.2 版本上做调试直接使用文档所述的三个头即可如果你面对的是更新版本v0.4记得在调试请求中追加x-vsr-debug: true才能看到分类与推理模式的中间细节。4. 决策信息的来源trackVSRDecision无论是自动路由还是显式模型选择决策信息最终都会汇聚到 src/semantic-router/pkg/extproc/recorder.go 的trackVSRDecisionfunc (r *OpenAIRouter) trackVSRDecision(ctx *RequestContext, categoryName string, decisionName string, matchedModel string, useReasoning bool) { ctx.VSRSelectedCategory categoryName ctx.VSRSelectedDecisionName decisionName ctx.VSRSelectedModel matchedModel if useReasoning { ctx.VSRReasoningMode on } else { ctx.VSRReasoningMode off } }这段代码印证了文档中的核心语义分类来自领域分类结果推理模式被映射为on/off两个枚举值模型选择记录最终选定的模型。实战场景一请求调试Debugging调试时你关心的是这个请求为什么被这样处理。此时你可以携带x-vsr-debug: true发起请求在支持 debug 面的新版本上用curl -i或浏览器开发者工具查看响应头对照三个核心字段判断分类、推理模式与模型是否符合预期。例如curl -i -H Content-Type: application/json \ -H x-vsr-debug: true \ -d {model:auto,messages:[{role:user,content:求 x^2 3x 1 的导数}]} \ http://router-address/v1/chat/completions响应头中如果出现x-vsr-selected-category: math与x-vsr-selected-reasoning: on说明领域分类把该数学问题归入math类别并启用了推理模型——这正是路由器的预期行为。实战场景二可观测与监控Monitoring运维团队可以利用这些头做面向请求的路由可观测性类别分布跟踪聚合x-vsr-selected-category的值分布了解请求的领域构成推理模式使用模式统计x-vsr-selected-reasoning: on/off的比例评估推理模型的启用成本模型选择模式分析跟踪x-vsr-selected-model的取值判断各模型被选中的频率辅助容量规划与配额设计。仓库中的基准测试工具直接消费这些头来做路由与成本核算。例如 bench/reasoning/router_accounting.py 定义了SELECTED_MODEL_HEADER x-vsr-selected-model、COST_HEADER x-vsr-cost等常量其注释明确指出每请求的路由与成本字段来自路由器响应头并通过response_accounting函数把selected_model、routing_latency_ms、cost等信息写入基准报告——这就是监控与分析场景在真实项目中的落地方式。实战场景三分析与产品洞察Analytics产品团队可以利用路由元数据回答以下问题请求分类准确性对照真实业务标签评估领域分类器的准确率推理模式有效性结合下游任务质量指标分析推理模式开/关的收益差异按类别评估模型表现以x-vsr-selected-category为维度切分模型性能与成本数据。端到端测试也把响应头当作断言事实来使用。例如 e2e/testcases/domain_classify.go 通过resp.Header.Get(x-vsr-selected-category)读取实际分类结果与期望类别比对来计算分类准确率result.ActualCategory resp.Header.Get(x-vsr-selected-category) result.ActualReasoning resp.Header.Get(x-vsr-selected-reasoning) result.Correct (result.ActualCategory expectedCategory)同样e2e/testcases/metadata_routing.go 断言x-vsr-selected-decision与x-vsr-selected-recipe的具体取值来验证元数据路由策略。这说明响应头本身就是该项目可验证的对外契约——头缺失或取值不对测试就会失败。兼容性解读与使用建议按版本区分头面在 v0.2 语义下三个决策头在成功非缓存响应上都会出现在更新的 v0.4 契约下x-vsr-selected-category与x-vsr-selected-reasoning被降级到调试面需要x-vsr-debug: true才能内联看到。消费方应优先依赖默认面的最终路由事实如x-vsr-selected-model把中间细节当作诊断信息。空值即省略源码中addString对空值直接跳过因此缺失该头可能意味着该决策未执行或信息不可用而不是解析错误。不要只依赖单头完整的路由故事决策名、置信度、算法、路由延迟、回退尝试次数分散在x-vsr-selected-decision、x-vsr-selected-confidence、x-vsr-selected-algorithm、x-vsr-routing-latency-ms、x-vsr-fallback-attempts等多个默认面头中建议组合消费需要细粒度中间轨迹时通过x-vsr-replay-id关联 Router Replay 记录。成本核算注意事项x-vsr-selected-model反映的是路由决策选定的模型若要按该模型计算费用应结合响应体中的 usage 信息与路由器提供的成本头如x-vsr-cost、x-vsr-cost-currency一起使用——如 bench/reasoning/router_accounting.py 所示其成本基数是配置价格configured pricing而非供应商账单。总结x-vsr-selected-category、x-vsr-selected-reasoning、x-vsr-selected-model是 semantic-router 路由决策的黑盒探针把分类、推理与模型选择三个关键决策以标准 HTTP 头的形式暴露在成功响应上。它们既服务于开发者的请求级调试也支撑运维的类别/模式/模型分布监控还能作为产品分析与成本核算的原始数据。理解其触发条件成功、未命中缓存、执行了决策、源码写入链路trackVSRDecision→buildResponseHeaderMutation→ Envoy HeaderMutation以及版本间的头面差异默认面 vs 调试面你就能在真实部署中准确解读每一次路由决策。赞分享后端API网关模型推理服务AI Agent【免费下载链接】semantic-routerAn open, programmable decision layer for models and compute.项目地址https://gitcode.com/gh_mirrors/sem/semantic-router点击查看免费下载相关推荐Semantic Router VSR 决策追踪 Header 完全指南从三个核心响应头到 v0.4 双层合约Semantic Router VSR 决策追踪 Header 完全指南从三个核心响应头到 v0.4 双层合约 导读 本文围绕 Semantic Router后端API网关模型推理服务AI Agentsemantic-router VSR 决策追踪 Header 完整指南类别、推理模式与模型选择的可观测性semantic router VSR 决策追踪 Header 完整指南类别、推理模式与模型选择的可观测性 导读 VSRVector Semantic Ro后端API网关模型推理服务AI AgentBetterDiscordPanel高级技巧自定义翻译、主题切换与消息格式化指南BetterDiscordPanel高级技巧自定义翻译、主题切换与消息格式化指南 BetterDiscordPanel是一款强大的自托管Discord机器人消创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考