什么是重排序？为什么它如此重要？
重排序（Reranking）是 Open WebUI 检索系统中的智能优化模块。想象你在图书馆找书，初始搜索可能返回 100 本相关书籍，而重排序功能则像一位专业的图书管理员，根据你的具体需求将最匹配的 10 本放在最前面展示。
在 Open WebUI 中，重排序功能通过以下核心模块实现：
- 重排序模型实现：位于
backend/open_webui/retrieval/models/目录 - 检索 API 路由：
backend/open_webui/routers/retrieval.py - 向量检索核心：
backend/open_webui/retrieval/vector/
重排序功能完整工作流程
重排序在检索流程中扮演着至关重要的角色，其完整工作流程如下：
![重排序工作流程图]
- 初始检索阶段：系统从知识库中快速获取相关文档
- 向量匹配计算：通过嵌入模型计算文档与查询的语义相似度
- 智能重排序：重排序模型对初始结果进行深度分析和二次评分
- 结果优化输出：按优化后的相关性顺序展示最终结果
快速上手：重排序功能配置四步法
第一步：选择合适重排序模型
Open WebUI 支持多种重排序模型，推荐选择如下：
| 模型名称 | 性能特点 | 适用场景 | 资源需求 |
|---|---|---|---|
| jinaai/jina-colbert-v2 | 轻量高效，响应迅速 | 日常对话和普通文档检索 | CPU 环境，内存≥2GB |
| cross-encoder/ms-marco-MiniLM-L-6-v2 | 精度优先，深度理解 | 专业文献和技术文档检索 | GPU 推荐，内存≥4GB |
第二步：修改核心配置文件
通过修改配置文件启用重排序功能：
# 在 config.py 中配置关键参数
RAG_RERANKING_MODEL = "jinaai/jina-colbert-v2"
ENABLE_RAG_HYBRID_SEARCH = True
TOP_K = 8
第三步：设置环境变量
在部署环境中配置以下环境变量：
RAG_RERANKING_MODEL="jinaai/jina-colbert-v2"
ENABLE_RAG_HYBRID_SEARCH="true"
TOP_K="8"
第四步：验证配置生效
通过管理界面或 API 检查重排序功能是否正常启用。
高级配置：参数调优与性能优化
关键参数详解与调优建议
| 参数名称 | 功能描述 | 推荐值范围 | 调优策略 |
|---|
