跳到主要内容
vLLM Semantic Router

构建你的Mixture-of-Models

将信号与偏好转化为跨异构 LLM 的可执行模型路径。

Mixture-of-Models
Why Semantic Router

Intelligent multi-model routing

Deploy fast, route by signal, and keep every decision observable.

Signal-driven

16signal families

Classify intent, safety, and domain signals — then route each request to the right model.

Drop-in

1OpenAI-compatible API

Deploy as Envoy ExtProc or local vllm-sr. No client changes for existing integrations.

Observable

12routing algorithms

From rules to reinforcement learning — every routing decision is configurable and measurable.

How it integrates

Route queries to the right model

The decision engine classifies each request and picks the best model in your fleet. Clients keep the same OpenAI-compatible API.

RoutingQuery 1 Mistral
Incoming queries
  • Query 1Sending
  • Query 2
  • Query 3
  • Query 4
  • Query 5
  • Query 6
vLLM Semantic Router
  • Signal layer
  • Decision engine
  • Plugins
Security & policyObservability & replay
Models
Closed models
  • Claude
    Claude
  • OpenAI
    ChatGPT
  • Gemini
    Gemini
Open models
  • Mistral
    MistralQuery 1
  • DeepSeek
    DeepSeek
  • Zhipu
    GLM

Heterogeneous models

架构

统一异构推理。

在四个维度上统一碎片化的模型生态。

了解工作原理
维度当下的碎片化使用 vLLM SR
模型
当下的碎片化

不同模型擅长不同任务。

使用 vLLM SR

组合个性化模型路径。

算力
当下的碎片化

GPU、加速器、边缘与云端算力并存。

使用 vLLM SR

跨异构算力完成路由。

位置
当下的碎片化

推理横跨边缘、私有环境与云端。

使用 vLLM SR

让数据始终留在边界之内。

偏好
当下的碎片化

“最佳”因用户与负载而变化。

使用 vLLM SR

让每一种偏好都可执行。

信号16

16 类信号,覆盖启发式与学习式检测,从知识库路由到历史感知 reask。

选择器12

12 种路由策略,覆盖规则、时延启发式、强化学习与机器学习选择。

论文18

18 篇研究论文,覆盖路由、系统、安全与多模态。

行业声音

下一代模型架构正在形成。

System-level optimizationMark PapermasterAMD CTO & EVP
We’ve become system optimizers, still optimizing every component, but then equally looking at how you optimize how each of the pieces come together.来源theCUBE at RAISE Summit · 2026

路由蓝图

从信号到模型路径。

探索架构如何提取信号、组合决策并执行选定的模型路径。

香农映射

从通信理论到路由流水线的结构映射。

用户请求是在编码前的原始源消息。

信号智能

生成之前,先理解。

专用编码器在选择生成模型之前,先提取意图、上下文、安全与模态信号。

信号入口面

序列分类、token 标注、嵌入检索和重排序,最终汇合成同一层系统智能。

Input
"Is machine learning related to AI?"
Tokenizer
[CLS]IsmachinelearningrelatedtoAI?[SEP]
Embedding
Token Emb
Segment Emb
Position Emb
h₀ = Σ
Encoder Block
×N
ATTNMulti-Head Attention
NORMAdd & Norm
FFNFeed-Forward
NORMAdd & Norm
Signals
CLS
Sentence-Level (CLS Token)[CLS] → Linear Head → "computer science"TaskType: SEQ_CLS
DomainJailbreakFact-checkFeedbackModality
BIE

Bi-Encoder 嵌入

独立编码查询和候选项为稠密向量,用于相似度搜索和语义缓存。

XCE

Cross-Encoder 学习

联合交叉注意力评分查询-候选对,实现高精度重排序。

CLS

分类

基于自研 BERT 的领域、越狱、PII 和事实核查的分类器,覆盖多个 signal

ATT

全注意力

跨 token 和句子的双向注意力 — 双向完整上下文,非因果掩码。

2DM

2DMSE

推理时自适应调整嵌入层数和维度,按需平衡计算量与精度。

MRL

MRL

无需重训即可截断嵌入向量到任意维度 — 按请求平衡精度与速度。

快速上手

一条命令,本地跑起来。

只保留一条官方支持的本地启动路径:复制安装命令,执行后即可进入控制台。 首跑路径收敛为一个安装脚本,负责在 macOS 和 Linux 上配置 CLI 与本地服务流程。

Local install pathOne command to start
  1. Install the CLI

    macOS / Linux

    Downloads the installer, prepares Docker, and writes vllm-sr to your PATH.

    shell
    curl -fsSL https://vllm-sr.ai/zh-Hans/install.sh | bash
    Remove local install

    Removes ~/.local/share/vllm-sr and ~/.local/bin/vllm-sr. Stop any running serve session first.

    remove
    rm -rf ~/.local/share/vllm-sr && rm -f ~/.local/bin/vllm-sr

