知识库 = 你上传的文档 + AI 检索系统。Agent 对话时,先从知识库找相关内容, 再基于找到的内容回答,每个回答都附引用编号 [1] [2] [3]。

适用场景:

• 📚 产品手册 + FAQ → 智能客服 Agent
• 📄 公司制度 + 流程 → HR 助手 Agent
• 🎓 课件 + 教材 → 课程答疑 Agent
• 📑 合同模板 + 法规 → 法务 Agent
• 🔬 论文 + 实验数据 → 研究助手 Agent

1. 左侧栏点击"知识库" → 右上角"+ 新建知识库"
2. 填写信息:
   • 名称:例如"产品手册库"
   • 描述:可选,方便管理
   • 嵌入模型:默认 bge-m3(中文友好,免费),也可选 OpenAI text-embedding-3-large(更准但收费)
   • 切块策略:段落 / 标题 / 问答对(默认段落)
3. 点击"创建",跳转到知识库详情页

1. 知识库详情页点击"上传文档"或拖拽文件到上传区
2. 选择文件(可批量),支持:PDF / Word / Excel / PPT / TXT / Markdown / HTML / EPUB / 图片(OCR)
3. 点击"开始上传",系统自动:
   • 📄 解析:提取文字、表格、图片(扫描件自动 OCR)
   • ✂️ 切块:按段落切成 500 字左右的片段
   • 🔢 向量化:把片段转成 1024 维向量
   • 💾 入库:存到 PostgreSQL + pgvector
4. 处理进度实时显示,1MB 文档约 10 秒
5. 状态变为"✅ 已就绪"后即可使用

⚠️ 大小限制:单文件 100MB,单个知识库总容量 1GB(免费)/ 10GB(Pro)/ 100GB(团队)。

1. 知识库详情页 → "检索测试"标签
2. 输入测试问题,例如:产品 X 的保修期是多久?
3. 点击"测试检索",系统返回 Top-5 相关片段
4. 查看片段是否准确,若不准可调整:
   • 切块策略(段落 → 问答对)
   • 嵌入模型(bge-m3 → OpenAI text-embedding-3-large)
   • 文档质量(删除扫描件 / 拆分大文档)

💡 验证标准:Top-5 中包含正确答案片段 ≥ 90% 即可挂载到 Agent。

1. 左侧栏"我的 Agent" → 编辑目标 Agent
2. 左侧"知识库"区域 → "+ 添加知识库"
3. 选择刚创建的知识库(可挂多个)
4. 设置检索参数:
   • Top-K:检索片段数(默认 5,范围 1-20)
   • 相似度阈值:0-1,低于阈值的片段丢弃(默认 0.5)
   • Rerank:开启后用 Cross-Encoder 重排,质量更高(消耗积分)
5. 保存,Agent 对话时自动检索知识库

💡 验证 Agent 已挂载:对话时提问知识库内容,回答应附引用 [1] [2],点击引用可跳转原文。

• 查看:知识库详情页 → 文档列表
• 重新处理:文档右键 → 重新解析(更新文档内容后)
• 删除:文档右键 → 删除(从知识库移除,原文件不动)
• 下载:文档右键 → 下载原文件
• 查看切片:文档右键 → 查看切片(检查切块效果)
• 批量操作:勾选多个文档 → 批量删除 / 重新处理