qiweimanager-master/config/docs/用户通知_知识库配置修复.md

知识库配置修复通知

问题说明

如果您遇到以下情况：

• ✅ 知识库文件显示10个，但查询时AI只能看到2个
• ✅ 知识库页面出现错误：Unsupported model 'gte-rerank-v2' for OpenAI compatibility mode

这是因为模型配置填写错误导致的。

问题原因

Embedding 模型 和 Rerank 模型 填写混淆了！

错误配置示例 ❌

Embedding 模型: gte-rerank-v2  ← 这是Rerank模型，填错了！
Rerank 模型: qwen3-rerank      ← 正确

正确配置示例 ✓

Embedding 模型: text-embedding-v4  ← 正确：用于文本向量化
Rerank 模型: qwen3-rerank           ← 正确：用于结果重排序

如何修复

方法1：自动修复（推荐）

更新到最新版本后：

1. 系统会自动检测并修正错误配置
2. 打开"自动客服"页面
3. 进入"知识库"模块
4. 点击"重建索引"按钮
5. 等待重建完成（可能需要几分钟）

方法2：手动修复

1. 打开"自动客服"页面
2. 进入"知识库"模块
3. 找到模型配置区域
4. 将 Embedding 模型 改为：text-embedding-v4
5. 将 Rerank 模型 改为：qwen3-rerank（如果之前填写的是embedding模型）
6. 点击"保存配置"
7. 点击"重建索引"

模型选择指南

Embedding 模型（文本向量化）

推荐使用以下模型之一：

• text-embedding-v4 （推荐，512维）
• text-embedding-v3 （1024维）
• bge-large-zh
• gte-large

Rerank 模型（结果重排序）

推荐使用以下模型之一：

• qwen3-rerank （推荐）
• gte-rerank-v2
• bge-rerank-large

新版本改进

最新版本包含以下改进：

1. ✨ 自动检测并修正错误的模型配置
2. ✨ 更友好的错误提示信息
3. ✨ 输入框下方添加了说明文字和示例
4. ✨ 保存前会验证配置是否正确

注意事项

⚠️ 不要将模型名称混淆：

• Embedding 模型通常包含 "embedding" 关键词
• Rerank 模型通常包含 "rerank" 关键词

⚠️ 重建索引需要时间：

• 10个MD文件大约需要1-3分钟
• 重建期间不影响正常使用
• 重建完成后查询结果会更准确

验证修复

修复后，可以通过以下方式验证：

1. 查看"知识库"模块的状态

   • 知识文件数量应显示正确（如：10个）
   • 知识片段数量应显示正确（如：389个）
   • 向量片段数量应与知识片段相同或接近

2. 测试查询

   • 询问："现在知识库有哪些文件"
   • AI应该能列出所有10个文件
   • 不应再出现404错误

技术支持

如果按照以上步骤操作后问题仍未解决，请联系技术支持并提供：

1. 错误截图
2. 当前的模型配置截图
3. 日志文件（Log目录下的最新日志）