核心概念
应用回答业务问题时,需要从制度、手册、产品说明等资料中找到依据。知识库将文档解析、分块并向量化,应用可以检索其中的相关片段,作为回答依据。
知识库适合回答什么问题
“报销需要哪些材料”可以从制度中查找,“这笔报销到账了吗”需要查询当前业务记录。
以制度中写明“因公出差结束后 10 个工作日内提交申请”为例,“报销需要哪些材料”应通过知识库检索制度条款,“这笔报销到账了吗”应查询业务系统中的当前记录。以“因公出差结束后 10 个工作日内提交申请”为例,检索结果应同时包含申请期限和“因公出差结束后”这一适用条件;回答时应以完整条款为依据,不得仅提取“10 个工作日内”,也不得将与“报销”相关但不适用于该场景的文字作为依据。
知识库的使用边界
知识库提供的是文档依据,不用于确认实时业务状态。检索片段仅作为生成回答的参考,不构成最终答案,相关性分数也不代表答案正确率。对于存在多个版本的制度,例如同一报销制度有新旧两版时,应根据文档版本、适用对象和生效日期确认当前适用版本,不能仅凭相关性分数或文档上传时间判断;文档上传时间仅表示入库时间,不代表制度生效时间。
原生知识库与知识库连接
在工作空间左侧栏进入 AGENT 上下文 > 知识库,可以看到 知识库 和 知识库连接 两个页签,对应不同的资料管理方式:原生知识库支持本地上传文件和从外部来源导入副本,知识库连接用于访问已有的外部知识库。
方式 | 适用情况 | 入口 | 文档在哪里维护 |
原生知识库(本地上传) | 资料保存在本地,需要上传到 AgentCore 管理 | 知识库 > 创建知识库;库内 概览 > 添加文件 | 上传的文档和分块在 AgentCore 管理,本地原文件另行维护 |
原生知识库(导入外部来源) | 资料已存放在对象存储 OSS 或飞书 | 创建页的外部渠道配置,或库内 外部来源 > 添加数据源 | 从对象存储 OSS 或飞书导入副本,副本在 AgentCore 管理,源文件仍在来源平台维护 |
知识库连接 | 文档和索引已在表格存储(OTS)或百炼中建成 | 知识库连接 > 创建知识库连接 | 文档和索引留在表格存储或百炼,AgentCore 通过 MCP(Model Context Protocol)访问 |
从文件到可检索片段
以下内容描述原生知识库的处理与配置机制。文件上传后经过解析、分块和向量化,生成可检索的片段:
解析:读取文件正文。支持 TXT、MD、CSV、HTML、HTM、DOCX、PDF,单文件最大 50 MB。PDF 使用文档智能(DocMind)解析,页眉、页脚、图片、印章等版面内容不写入正文。
分块(界面也称分段、切片):将长文拆成较短的片段,便于检索和引用。页面提供 智能分块 和 按分隔符分块 两种方式,分段最大长度默认 512,取值范围 1~6000 字符,按字符计算,不是 Token 数。
向量化:使用 Embedding 模型将文字转换为表示语义的向量,使不同说法也有机会匹配到相关内容。
Embedding 模型和维度在知识库创建后不支持更换,需在建库时选定。
默认 Embedding 配置是 text-embedding-v4、1024 维。分块结果是否合适,仍需对照正文检查:例如“10 个工作日内”不应失去“因公出差结束后”的前提。
检索、融合和模型排序
全文检索按词语查找,适合制度编号、产品型号等明确内容;向量检索按语义查找,适合“申请期限”和“多久内提交”等不同表述。原生知识库默认使用全文与向量双路检索,双路结果的融合与排序设置如下:
设置 | 含义 | 默认值与取值范围 |
TopK | 最终最多返回的片段数量,实际可能更少 | 默认 10,取值范围 1~100 |
RRF | 根据片段在各路结果中的排名融合,不直接相加原始分数 | 默认融合算法,k 默认 60,控制台取值范围 1~200 |
加权融合 | 使用向量权重和全文权重融合结果 | 切换为该算法时,向量权重显示 0.7,全文权重为 1 减去向量权重;向量权重可设为 0~1 |
Rerank(模型排序) | 用模型再次评估问题与片段的相关性 | 默认关闭,开启后可见 qwen3-rerank |
RRF 的 k 用于排名计算,与控制数量的 TopK 不同。
Metadata 与文档信息
Metadata(元数据)是附在文档上的字段,可以用于识别资料和筛选检索范围。创建时默认只有 document_name 一个字段:类型为 STRING,引用“文档名”变量。上传时间、来源地址等变量可以按需加入模板,并非默认都会生成。
字段可以引用系统变量,也可以设置固定值。引用变量时,字段类型随变量确定,不能手动编辑。字段名只能使用字母、数字和下划线,不能以数字开头,不区分大小写,且必须唯一。
两个时间变量的含义需要区分:
界面名称 | 变量 | 含义 |
上传日期 |
| 文档上传时间 |
最后上传日期 |
| 界面说明对应来源修改时间,不是再次上传时间 |
时间以毫秒记录。来源未提供修改时间时,该字段保持未知,不能用上传时间替代。
限制与取值范围
下表汇总本文涉及的硬性限制与取值范围,便于建库前一次核对。
项目 | 限制与取值范围 | 说明 |
文件解析 | 支持 TXT、MD、CSV、HTML、HTM、DOCX、PDF;单文件最大 50 MB | PDF 使用文档智能(DocMind)解析,页眉、页脚、图片、印章等版面内容不写入正文 |
分段最大长度 | 默认 512,取值范围 1~6000 字符 | 按字符计算,不是 Token 数 |
Embedding 模型与维度 | 默认 text-embedding-v4、1024 维 | 创建后不支持更换,需在建库时选定 |
TopK | 默认 10,取值范围 1~100 | 最终最多返回的片段数量,实际可能更少 |
RRF 的 k | 默认 60,控制台取值范围 1~200 | 用于排名计算,与控制数量的 TopK 不同 |
向量权重 | 取值范围 0~1 | 全文权重为 1 减去向量权重 |
Metadata 字段名 | 只能使用字母、数字和下划线,不能以数字开头 | 不区分大小写,且必须唯一 |