核心概念

更新时间:
复制 MD 格式

应用回答业务问题时,需要从制度、手册、产品说明等资料中找到依据。知识库将文档解析、分块并向量化,应用可以检索其中的相关片段,作为回答依据。

知识库适合回答什么问题

“报销需要哪些材料”可以从制度中查找,“这笔报销到账了吗”需要查询当前业务记录。

以制度中写明“因公出差结束后 10 个工作日内提交申请”为例,“报销需要哪些材料”应通过知识库检索制度条款,“这笔报销到账了吗”应查询业务系统中的当前记录。以“因公出差结束后 10 个工作日内提交申请”为例,检索结果应同时包含申请期限和“因公出差结束后”这一适用条件;回答时应以完整条款为依据,不得仅提取“10 个工作日内”,也不得将与“报销”相关但不适用于该场景的文字作为依据。

知识库的使用边界

知识库提供的是文档依据,不用于确认实时业务状态。检索片段仅作为生成回答的参考,不构成最终答案,相关性分数也不代表答案正确率。对于存在多个版本的制度,例如同一报销制度有新旧两版时,应根据文档版本、适用对象和生效日期确认当前适用版本,不能仅凭相关性分数或文档上传时间判断;文档上传时间仅表示入库时间,不代表制度生效时间。

原生知识库与知识库连接

在工作空间左侧栏进入 AGENT 上下文 > 知识库,可以看到 知识库 和 知识库连接 两个页签,对应不同的资料管理方式:原生知识库支持本地上传文件和从外部来源导入副本,知识库连接用于访问已有的外部知识库。

方式

适用情况

入口

文档在哪里维护

原生知识库(本地上传)

资料保存在本地,需要上传到 AgentCore 管理

知识库 > 创建知识库;库内 概览 > 添加文件

上传的文档和分块在 AgentCore 管理,本地原文件另行维护

原生知识库(导入外部来源)

资料已存放在对象存储 OSS 或飞书

创建页的外部渠道配置,或库内 外部来源 > 添加数据源

从对象存储 OSS 或飞书导入副本,副本在 AgentCore 管理,源文件仍在来源平台维护

知识库连接

文档和索引已在表格存储(OTS)或百炼中建成

知识库连接 > 创建知识库连接

文档和索引留在表格存储或百炼,AgentCore 通过 MCP(Model Context Protocol)访问

从文件到可检索片段

以下内容描述原生知识库的处理与配置机制。文件上传后经过解析、分块和向量化,生成可检索的片段:

  1. 解析:读取文件正文。支持 TXT、MD、CSV、HTML、HTM、DOCX、PDF,单文件最大 50 MB。PDF 使用文档智能(DocMind)解析,页眉、页脚、图片、印章等版面内容不写入正文。

  2. 分块(界面也称分段、切片):将长文拆成较短的片段,便于检索和引用。页面提供 智能分块 和 按分隔符分块 两种方式,分段最大长度默认 512,取值范围 1~6000 字符,按字符计算,不是 Token 数。

  3. 向量化:使用 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,引用“文档名”变量。上传时间、来源地址等变量可以按需加入模板,并非默认都会生成。

字段可以引用系统变量,也可以设置固定值。引用变量时,字段类型随变量确定,不能手动编辑。字段名只能使用字母、数字和下划线,不能以数字开头,不区分大小写,且必须唯一。

两个时间变量的含义需要区分:

界面名称

变量

含义

上传日期

DOCUMENT_UPLOAD_TIME

文档上传时间

最后上传日期

SOURCE_MODIFIED_TIME

界面说明对应来源修改时间,不是再次上传时间

时间以毫秒记录。来源未提供修改时间时,该字段保持未知,不能用上传时间替代。

限制与取值范围

下表汇总本文涉及的硬性限制与取值范围,便于建库前一次核对。

项目

限制与取值范围

说明

文件解析

支持 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 字段名

只能使用字母、数字和下划线,不能以数字开头

不区分大小写,且必须唯一