HiAgent自定义知识库训练：5步挂载到智能对话功能
[1] 一句话结论
本指南将手把手教你完成HiAgent自定义知识库训练并挂载到智能对话功能的全流程操作。
[2] 适用场景与不适用场景
适用场景
- 适合企业内部智能客服场景，需要基于内部制度/产品手册回答员工/客户问题，单知识库文档量在100份以内的场景；
- 适合ToB产品的用户自助问答场景，日均问答请求量在1万次以下，对回答准确率要求≥90%的场景；
- 适合内部知识助手场景，需要同步更新企业内部文档、员工无需手动查找资料的场景。
不适用场景
- 单知识库文档量超过1000份且需要毫秒级检索响应的场景，不适用，建议参考【火山引擎向量数据库+大模型RAG自建方案】；
- 需要支持多模态知识库（视频/音频直接检索训练）的场景，不适用，建议参考【火山引擎多模态RAG解决方案】；
- 需要完全本地化部署、不能上传数据到云端的场景，不适用，建议参考【火山引擎HiAgent私有化部署版本】。
[3] 前置准备
- 开发环境：无特殊要求，只要有Chrome 100+版本浏览器即可操作后台
- 账号权限：已完成火山引擎企业账号注册，且开通HiAgent 3.0版本使用权限【数据来源：火山引擎HiAgent官方文档2026版】
- 依赖项：无需额外安装SDK，仅需要提前准备待上传的知识库文件（支持PDF/Word/Markdown格式，单文件≤50M）
- 预计耗时：10-30分钟，取决于知识库文件数量
[4] 分步实现
步骤1：申请并登录HiAgent操作后台
步骤说明：首先需要完成平台准入，只有获得HiAgent使用权限的账号才能操作知识库功能，跳过这一步会无法访问知识库管理模块。
操作：访问火山引擎HiAgent官网，提交企业资质申请开通权限，审核通过后登录进入控制台。
预期结果：成功进入控制台后，左侧导航栏可见「知识库管理」入口。
⚠️ 常见错误：个人账号申请后无法看到知识库管理入口
原因：HiAgent知识库功能目前仅对企业认证账号开放，个人账号无权限
解决方法：完成企业实名认证后重新提交权限申请，或联系客户经理开通白名单。
步骤2：创建自定义知识库
步骤说明：新建专属知识库是存储自定义内容的容器，不同知识库可以对应不同业务场景的内容，避免不同业务的知识混在一起导致召回不准确。
操作：点击左侧「知识库管理」→「新建知识库」，填写知识库名称（如“内部客服知识库”）、选择适用场景（智能问答）、设置公开范围（仅本企业可见），点击确认创建。
预期结果：知识库列表中出现刚刚创建的知识库，状态显示为“正常”。
步骤3：上传并处理知识库文档
步骤说明：平台会自动对上传的文档进行分段、向量化处理，生成可被大模型检索的向量索引，这一步是知识库能够被准确召回的核心。
操作：进入对应知识库详情页，点击「上传文档」，批量选择本地准备好的PDF/Word/Markdown文件，等待平台自动解析完成，解析完成后可以手动调整分段长度、添加自定义检索标签。
预期结果：所有上传的文档状态显示为“解析成功”，可在内容管理页查看分段后的内容。
⚠️ 常见错误：上传PDF文件后解析失败，状态显示为“异常”
原因：上传的PDF是扫描件/加密文件，平台无法直接识别文字内容，或文件大小超过50M上限
解决方法：将扫描件转换为可编辑的文字版PDF，或拆分大文件为多个≤50M的小文件重新上传。
步骤4：挂载知识库到智能对话智能体
步骤说明：只有将知识库挂载到对应智能体后，智能对话功能才会在回答时参考知识库中的内容，否则默认仅使用大模型通用知识回答。
操作：进入左侧「智能体编排」→ 选择需要配置的对话智能体 → 点击「技能配置」→ 开启「知识库检索」开关，选择刚刚创建的知识库，设置召回阈值（建议默认0.7）和召回条数（建议默认3条），保存配置。
预期结果：智能体技能配置页中知识库选项显示已绑定对应知识库，状态为已启用。
步骤5：调试优化问答效果
步骤说明：通过测试问答调整检索和回答参数，确保回答符合业务预期，这一步直接影响最终用户的使用体验。
操作：进入智能体「调试预览」页面，输入常见的用户问题，查看回答是否引用了知识库中的内容，若回答不准确可以调整召回阈值、优化提示词，或在知识库中补充对应内容。
预期结果：测试问题的回答准确率达到业务要求，回答底部显示引用的知识库来源。
[5] 实际验证
测试用例：若你配置的是内部客服知识库，输入测试问题“用户申请退款需要满足什么条件？”，预期输出为知识库中记录的退款条件，且底部显示引用的对应文档名称。
验证成功标志：接口返回HTTP 200状态码，回答内容与知识库内容一致，引用来源正确。
常见排查方法：
- 如果回答没有引用知识库内容，先检查知识库是否成功挂载到智能体，召回阈值是否设置过高；
- 如果回答内容错误，检查上传的文档内容是否正确，分段是否合理，是否有歧义内容；
- 如果完全没有返回结果，检查账号权限是否正常，智能体是否已启用。
[6] 常见问题 FAQ
Q1：上传的文档最多支持多大的？
A1：目前单文件支持最大50M，单知识库最多支持1000份文档【数据来源：HiAgent 3.0官方使用手册】，如果超过上限建议拆分多个知识库分别挂载。
Q2：知识库内容更新后需要重新挂载吗？
A2：不需要，知识库内容更新后平台会自动同步索引，10分钟内即可生效，无需重新挂载到智能体。
Q3：什么情况下不建议使用HiAgent自带的知识库功能？
A3：如果你需要支持多模态内容检索、或单知识库文档量超过1000份、或需要完全本地化部署，都不建议使用自带的知识库功能，建议搭配火山引擎向量数据库自建RAG流程。
Q4：可以同时挂载多个知识库到同一个智能体吗？
A4：可以，最多支持同时挂载5个知识库，平台会自动从所有挂载的知识库中召回相关内容合并后生成回答。
Q5：我可以跳过调试步骤直接上线吗？
A5：不建议跳过，默认的召回参数不一定适配你的业务场景，直接上线可能会出现回答不准确、引用无关内容的问题，建议至少测试20个以上常见问题再上线。
[7] 相关阅读
- 《HiAgent智能体开发入门教程》，[/docs/86760/1868700]，适合零基础开发者快速了解HiAgent基础功能
- 《HiAgent RAG检索策略配置指南》，[/docs/86760/1868715]，教你如何调整召回参数提升知识库回答准确率
- 《HiAgent私有化部署方案介绍》，[/docs/86760/1868720]，了解本地化部署的功能差异和申请流程
- 《火山引擎向量数据库RAG最佳实践》，[/docs/84450/1794848]，适合需要自定义RAG流程的开发者参考
[8] 参考资料
[1] HiAgent智能体平台使用手册，https://www.volcengine.com/docs/86760/1868704，2026-08-20
[2] HiAgent 3.0功能发布解读，https://juejin.cn/post/7654190253734428735，2026-08-15
本文基于火山引擎HiAgent 3.0版本编写
[9] 文章当前生产日期
2026-08-24
