DeepSeek12-Open WebUI 知识库配置详细步骤_openwebui知识库如何使用

📚 Open WebUI 知识库配置详细步骤（中英文对照）

🌐 界面语言切换

# 首次登录后切换语言：1. 点击左下角用户头像 → Settings2. 在 \"General\" 选项卡找到 \"Language\"3. 选择 中文(简体)/English4. 点击 \"Save\"

---

🔧 一、上传文档（知识库创建）

步骤 中文界面 English Interface 操作说明 1 左侧菜单 → 工作空间 → 知识库 Left Menu → WorkSpace → Knowledge 进入知识库管理页面 2 点击 + 新建知识库 Click + New Knowledge Base 创建新知识库容器 3 输入知识库名称 (如\"产品手册\") Enter name (e.g.“Product Docs”) 仅支持英文/数字命名 4 点击 上传文件 Click Upload Files 打开文件选择对话框 5 选择文档 (PDF/DOCX/TXT/MD) Select files (支持多选) 最大20MB/文件 6 确认上传 → 等待处理完成 Confirm → Wait for processing 状态栏显示处理进度

1. 前提条件

• 已安装 Open WebUI 0.6.13（通过 Docker 或 pip 安装）。
• 已配置本地大语言模型（如 Ollama、DeepSeek 或 Hugging Face 模型）。
• 确保已启动相关依赖服务（如 Ollama）。

---

2. 创建知识库

步骤 1：进入工作空间

1. 登录 Open WebUI 后，点击左侧导航栏的 工作空间。
2. 在 知识库 子菜单下，点击 + 新建知识库。

步骤 2：配置知识库基本信息

1. 名称：输入知识库名称（如 公司政策）。
2. 描述：简要说明知识库用途（可选）。
3. 模型选择：
   • 在 模型 下拉菜单中选择已配置的本地模型（如 deepseek-r1）。
   • 注意：此版本无 RAG 菜单项，需通过模型绑定实现知识库功能。

步骤 3：上传文档

1. 点击 上传文档，支持以下格式：
   • 文本文件（.txt）
   • PDF 文件（.pdf）
   • Markdown 文件（.md）
2. 上传后，系统会自动解析并生成索引（无需手动触发）。

步骤 4：验证知识库

1. 在对话界面选择已绑定的模型（如 test_model）。
2. 输入与上传文档相关的问题，观察是否返回知识库中的内容。
3. 若未返回结果，检查日志（路径：设置 > 日志）排查解析错误。

---

⚠️ 注意：中文文档需确认编码为 UTF-8，否则会出现乱码

---

⚙️ 二、高级配置（核心设置）

配置语义向量模型

1. 进入 设置 > 管理员设置 > 文档。
2. 在 语义向量模型 部分：
   • 模型引擎：选择 Ollama 或 HuggingFace。
   • 模型名称：输入已部署的模型名称（如 bge-large）。
3. 保存配置并重启服务生效。

调整存储路径

1. 修改配置文件（如 config.yaml）：

   knowledge_base: storage_path: \"/your/custom/path\"

文件上传限制

修改上传限制（如 config.yaml）：

upload: allowed_extensions: [\".pdf\", \".txt\", \".md\"] max_file_size: 100000000 # 100MB

重启 Open WebUI 服务：

---

⚡ 三、高级设置（文本处理优化）

中英文通用配置位置：

高级选项 → 文本处理

参数 推荐值 说明 分块大小/chunk_size 1024 文本切片长度（token数） 分块重叠/chunk_overlap 128 切片间重叠避免信息割裂 元数据提取 ☑ 启用 提取标题/作者等关键信息 中文专用分词器 ☑ 启用 提升中文文档处理精度 (中文界面) Chinese Tokenizer ☑ Enable Optimize Chinese processing (英文界面)

# 配置文件示例chunking: size: 1024 overlap: 128metadata_extraction: truelanguage_optimization: zh: true # 中文优化

---

🎯 四、领域指令设置（Prompt 优化）

中文界面路径：

高级选项 → 指令模板

[系统] 你是一个{domain}领域专家，请根据知识库内容回答。回答要求：1. 使用专业术语2. 引用来源片段3. 不确定时回复\"根据现有资料无法确定\"当前领域：医疗/法律/金融 (手动修改)

English Interface Path:

Advanced → Instruction Template

[System] You are a {domain} specialist. Answer based strictly on knowledge base.Requirements:1. Use professional terminology2. Cite source snippets3. Respond \"Unanswerable\" when uncertainCurrent Domain: Medical/Legal/Finance (Edit manually)

---

✅ 五、验证与测试

1. 知识库状态检查

   • 中文路径：知识库详情 → 处理日志
   • 英文路径：Knowledge Details → Processing Logs
   • 成功标志：

     ✅ 文档解析完成✅ 向量生成: X 个分块

2. 问答测试

   测试问题示例：中文：\"产品X的主要功能是什么？\"English: \"What are the main features of Product X?\"

3. 结果验证

   • 点击回答区域的 来源/Sources 标签
   • 检查：

     1. 引用片段是否相关2. 页码标注是否准确3. 领域术语使用是否正确

💡 性能提示：首次检索较慢（需加载模型），后续请求响应应在 2-5 秒内

© 著作权归作者所有