默认安装到 ~/.local/share/vllm-sr,写入 ~/.local/bin/vllm-sr;Windows 仍按文档中的手动 pip 方式安装。

How it works

One router, three use cases

See how signals, policies, and models connect for every request.

Universal compatibility

One router, any deployment

Run on gateways, Kubernetes, or locally — with 16 signal families for every request.

研究

这些论文,构成了路由器的底层思路。

从安全、多模态到编排与系统设计,这些研究线索持续塑造 vLLM Semantic Router 的演进方向。

2026 / 论文立场论文

vLLM Semantic Router: Signal Driven Decision Routing for Mixture-of-Modality Models

vLLM Semantic Router Team

arXiv 技术报告

We introduce vLLM Semantic Router, a signal-driven decision routing framework for Mixture-of-Modality deployments that composes heterogeneous signals into deployment-specific routing policies across cost, privacy, latency, and safety constraints.

2026 / 论文愿景论文

The Workload-Router-Pool Architecture for LLM Inference Optimization: A Vision Paper from the vLLM Semantic Router Project

Huamin Chen, Xunzhuo Liu, Bowei He, Fuyuan Lyu, Yankai Chen, Xue Liu, Yuhan Liu, Junchen Jiang

arXiv 技术报告

We synthesize the project’s recent routing, fleet, multimodal, and governance results into the Workload-Router-Pool (WRP) architecture, connecting signal-driven routing to a full-stack inference optimization framework and outlining future research directions across workload, router, and pool design.

2026 / 论文

Visual Confused Deputy: Exploiting and Defending Perception Failures in Computer-Using Agents

Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen

arXiv 技术报告

We formalize the visual confused deputy as a security failure mode in computer-using agents and introduce a dual-channel guardrail that independently checks click targets and action reasoning before execution.

2026 / 论文

Outcome-Aware Tool Selection for Semantic Routers: Latency-Constrained Learning Without LLM Inference

Huamin Chen, Xunzhuo Liu, Junchen Jiang, Bowei He, Xue Liu

arXiv 技术报告

We introduce Outcome-Aware Tool Selection (OATS), an offline embedding refinement method that improves semantic-router tool ranking under single-digit millisecond CPU budgets without adding serving-time model inference.

2026 / 论文

Adaptive Vision-Language Model Routing for Computer Use Agents

Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen

arXiv 技术报告

We propose Adaptive VLM Routing (AVR), which estimates action difficulty and routes computer-use agent steps to the cheapest model that still satisfies a target reliability threshold.

2026 / 论文

98× Faster LLM Routing Without a Dedicated GPU: Flash Attention, Prompt Compression, and Near-Streaming for the vLLM Semantic Router

Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen

arXiv 技术报告

We combine Flash Attention, prompt compression, and near-streaming body processing to cut routing latency from seconds to tens of milliseconds while keeping the router lightweight enough to share hardware with serving.

2026 / 论文

inference-fleet-sim: A Queueing-Theory-Grounded Fleet Capacity Planner for LLM Inference

Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu

arXiv 技术报告

We present a queueing-theory-grounded fleet planner and discrete-event simulator for sizing multi-pool LLM GPU fleets against P99 TTFT targets, without requiring hardware profiling runs up front.

2026 / 论文

FleetOpt: Analytical Fleet Provisioning for LLM Inference with Compress-and-Route as Implementation Mechanism

Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu

arXiv 技术报告

We derive the minimum-cost two-pool LLM fleet directly from the workload CDF and P99 TTFT target, then use Compress-and-Route to make the optimal boundary deployable in practice.

2026 / 论文

The 1/W Law: An Analytical Study of Context-Length Routing Topology and GPU Generation Gains for LLM Inference Energy Efficiency

Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu

arXiv 技术报告

We derive the 1/W law showing that tokens per watt roughly halve whenever the serving context window doubles, making context-length routing topology a larger energy-efficiency lever than a pure GPU generation upgrade.

2026 / 论文

Conflict-Free Policy Languages for Probabilistic ML Predicates: A Framework and Case Study with the Semantic Router DSL

Xunzhuo Liu, Hao Wu, Huamin Chen, Bowei He, Xue Liu

arXiv 技术报告

We show how probabilistic ML predicates in policy languages can silently co-fire on the same query, and implement conflict detection plus a softmax-based prevention mechanism in the Semantic Router DSL.

2026 / 论文

From Inference Routing to Agent Orchestration: Declarative Policy Compilation with Cross-Layer Verification

Huamin Chen, Xunzhuo Liu, Bowei He, Xue Liu

arXiv 技术报告

We extend the Semantic Router DSL from stateless, per-request routing to multi-step agent workflows, emitting verified decision nodes for orchestration frameworks, Kubernetes artifacts, YANG/NETCONF payloads, and protocol-boundary gates from a single declarative source file.

2026 / 论文

Knowledge Access Beats Model Size: Memory Augmented Routing for Persistent AI Agents

Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen

arXiv 技术报告

