知识库 | LanSphere 使用手册

知识库

知识库是蓝域(LanSphere)为企业提供资料的托管与检索能力。你可以将制度文件、产品手册、技术文档等资料上传至知识库,再在工作流、对话流或智能体中关联使用,让应用的回答基于企业真实资料,而不是大模型的通用记忆。

本文介绍知识库的作用原理、两种构建模式、标准创建的完整步骤、索引与检索设置、召回测试、文档管理、第三方知识库接入与权限管理,适合需要建设企业知识底座的开发人员与管理员阅读。

知识库如何发挥作用

知识库采用检索增强生成(RAG)机制,应用回答问题时经历三个步骤:

  1. 检索:根据用户问题,从知识库中找出语义或关键词最相关的内容片段。
  2. 增强:将召回的片段作为上下文,连同问题一起提供给大模型。
  3. 生成:大模型基于这些真实资料组织回答,而非凭空作答。

因此,知识库的资料质量、分段合理性与检索配置,直接决定应用回答的准确性与可信度。

两种构建模式

创建知识库时,你需要在两种构建模式中选择:

构建模式 说明 适用对象
简易 标准创建向导:按步骤上传文件、选择分段策略与索引方式即可 大多数资料入库场景
专家 知识管道:选择管道模板(含多款常规模板与空白模板)后,在管道编排界面自定义数据处理流程 对数据清洗、处理链路有定制需求的场景

提示:如果你是首次使用,建议从简易模式入手;知识管道面向有自定义处理流程需求的用户,按页面提示完成配置即可。

标准创建五步法

在左侧菜单进入「知识库」,选择标准创建后,按以下五步完成。

第一步:基础信息

  • 名称:必填,不超过 30 字符。
  • 描述:选填,不超过 300 字符,建议说明资料范围与用途,便于团队成员理解与选用。

第二步:上传文件

支持的文件格式包括 DOCX、TXT、MD、XLSX、XLS、CSV、PDF 等,单个文件不超过 15MB。

第三步:分段策略

分段决定文档如何被切分为可检索的片段。平台提供 5 种预设策略:

策略 分段模式 核心参数 适用文档
通用文档问答 父子分段 · 段落 子块最大 512 一般制度、说明类文档
精准问答 Q&A 分段 最大 256 / 重叠 30 问答对、FAQ 类资料
长文理解 父子分段 · 全文 子块最大 512 篇幅较长、需整体上下文理解的文档
技术文档 规则分段 标识符 ##\n\n,最大 768 / 重叠 50 带明确层级的技术文档
自定义分段 规则分段 标识符 \n\n,最大 1024 / 重叠 50 需要自行控制切分规则的资料

分段模式分为三种:

  • 规则分段:按标识符与长度规则切分文档。
  • Q&A 分段:将资料整理为问答对,适合高精准度的问答场景。
  • 父子分段:先按「段落」或「全文」两档确定父块,再切分子块;检索时命中子块,生成时带回父块上下文,兼顾精准与完整。

预处理选项:所有预设策略默认开启「合并连续空白字符」,另可选「删除 URL 和邮箱」以清理干扰内容。

第四步:参数确认

  • 索引方式:可选「向量索引」(默认)或「关键词索引」。选择父子分段或 Q&A 分段时,锁定向量索引。
  • 向量模型:选择向量索引时必选,用于将文本片段向量化。
  • 重排序模型:选填,配置后可在检索时对召回结果重新排序,提升精度。

注意:向量索引选定后不支持切回关键词索引,请在创建前确认索引方式。

第五步:确认创建

确认后系统逐文件处理,页面显示每个文件的处理进度;如个别文件处理失败,可重新处理该文件。全部成功后点击「进入知识库」即可开始使用。

追加文件

向存量知识库追加文件时,新文件自动继承创建时的分段模式,锁定不可变更。如需更换分段方式,请新建知识库。

检索设置

知识库支持三种检索方式:

  • 向量检索:按语义相似度召回,适合自然语言提问。
  • 全文检索:按关键词匹配召回。
  • 混合检索:向量与全文加权结合,兼顾语义与精确命中。

其他关键参数:

  • Top K:每次检索返回的片段数量,默认为 3。
  • Score 阈值:按匹配度过滤低分片段,默认关闭。
  • 重排序模型:可选配,对召回结果二次排序,提升最终命中精度。

召回测试

知识库建成后,建议使用「召回测试」验证效果:输入测试问题,查看召回的内容片段、匹配度与来源文档。如召回结果不理想,可调整检索方式、Top K 或分段策略后再次验证。

文档管理

在知识库详情页,你可以管理已入库的文档:

  • 文档列表:查看全部文档及其状态。
  • 启用 / 禁用:临时将某篇文档移出检索范围,无需删除。
  • 分段查看与管理:检查文档的切分结果。
  • 元数据标注:为文档补充标注信息。
  • 下载 / 重命名 / 删除:维护文档本身。

第三方知识库

如果企业的知识资料已托管在其他系统中,可通过 API 将其连接为「第三方知识库」直接使用,无需迁移数据到蓝域。

权限管理

知识库权限与应用权限规则一致:

  • 默认「仅本人」可见可用;可开放为「部分团队成员」,成员多选、支持全选。
  • 被授权成员可使用知识库,但不可删除文档,设置仅可查看。
  • 支持转让所有权:在「权限」弹窗中操作,转让后原所有者完全移除权限,协作者与可见范围不变。

详细规则请参阅《成员与权限》。

列表筛选

知识库列表支持按「构建模式」(简易 / 专家)筛选,也可通过「我创建的」快速定位本人创建的知识库。