跳到主要内容

使用指南

知识库支持存储、组织和检索文档，实现 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.5最低相关度分数

⚙️ 检索配置​

配置说明​

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

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

无 RAG 模式​

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

直注入补充路径​

对于内容规模较小的知识库，系统可能会使用 all-chunks 路径直接读取整库 chunks，再交给模型处理。这条路径主要用于补足向量检索在部分场景下召回不稳定的问题，尤其适合需要整体归纳、诊断、总结的提问。

更多说明见 检索与直注入。

🧪 检索测试​

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

使用检索测试​

  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. 查看周围上下文

📝 摘要功能​

文档摘要​

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

知识库摘要​

整个知识库的聚合摘要：

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

手动编辑知识库摘要​

知识库摘要支持手动编辑，用于修正 AI 自动摘要、补充背景信息，或将摘要改写为更适合团队使用的表述。

  • 手动摘要会优先用于页面展示
  • 手动摘要会优先注入知识库对话上下文
  • AI 自动摘要仍会继续在后台更新，不会因为手动摘要而停止
  • 如果希望回到最新的 AI 摘要，可使用“恢复 AI 摘要”

注意：

  • 当前仅支持手动编辑知识库的长摘要
  • 文档摘要仍然保持自动生成
  • 关闭“自动生成摘要”后，新的自动摘要不会继续生成，但已保存的手动摘要仍可展示

📊 使用限制​

调用限制​

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

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

🔐 权限管理​

知识库通过 Share Service 架构支持细粒度的访问控制。您可以管理成员、分配角色，并授权外部实体（如群组）访问您的知识库。

成员角色​

角色权限
Owner（所有者）完全控制，可转移所有权并管理所有成员
Maintainer（维护者）可管理文档、设置和邀请成员
Developer（开发者）可阅读和贡献文档
Reporter（报告者）只读访问

管理成员​

  1. 打开知识库，点击 权限管理
  2. 在 个人 标签页中，通过用户名或邮箱邀请用户
  3. 从下拉框中选择角色（所有者、维护者、开发者、报告者）
  4. 点击 添加 发送邀请

实体级授权​

除了单个用户，您还可以授权整个群组或命名空间：

  1. 在权限对话框中切换到 群组 标签页
  2. 搜索并选择目标群组或命名空间
  3. 为该群组分配角色
  4. 该群组的所有成员将继承所分配的权限

注意： 通过实体授权的知识库会显示在成员的 与我共享 区域中，而非该群组的本地知识库列表下。

权限来源可视化​

在查看成员列表时，系统会显示每个成员的访问来源：

  • 直接 — 直接添加为成员
  • 实体 — 通过群组或命名空间获得访问权限
  • 链接 — 通过分享链接获得访问权限

角色冲突解决​

当用户通过多种途径访问同一知识库（例如同时拥有直接成员身份和群组成员身份）时，系统会自动选择最高权限的角色进行冲突解决。

所有权转移​

所有者可以将知识库所有权转移给其他成员：

  1. 在 权限管理 中找到目标成员
  2. 点击其名称旁的 转移所有权
  3. 在确认对话框中确认转移

原所有者将被降级为维护者，新所有者获得完全控制权。

❓ 常见问题​

上传问题​

文件上传失败​

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

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

检索问题​

没有返回结果​

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

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

🔗 相关资源​

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