We show that conversational memory and retrieval-grounded routing let a lightweight 8B model recover most of a 235B model’s performance on persistent user-specific queries while cutting effective inference cost by 96%.

2026 / 论文RAG 验证

Fast and Faithful: Real-Time Verification for Long-Document Retrieval-Augmented Generation Systems

Xunzhuo Liu, Bowei He, Xue Liu, Haichen Zhang, Huamin Chen

SIGIR 2026 Industry Track

We present a real-time verification component for long-document RAG that processes contexts up to 32K tokens, balancing latency and grounding coverage so interactive systems can detect unsupported answers without falling back to truncated checks.

2026 / 论文

Token-Budget-Aware Pool Routing for Cost-Efficient LLM Inference

Huamin Chen, Xunzhuo Liu, Junchen Jiang, Bowei He, Xue Liu

arXiv 技术报告

We propose token-budget-aware pool routing, which estimates each request’s total token budget using a self-calibrating bytes-per-token ratio and dispatches it to short or long vLLM pools to cut fleet cost while avoiding KV-cache failures.

2025 / 论文

When to Reason: Semantic Router for vLLM

Chen Wang, Xunzhuo Liu, Yuhan Liu, Yue Zhu, Xiangxi Mo, Junchen Jiang, Huamin Chen

NeurIPS - MLForSys

We present a semantic router that classifies queries based on their reasoning requirements and selectively applies reasoning only when beneficial.

2025 / 论文

Category-Aware Semantic Caching for Heterogeneous LLM Workloads

Chen Wang, Xunzhuo Liu, Yue Zhu, Alaa Youssef, Priya Nagpurkar, Huamin Chen

We present a category-aware semantic caching where similarity thresholds, TTLs, and quotas vary by query category, with a hybrid architecture separating in-memory HNSW search from external document storage.

2025 / 论文

Semantic Inference Routing Protocol (SIRP)

Huamin Chen, Luay Jalil

互联网工程任务组(IETF)

This document specifies the Semantic Inference Routing Protocol (SIRP), a framework for content-level classification and semantic routing in AI inference systems.

2025 / 论文

Multi-Provider Extensions for Agentic AI Inference APIs

H. Chen, L. Jalil, N. Cocker

Internet Engineering Task Force (IETF) - Network Management Research Group

This document specifies multi-provider extensions for agentic AI inference APIs. Published: 20 October 2025. Intended Status: Informational. Expires: 23 April 2026.

社区

来自研究、基础设施与模型系统的维护者,共同塑造这个项目。

指导委员会

Xunzhuo Liu

LLM Routing @ vLLM

指导委员会

Huamin Chen

@Microsoft

指导委员会

Bowei He

Postdoc @ MBZUAI / McGill

指导委员会

Yankai Chen

Postdoctoral Associate @ McGill University / MBZUAI

指导委员会

Fuyuan Lyu

PhD Candidate @ McGill University / Mila

指导委员会

Steve Liu

@MBZUAI / McGill / Mila

提交者

FAUST

云原生开源贡献者 @Tongji University

提交者

David Shrader

GTM Tech Lead @Google

提交者

yangw

云原生工程师 @DaoCloud

提交者

Ramakrishnan Sathyavageeswaran

计算机科学工程师 @Intuit

提交者

WUKUNTAI

软件工程师 @DELTA ELECTRONICS, INC.

提交者

Aayush Saini

SDE, Data and AI @Red Hat

提交者

siloteemu

开源贡献者

提交者

Chen Wang

高级研究科学家 @IBM

提交者

Yue Zhu

研究科学家 @IBM

提交者

Senan Zedan

研发经理 @Red Hat

提交者

Yossi Ovadia

高级首席工程师 @Red Hat

提交者

samzong

AI 基础设施 / 云原生产品经理 @DaoCloud

提交者

Liav Weiss

软件工程师 @Red Hat

提交者

Asaad Balum

高级软件工程师 @Red Hat

提交者

Yehudit

软件工程师 @Red Hat

提交者

Noa Limoy

软件工程师 @Red Hat

提交者

Marina Koushnir

开源贡献者 @Red Hat

提交者

JaredforReal

软件工程师 @Z.ai

提交者

Abdallah Samara

高级软件工程师 @Red Hat

提交者

Hen Schwartz

软件工程师 @Red Hat

提交者

Srinivas A

软件工程师 @Yokogawa

提交者

carlory

开源工程师 @DaoCloud

提交者

Jintao Zhang

高级软件工程师 @Kong

提交者

yuluo-yx

个人贡献者

提交者

cryo-zd

个人贡献者

提交者

OneZero-Y

个人贡献者

提交者

aeft

个人贡献者

提交者

Hao Wu

个人贡献者

提交者

Qiping Pan

个人贡献者

认识把 Mixture-of-Models 变成共享基础设施的构建者。

查看团队名单
开始构建

组合你的 Mixture-of-Models。

用信号、偏好与策略塑造每一条模型路径。