知识库

知识库用于管理租户的业务文档、知识检索配置和本地知识库资产。它为编排智能体、知识问答、GEO 内容生产等能力提供可信资料来源。

你可以在这里做什么

目标	操作入口	影响范围
配置知识库服务商	服务商配置	火山引擎知识库接入、检索能力
创建本地知识库	知识库列表	按业务主题组织文档
添加文档	文档管理	形成可检索的文档切片和向量索引
测试检索效果	知识检索	验证智能体是否能找到资料
设置默认知识库	设为默认	默认检索和业务调用优先使用

一、知识库分两层

层级	管什么	典型操作
服务商配置	底层知识检索服务如何连接	配置火山引擎 AK/SK、知识库 ID、区域
创建知识库	租户自己的文档资产	创建知识库、添加文档、测试检索

服务商配置解决「密钥配置」；本地知识库解决「上传资料」。

二、服务商配置

进入「知识库」。
打开服务商配置。
选择接入方式。
如果选择自定义知识库，填写 Access Key ID、Access Key Secret、知识库 ID 和区域。
如果选择平台配置，则使用平台统一凭证，相关密钥字段不可编辑。
点击测试连接。
保存配置。
如需要，将该配置设为默认。

区域默认使用 cn-beijing。如果企业在火山引擎侧使用了其他区域，要与实际知识库实例保持一致。

详细教程文档：

三、创建知识库

本地知识库建议按业务主题拆分，而不是把所有资料放进一个库。

操作步骤：

切换到知识库列表。
点击创建知识库。
填写名称，例如「产品资料库」「售后政策库」「品牌介绍库」。
填写描述，说明该知识库包含哪些资料。
保存。
进入文档管理添加资料。

图片展示的是知识库管理界面。界面上方有服务商配置、知识库列表、文档管理、知识检索四个选项卡，当前选中“知识库列表”。下方显示有2个知识库，分别是“产品资料库”和“测试产品”，状态均为active，操作栏有“查看文档”和“删除”按钮。右上角有一个蓝色的“+创建知识库”按钮。该图片与文档中“选择一个知识库”内容相关，直观呈现了知识库列表界面，帮助用户了解知识库的管理情况。

推荐拆分方式：

知识库	适合放什么
产品资料库	产品参数、卖点、使用说明
售后政策库	退换货、保修、客服 SOP
品牌内容库	公司介绍、品牌故事、口径规范
GEO 资料库	业务介绍、案例、FAQ、关键词素材

四、添加和管理文档

选择一个知识库。
进入文档管理。
添加文档。
等待同步和切片完成。
文档同步完成后，进入知识检索测试效果。

文档建议保持结构清晰，例如标题、问题、答案、步骤、注意事项分明。纯粘贴大段无结构文本，会降低检索命中率。

图片展示的是知识库配置界面，处于“文档管理”选项卡下。界面显示共1个文档，文档名称为“微信支付开通指南”，状态为“已完成”，容量4.87 KB，创建时间为2026/6/30 18:39:23。右侧有“同步状态”和“添加文档”按钮，下方还有“操作”栏，包含一个垃圾桶图标。图片与上下文关系紧密，直观呈现了文档管理界面及文档相关信息，为后续添加和管理文档操作提供参考。

五、测试知识检索

知识检索用于验证文档是否能被问题命中。

选择知识库。
输入真实用户可能会问的问题。
点击检索。

这张图片展示的是知识库检索功能的界面，顶部为知识库配置的导航栏，选中的是“知识检索”选项，右侧测试产品下拉菜单已选择“微信支付”，并点击了检索按钮。页面主体区域显示检索到的结果为《微信支付开通指南》，相关度得分为60.3%，该文档篇幅775字，预览内容包含微信支付开通前的资质准备相关要求，底部还有“查看全文”和“复制文本”的操作按钮。这张图用于直观呈现知识库检索功能的运行效果，对应测试知识检索步骤中的检索环节，能够帮助使用者直观了解该操作的实际状态。

查看返回内容是否和问题相关。
如果命中不准，优化文档标题、段落结构或补充 FAQ。

上线智能体前，建议用 10 个真实问题做检索测试。只有检索能命中文档，智能体才有可能稳定引用资料回答。

六、在智能体中引用知识库

先完成知识库创建和文档同步。
进入智能体编辑器。
选择智能体编排。
开启知识库引用。

图片展示的是知识库中引用知识库的设置界面。界面中“开启”按钮旁有“引用租户知识库”说明，开启后智能体在问答时会检索所关联的知识库文档。下方“选择具体的知识库（可选）”处，有“产品资料库”和“测试产品”两个选项，其中“测试产品”被蓝色边框突出显示，表明其已选中。该图片与上下文紧密相关，直观呈现了在知识库中引用知识库时的设置操作界面及选项状态。

选择一个或多个知识库。
在提示词中说明引用知识库的优先级。
用真实问题测试对话效果。

如果不选择具体知识库，系统会默认检索租户下可用知识库。对于专业场景，建议明确选择范围，避免误引用无关资料。

七、删除知识库

删除知识库会永久删除该知识库下的文档切片和向量索引数据，无法恢复。

删除前要确认：

没有智能体正在引用该知识库。
没有 GEO 或内容生产流程依赖该知识库。
文档原始文件已经有备份。
删除后不会影响线上问答效果。

八、注意事项

知识库质量决定智能体回答质量，不要把过期资料混入正式知识库。
密钥属于敏感信息，只允许可信管理员维护。
文档添加后需要同步完成，未同步完成时检索不到内容。
删除知识库不可恢复，操作前要确认引用关系。
默认知识库只影响默认调用逻辑，不代表所有智能体都会自动使用它。

九、常见问题

为什么智能体没有引用知识库回答？
先到知识检索中测试同样问题是否能命中文档，再检查智能体是否开启知识库引用。

为什么文档上传了但检索不到？
可能还在同步、切片失败、文档内容过短或问题和文档表达差异太大。

平台配置和自定义配置怎么选？
如果企业希望统一使用平台提供的知识库服务，选平台配置；如果企业有自己的火山引擎账号和知识库实例，选自定义。