跳到主要内容

使用指南

知识库支持存储、组织和检索文档，实现 RAG（检索增强生成），让 AI 智能体能够基于您的特定文档回答问题。

📋 目录​

🎯 概述​

什么是知识库？​

知识库是一个文档存储和检索系统，支持 RAG（检索增强生成）。它允许 AI 智能体搜索您的文档，并提供基于您特定内容的答案。

核心价值​

价值描述
有据可依的回答AI 基于您的文档回答，而非仅靠通用知识
来源引用每个答案都包含对源文档的引用
智能分块针对检索优化的自动文档分割
灵活检索向量、关键词或混合搜索模式

🏗 架构说明​

RAG 流程​

下图展示了 RAG（检索增强生成）的工作原理：

关键组件​

组件用途
知识库包含文档和检索配置的容器
文档单个文件或内容项
文档块为检索优化的文档片段
检索器搜索后端服务（Elasticsearch/Qdrant）
嵌入模型将文本转换为向量用于相似度搜索

🆕 创建知识库​

步骤 1：导航到知识库​

  1. 登录 Wegent
  2. 在侧边栏导航到 知识库 部分
  3. 点击 创建知识库

步骤 2：配置基本设置​

字段描述示例
名称显示名称（1-100 字符）"产品文档"
描述可选描述（最多 500 字符）"内部产品文档和指南"
类型笔记本或经典笔记本

步骤 3：配置检索设置​

检索器选择​

选择已配置的检索器（后端搜索服务）：

检索器类型描述
Elasticsearch支持向量的全文搜索
Qdrant专用向量数据库

嵌入模型​

选择用于向量转换的嵌入模型：

模型维度适用场景
text-embedding-3-small1536通用场景，性价比高
text-embedding-3-large3072更高准确度

检索模式​

模式描述适用场景
向量语义相似度搜索自然语言查询
关键词传统 BM25 文本搜索精确词条匹配
混合向量 + 关键词组合综合最佳效果

检索参数​

参数范围默认值描述
top_k1-105返回结果数量
score_threshold0.0-1.00.7最低相关度分数

⚙️ 检索配置​

配置说明​

检索配置决定如何从知识库中查找信息：

  1. 检索器：选择后端搜索服务
  2. 嵌入模型：选择文本向量化模型
  3. 检索模式：向量、关键词或混合
  4. 参数调整：top_k、score_threshold 等

无 RAG 模式​

您可以在不配置检索器的情况下创建和使用知识库。在此模式下，AI 使用浏览工具（kb_ls、kb_head）来查看文档内容，而不是语义搜索。

🧪 检索测试​

检索测试功能允许您在保存配置前测试检索效果。

使用检索测试​

  1. 在知识库页面点击 检索测试 按钮
  2. 输入测试查询
  3. 选择检索模式（向量/关键词/混合）
  4. 调整参数：
    • score_threshold：相关度阈值
    • top_k：返回结果数量
  5. 查看检索结果和相关度分数

🤖 与智能体集成​

在对话中选择知识库​

与智能体对话时：

  1. 点击聊天输入框附近的 上下文选择器
  2. 从选项中选择 知识库
  3. 选择您想使用的知识库
  4. 发送您的问题

智能体会搜索知识库并提供有据可依的答案。

知识库提示模式​

严格模式​

当您明确选择知识库时，AI 必须 仅基于知识库内容回答，不能使用通用知识。

宽松模式​

当知识库从任务上下文继承时，AI 将知识库作为 可选资源，可以回退到通用知识。

📑 引用机制​

引用格式​

AI 响应包含链接到源文档的编号引用：

根据您的产品文档 [1]，该功能的工作方式是...
此外，故障排除指南 [2] 建议...

来源：
[1] product-overview.pdf（第 3 节）
[2] troubleshooting-guide.md（分块 15）

查看源内容​

  1. 点击响应中的引用编号
  2. 查看原始分块内容
  3. 查看周围上下文

📝 摘要功能​

文档摘要​

启用后，系统会自动为每个文档生成摘要，与文档元数据一起存储，可用于快速参考。

知识库摘要​

整个知识库的聚合摘要：

  • 导航到知识库设置
  • 查看所有文档的综合摘要
  • 包含核心主题标签
  • 支持手动刷新

📊 使用限制​

调用限制​

为防止过度 API 使用，知识库实现了调用限制：

参数范围默认值描述
maxCallsPerConversation2-5010每对话最大知识库搜索次数
exemptCallsBeforeCheck0-492限制生效前的免费调用次数

❓ 常见问题​

上传问题​

文件上传失败​

可能原因： 文件超过大小限制、不支持的文件格式、文件已损坏

解决方案： 检查文件大小限制（通常 50MB）、转换为支持的格式、尝试重新导出文档

检索问题​

没有返回结果​

可能原因： 查询与文档内容不匹配、分数阈值太高、文档未启用

解决方案： 尝试不同的查询措辞、降低 score_threshold、验证文档状态

🔗 相关资源​

用您自己的知识赋能 AI 智能体！ 📚