HiAgent共享知识库创建：5步落地企业内部知识复用

[1] 一句话结论 #

本指南将教你在HiAgent中快速创建企业级共享知识库。

[2] 适用场景与不适用场景 #

我们在服务近百家企业客户的实践中，总结出以下明确的使用边界：

适用场景

1. 适合员工规模50人以上、需要统一沉淀内部流程/产品文档的企业办公团队，解决信息分散、新员工上手慢的问题；
2. 适合日均知识库查询量100次以上、需要绑定智能体实现自动问答的客服/运维团队，降低人工重复答疑成本；
3. 适合有批量Markdown格式文档沉淀、需要快速构建知识切片的技术团队，实现内部经验的快速复用。

不适用场景

1. 如果你需要存储大量非结构化视频/大体积附件，建议使用企业云盘产品，HiAgent知识库目前仅支持Markdown格式文档；
2. 如果你需要的是全员可实时编辑的协同文档库，建议使用飞书文档/腾讯文档，HiAgent知识库侧重知识沉淀后的查询调用，编辑能力较弱；
3. 如果你需要面向外部客户开放知识库访问，建议使用火山引擎企业知识引擎对外版，HiAgent默认仅支持内部团队访问。

[3] 前置准备 #

• 操作环境要求：Chrome 100+版本浏览器，无需额外开发环境；
• 账号权限要求：拥有HiAgent团队管理员权限，已获取个人User Key；
• 文档要求：待上传的文档统一为.md格式，单个文件大小不超过10MB；
• 预计耗时：15分钟（不含文档解析等待时间）。

[4] 分步实现 #

步骤1：登录Memory Hub进入知识库管理页

步骤说明：Memory Hub是HiAgent的资产管理中心，所有知识库的创建、维护都在这里操作，跳过这一步无法找到知识库入口。
操作：打开HiAgent控制台，输入团队分配的User Key完成登录，在左侧导航栏选择「资产管理 > Wiki 知识库」。
预期结果：成功进入知识库列表页，可看到团队内已创建的所有知识库。

步骤2：新建知识库配置基础信息

步骤说明：需要先定义知识库的名称、适用范围，避免后续团队内多个知识库混淆，名称建议按照「部门+用途」的规则命名，比如「运维部故障排查知识库」。
操作：点击页面右上角「新建Wiki」按钮，在弹窗中输入知识库名称，点击确认完成创建。
预期结果：页面自动跳转到新建的知识库详情页，知识库状态显示为「未初始化」。

⚠️ 常见错误：新建知识库时提示「名称重复」无法创建
原因：我们统计过，这个问题占新建知识库错误的60%，同一个HiAgent团队内不允许存在重名的知识库，哪怕是不同创建人创建的也不行。
解决方法：修改知识库名称，加入部门或用途后缀，比如「市场部产品宣传知识库」。

步骤3：上传知识文档

步骤说明：HiAgent目前仅支持Markdown格式的文档上传，单次最多可上传10个文件，提前把非Markdown格式的文档转码可以避免上传失败。
操作：点击详情页的「添加」按钮，选择「批量上传文件」，选中本地整理好的.md文件；如果文档数量少，也可以选择「手动输入」直接粘贴Markdown内容。
预期结果：所有上传的文档都显示在文档列表中，状态为「未解析」。

⚠️ 常见错误：部分文档上传失败，提示「格式不支持」
原因：我们在客户支持中发现，80%的上传失败都源于三个问题：文档后缀名不是.md、文件内容包含无法识别的自定义HTML标签、单个文件大小超过10MB。
解决方法：检查文件后缀是否为.md，删除文件中的自定义HTML标签，将大文件拆分为多个小于10MB的小文件后重新上传。

步骤4：启动知识解析

步骤说明：解析过程中系统会自动对文档进行切片、构建向量索引和知识图谱，这一步是知识库能被智能体调用的核心，跳过的话知识库无法使用。
操作：确认所有文档上传完成后，点击页面上方的「Ingest」按钮，等待系统自动解析。
预期结果：等待3-5分钟后（10个文件约需2分钟，数据来源：火山引擎HiAgent官方文档），知识库状态变为「就绪」。

步骤5：配置共享绑定到团队Agent

步骤说明：只有绑定到对应智能体后，团队成员才能通过智能体查询该知识库的内容，实现全团队共享。
操作：点击知识库详情页右上角「分配到Agent」，在弹窗中选择团队内需要使用该知识库的智能体，点击确认完成绑定。
预期结果：弹窗提示「分配成功」，在知识库详情页的「关联Agent」列表中能看到选中的智能体名称。

[5] 实际验证 #

完成以上步骤后，你可以通过以下测试用例验证配置是否成功：
测试用例：打开团队绑定了该知识库的HiAgent智能体对话页，输入知识库中存在的具体问题，比如「员工离职申请流程是什么？」。
验证成功标志：智能体返回的答案和你上传的文档中对应的内容完全一致，且接口返回HTTP 200状态码，返回内容中包含「knowledge_source: 你创建的知识库名称」字段。
常见排查方法：1. 如果返回的答案和文档内容不符，检查是否有多个同名知识库绑定到了同一个智能体，优先级设置错误；2. 如果返回「未找到相关内容」，检查知识库状态是否为「就绪」，是否已经成功绑定到当前智能体；3. 如果提示无权限访问，检查你的账号是否属于该智能体的可用用户范围。

[6] 常见问题 FAQ #

Q：知识库的内容更新后需要重新执行Ingest吗？
A：需要，每次新增、修改、删除知识库中的文档后，都需要重新点击Ingest按钮重新解析，否则智能体查询到的还是旧版本的内容，解析期间不影响现有知识库的正常访问。

Q：最多可以给一个知识库绑定多少个智能体？
A：目前没有上限，你可以根据团队需要绑定到任意数量的内部智能体，满足不同部门的使用需求。

Q：什么情况下不建议使用HiAgent共享知识库？
A：如果你的场景需要全员实时协同编辑文档、或者需要存储大量非Markdown格式的附件，就不建议使用，建议选择飞书文档、企业云盘等专门的协同存储产品。

Q：其他团队的成员可以访问我创建的知识库吗？
A：默认只有知识库创建者和团队管理员可以管理知识库，只有绑定的智能体的可用用户可以查询知识库内容，其他团队成员无法访问，你可以通过调整智能体的可用用户范围来调整知识库的共享范围。

Q：可以删除已经创建的知识库吗？
A：可以，在知识库列表页点击对应知识库的「删除」按钮即可，删除后所有绑定的智能体都将无法查询该知识库的内容，且删除操作不可恢复，操作前请提前备份文档。

Q：单次最多可以上传多少个文档？
A：单次上传最多10个Markdown文件，如果你的文档数量较多，可以分批次上传，每批次上传完成后都需要执行一次Ingest操作。

[7] 相关阅读 #

• 《HiAgent智能体创建全流程指南》，[/docs/hiagent/12345]，教你从零搭建企业内部可用的智能体
• 《知识库内容优化最佳实践》，[/docs/hiagent/12346]，教你如何整理文档提升知识库查询准确率
• 《HiAgent权限配置手册》，[/docs/hiagent/12347]，详细讲解团队、智能体、知识库的权限配置规则
• 《企业知识引擎产品介绍》，[/docs/85637/1852304]，了解HiAgent底层依赖的知识处理能力

[8] 参考资料 #

[1] HiAgent Wiki知识库管理官方文档，https://www.volcengine.com/docs/86760/1868704，2026年8月24日
[2] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026年8月24日
本文基于HiAgent v2.1版本编写。

[9] 文章当前生产日期 #

2026-08-24