快速开始
本文以本地文件为例,带您完成知识库的首次使用流程:先创建一个知识库,上传一份报销制度,再检查分块并测试几个问题,确认能否找到回答所需的条款。
准备一份文档
首次使用可以准备一份 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)依赖及来源读取权限。已有表格存储或百炼知识库时,不新建知识库,改用另一个入口:知识库连接 > 创建知识库连接。
在工作空间左侧栏,进入 AGENT 上下文 > 知识库。
保持在 知识库 页签,单击 创建知识库,进入独立创建页。
填写知识库名称(必填),例如“报销制度”;描述可填写“员工差旅报销规则及所需材料”,最多 255 个字符。
核对以下默认配置,再提交创建。
配置 | 默认设置 |
分段策略 | 智能分块 |
分段最大长度 | 512 字符 |
Embedding 模型与维度 | text-embedding-v4,1024 维 |
检索方式 | 全文检索 + 向量检索 |
TopK | 10,即最终最多返回的片段数量 |
融合算法 | RRF,k 为 60 |
模型排序 | 关闭 |
Metadata | 仅有 |
Embedding 模型和维度在创建后不支持更换。
其他选项及填写要求,见创建知识库。
第二步:上传并检查内容
打开目标知识库详情,进入 概览,单击 添加文件。
在 上传文件 弹窗中选择文件。首次上传可以保留知识库默认配置;需要单独调整时再展开 高级配置,其中的改动仅对本次所选文件生效,不会修改知识库默认配置。
提交上传后,文件会经过解析、分段和向量化。在 概览 中单击 刷新文件列表 查看状态;出现失败时,先检查文件格式、大小和编码。
文件就绪后,单击对应文件的 查看,对照左右两侧的 原文预览 和 分块详情。
使用上面的示例时,重点检查:
“10 个工作日”是否完整,是否保留了“因公出差结束后”的条件。
所需材料是否同时包含“发票”和“经审批的出差申请”。
“个人旅游费用不予报销”是否被正确保留。
原文有缺字或乱码时,先检查源文件;原文完整但条款被切开时,再调整分段。
第三步:发起召回测试
进入知识库的 召回测试。
在 查询文本 中输入“出差报销需要提交哪些材料?”。
首次测试保留全文检索 + 向量检索、TopK 10 和 RRF(k 为 60),并勾选 启用 Rerank 精排。
单击 开始测试,将检索到的内容与原文对照。
可以用下面两个问题检查内容是否足够:
问题 | 检查重点 |
出差回来多久内要报销? | 是否能找到完整的“10 个工作日内”及适用条件 |
住宿费每天最多报销多少? | 示例未规定限额,不应将相关片段作为具体金额的依据 |
如果召回结果中找不到目标条款,回到第二步对照 原文预览 和 分块详情:先检查源文件是否有缺字或乱码,再确认条款是否被切开、需要调整分段。
召回测试用于检查检索内容,不是应用的最终回答。