快速开始

更新时间:
复制 MD 格式

本文以本地文件为例,带您完成知识库的首次使用流程:先创建一个知识库,上传一份报销制度,再检查分块并测试几个问题,确认能否找到回答所需的条款。

准备一份文档

首次使用可以准备一份 UTF-8 编码的 TXT 或 MD 文件,便于后续将分块结果与源文件内容对照。上传支持 TXT、MD、CSV、HTML、HTM、DOCX、PDF,单文件最大 50 MB;TXT、MD、CSV、HTML 需使用 UTF-8 编码,暂不支持 DOC、PPT、PPTX。

重要

文件格式、大小或编码不符合上述要求时,上传后会处理失败。

下面的内容仅作练习:

报销制度(示例):员工因公出差结束后,应在 10 个工作日内提交报销申请,并附发票和经审批的出差申请。个人旅游费用不予报销。

第一步:创建知识库

本文使用本地文件,无需配置 OSS 或飞书来源。如果要导入这些来源的资料,应先按页面的 权限开通 提示处理事件总线(EventBridge)依赖及来源读取权限。已有表格存储或百炼知识库时,不新建知识库,改用另一个入口:知识库连接 > 创建知识库连接。

  1. 在工作空间左侧栏,进入 AGENT 上下文 > 知识库。

  2. 保持在 知识库 页签,单击 创建知识库,进入独立创建页。

  3. 填写知识库名称(必填),例如“报销制度”;描述可填写“员工差旅报销规则及所需材料”,最多 255 个字符。

  4. 核对以下默认配置,再提交创建。

配置

默认设置

分段策略

智能分块

分段最大长度

512 字符

Embedding 模型与维度

text-embedding-v4,1024 维

检索方式

全文检索 + 向量检索

TopK

10,即最终最多返回的片段数量

融合算法

RRF,k 为 60

模型排序

关闭

Metadata

仅有 document_name,用于引用文档名变量

警告

Embedding 模型和维度在创建后不支持更换。

其他选项及填写要求,见创建知识库。

第二步:上传并检查内容

  1. 打开目标知识库详情,进入 概览,单击 添加文件。

  2. 在 上传文件 弹窗中选择文件。首次上传可以保留知识库默认配置;需要单独调整时再展开 高级配置,其中的改动仅对本次所选文件生效,不会修改知识库默认配置。

  3. 提交上传后,文件会经过解析、分段和向量化。在 概览 中单击 刷新文件列表 查看状态;出现失败时,先检查文件格式、大小和编码。

  4. 文件就绪后,单击对应文件的 查看,对照左右两侧的 原文预览 和 分块详情。

使用上面的示例时,重点检查:

  • “10 个工作日”是否完整,是否保留了“因公出差结束后”的条件。

  • 所需材料是否同时包含“发票”和“经审批的出差申请”。

  • “个人旅游费用不予报销”是否被正确保留。

说明

原文有缺字或乱码时,先检查源文件;原文完整但条款被切开时,再调整分段。

第三步:发起召回测试

  1. 进入知识库的 召回测试。

  2. 在 查询文本 中输入“出差报销需要提交哪些材料?”。

  3. 首次测试保留全文检索 + 向量检索、TopK 10 和 RRF(k 为 60),并勾选 启用 Rerank 精排。

  4. 单击 开始测试,将检索到的内容与原文对照。

可以用下面两个问题检查内容是否足够:

问题

检查重点

出差回来多久内要报销?

是否能找到完整的“10 个工作日内”及适用条件

住宿费每天最多报销多少?

示例未规定限额,不应将相关片段作为具体金额的依据

如果召回结果中找不到目标条款,回到第二步对照 原文预览 和 分块详情:先检查源文件是否有缺字或乱码,再确认条款是否被切开、需要调整分段。

召回测试用于检查检索内容,不是应用的最终回答。