102 lines
2.7 KiB
Markdown
102 lines
2.7 KiB
Markdown
# 知识库配置修复通知
|
||
|
||
## 问题说明
|
||
|
||
如果您遇到以下情况：
|
||
- ✅ 知识库文件显示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目录下的最新日志）
|