RAG 知识库
RAG（Retrieval-Augmented Generation，检索增强生成）是 AI Agent 的可选增强模块，通过向大模型注入知识库文档内容，让 AI 能够回答软件使用、业务规则等特定领域的问题。
💬 功能简介
知识库系统支持上传 Markdown、TXT 等文档，系统会自动完成分块、向量化、存储。当 AI Agent 处理用户消息时，会先检索知识库中相关的文档片段并注入给 AI，让 AI 基于你的文档内容回答问题。
配置指南
在旺财狗管理界面中，进入 AI管理 → 知识库配置 页面。
知识库开关
知识库有两级开关，都开启才生效：
- 机器人级开关：AgentConfig 中的
knowledge_enabled - 角色级开关：AgentRole 中的
knowledge_enabled
角色还可以通过 knowledge_base 字段绑定特定的知识库标识，实现不同角色使用不同知识库。
检索引擎配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 检索引擎 | qdrant（推荐）或 memory（内存模式） | memory |
| Qdrant地址 | Qdrant 服务地址 | http://localhost:6333 |
| 自动启动Qdrant | 是否自动下载并启动内嵌 Qdrant | 开启 |
| 检索条数 | 检索返回的文档片段数量 | 3 |
💡 Qdrant vs 内存模式
- Qdrant模式（推荐）：使用专业向量数据库，性能更好，支持大规模文档
- 内存模式：无需额外服务，适合小规模文档测试，每次启动需重新加载
Embedding 配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 向量模型名称 | 如 text-embedding-3-small | - |
| Embedding API地址 | 向量化 API 地址 | 默认跟随AI配置 |
| Embedding API Key | 向量化 API 密钥 | 默认复用AI Key |
| 向量维度 | 向量维度（需与模型匹配） | 1536 |
💡 提示
Embedding 配置为空时默认跟随 AI 配置自动填充。如果向量化服务与对话服务不同，请单独配置。
支持的向量模型
系统自动根据模型名称调整分块大小：
| 模型 | 建议分块大小 | 向量维度 |
|---|---|---|
| text-embedding-3-small | 400字 | 1536 |
| text-embedding-3-large | 400字 | 3072 |
| bge-large-zh | 400字 | 1024 |
| bge-m3 | 2000字 | 1024 |
| Qwen3-Embedding | 4000字 | 1024 |
| bce-embedding-base | 400字 | 768 |
Qdrant 自动部署
系统内置 Qdrant 向量数据库的自动下载和启动功能，无需手动安装。
💡 自动部署
在知识库配置页面开启「自动启动Qdrant」后，系统会自动下载并启动 Qdrant（随主程序启动/停止），支持运行时热启动，无需重启旺财狗，下载进度会在管理界面实时展示。
文档管理
在 AI管理 → 知识库文档 页面管理知识库文档。
上传文档
支持以下方式添加文档：
- 文件上传：上传 Markdown（.md）或文本（.txt）文件
- 粘贴文本：直接粘贴文本内容
- 目录批量导入：输入服务器上的目录路径，自动导入目录下所有 Markdown 文件
文档分块
系统会对文档进行智能分块处理：
- 按文档标题层级（H1-H4）自动切分
- 代码块内容保持完整，不被截断
- 长段落按中英文标点自动切分
- 自动去除加粗、斜体、链接等排版语法，保留代码块和图片说明
💡 VitePress 支持
支持导入 VitePress 文档，自动识别文档标题。
目录批量导入
批量导入支持增量同步：仅更新有变化的文档，自动按目录名归类。
文档状态
每个文档有以下状态：
| 状态 | 说明 |
|---|---|
| 等待处理 | 已上传，尚未开始 |
| 向量化中 | 正在处理 |
| 已完成 | 向量化完成 |
| 失败 | 处理出错 |
知识库测试
在 AI管理 → 知识库测试 页面可以测试检索效果：
- 输入测试问题
- 系统将问题向量化并检索知识库
- 展示检索到的文档片段和相似度分数
- 可用于调优 Embedding 模型和检索参数
使用场景示例
场景1：软件使用向导
- 将旺财狗教程网站的 Markdown 文件批量导入知识库
- 创建「软件使用向导」角色，绑定该知识库
- 用户询问"怎么配置返利？"时，AI 会从教程中检索相关内容并回答
场景2：业务规则问答
- 将业务规则文档（退换货政策、佣金规则等）上传到知识库
- 在客服角色中启用知识库
- AI 回答用户问题时会引用业务规则文档内容
⚠️ 注意事项
- 知识库内容仅作为 AI 回答的参考，AI 可能会基于内容进行改写
- 建议定期更新知识库文档，保持与实际业务一致
- 大量文档建议使用 Qdrant 模式，内存模式启动时需重新加载所有向量
- Embedding 模型和维度一旦设置，不要随意更改，否则需要重新向量化所有文档