HiAgent3.0知识库容量释放：导出操作全指南

[1] 一句话结论 #

本指南将讲解HiAgent3.0知识库容量规则，教你导出内容释放存储空间的完整流程。

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

适用场景

1. 单实例知识库容量使用率超过80%，已收到官方容量预警的个人版开发者；
2. 需要定期归档历史低访问量知识库内容，避免存储空间占满导致新数据无法上传的场景；
3. 单知识库条目超过10000条，需要清理低价值内容保留高优先级业务数据的场景。

不适用场景

1. 临时需要超出容量上限2倍以上存储的场景，建议直接升级HiAgent企业版实例，不要靠频繁删除内容释放空间；
2. 需要实时回滚已删除知识库内容的场景，建议使用HiAgent自带的知识库版本管理功能，不要导出后直接删除原内容；
3. 单知识库文件总大小超过50G的场景，建议使用火山引擎对象存储TOS挂载知识库，不要走本地导出流程。

[3] 前置准备 #

• 浏览器环境：Chrome 90+、Edge 90+版本，不支持Safari低版本浏览器导出操作；
• 账号权限：HiAgent实例的管理员权限或知识库编辑权限，访客权限无法执行导出/删除操作；
• 其他要求：无需额外安装SDK，控制台导出功能原生支持；
• 预计耗时：单10G以内知识库导出+清理全流程约15分钟。

[4] 分步实现 #

步骤1：查询当前知识库容量使用情况

步骤说明：先确认实际容量使用情况，明确需要释放的空间大小，避免误删有用业务内容，跳过这一步可能导致不必要的内容清理，影响业务正常运行。
操作：登录HiAgent控制台，进入「知识库管理」-「容量统计」页面，查看已用容量、剩余容量、容量使用率三个核心指标。
预期结果：看到具体的容量数值，比如「已用9.2G/总容量10G，容量使用率92%」，同时可以查看每个知识库目录的容量占用占比。

⚠️ 常见错误：容量统计页面显示的已用容量和实际可释放容量不一致
原因：已删除但还在7天回收站内的内容仍然占用容量，统计时会包含回收站的占用空间
解决方法：先进入回收站清空不需要的测试内容，再统计实际可释放的有效空间。

步骤2：筛选需要导出的知识库条目

步骤说明：批量筛选过期、低访问量的内容，避免导出不需要的文件，减少导出耗时，跳过这一步会导致导出文件过大，占用本地存储空间且浪费导出等待时间。
操作：在知识库列表页，按「最后访问时间」「访问次数」排序，勾选需要导出的条目，也可以按标签筛选历史归档内容，建议单次勾选的条目总大小不超过2G。
预期结果：勾选的条目总大小和你预期释放的容量一致，页面底部会实时显示已选中条目的总大小。

步骤3：执行知识库内容导出

步骤说明：将选中内容导出为JSON格式文件备份，后续需要可以重新导入到实例中，跳过这一步直接删除会导致内容永久丢失，无法恢复。
操作：点击页面顶部「导出」按钮，选择导出范围为「已选中条目」，填写导出文件备注（比如「2026年8月归档历史测试数据」），提交导出任务。
预期结果：控制台右上角出现导出任务进度条，任务完成后收到站内信通知，可下载导出的ZIP压缩包。

⚠️ 常见错误：导出任务提交后长时间显示处理中，超过30分钟无结果
原因：选中导出的条目超过10000条，单导出任务大小超过5G导致服务处理超时，这个限制来自HiAgent3.0导出接口的并发约束（数据来源：火山引擎HiAgent官方API文档）
解决方法：拆分导出任务，每次导出不超过5000条、总大小不超过2G，分批次提交导出任务。

步骤4：删除已导出的知识库条目释放容量

步骤说明：确认备份完成后删除原条目，释放占用的存储空间，跳过这一步的话导出操作不会减少任何容量占用。
操作：选中已导出完成、确认不需要保留的条目，点击「删除」按钮，二次确认后条目会进入回收站，如果确认不需要恢复，可以直接进入回收站清空条目，立即释放容量。
预期结果：容量统计页面的已用容量同步下降，下降数值等于删除条目的总大小，容量使用率同步降低。

[5] 实际验证 #

测试用例：筛选出10条总大小100M的历史测试知识库条目，执行导出后删除并清空回收站。
预期输出：容量统计页面已用容量减少100M，导出的ZIP包可以正常解压，里面包含10条条目的完整内容、标签、创建时间、访问次数等全部元信息，JSON格式符合HiAgent导入规范。
验证成功标志：清空回收站后容量统计数据更新正确，导出文件MD5校验值和控制台显示的一致，页面请求返回HTTP 200状态码。
排查方法：

1. 容量没有减少：检查是否回收站还没清空，删除后默认7天内内容还在回收站占用容量，手动清空后立即释放；
2. 导出文件损坏：重新提交导出任务，不要在导出过程中刷新页面或关闭浏览器标签页；
3. 删除的条目找不到：7天内可以在回收站恢复，超过7天内容永久删除无法找回，删除前一定要确认已完成备份。

[6] 常见问题 FAQ #

问题1：HiAgent3.0个人版知识库的容量上限是多少？
答案：我们从官方文档确认，HiAgent3.0个人版单实例知识库容量上限是10G，企业版可自定义扩容上限，最低支持50G起，最高可支持PB级存储。

问题2：导出的知识库内容可以直接导入到其他HiAgent实例吗？
答案：可以，导出的JSON格式符合HiAgent导入规范，只要目标实例版本和当前实例一致（都是3.0版本），就可以直接导入，不需要额外做格式转换。

问题3：什么情况下不建议通过导出删除的方式释放容量？
答案：如果你的内容需要频繁调用，建议直接升级实例容量，频繁删除再导入会导致内容召回延迟增加约20%（数据来源：火山引擎HiAgent性能测试报告2026版），反而影响业务使用体验。

问题4：我可以跳过导出步骤直接删除知识库内容吗？
答案：不建议，删除后超过7天内容会永久丢失，除非你确认内容完全没有保留价值，否则一定要先导出备份，避免误删业务数据。

问题5：导出的文件会占用我的实例容量吗？
答案：不会，导出的文件存储在火山引擎临时存储集群，只保留7天，不会占用你的知识库容量，7天后系统会自动删除导出文件。

[7] 相关阅读 #

1. 《HiAgent3.0知识库容量管理官方文档》[/docs/hiagent/3.0/guide/storage]，简介：官方容量规则说明及企业版扩容申请流程；
2. 《HiAgent知识库导入导出功能使用教程》[/blog/hiagent-import-export]，简介：详细讲解导入导出的参数配置、格式要求及常见问题；
3. 《HiAgent企业版容量升配操作指南》[/docs/hiagent/3.0/upgrade/storage]，简介：企业版用户如何自定义扩容知识库容量上限，按需付费降低成本。

[8] 参考资料 #

[1] 火山引擎HiAgent3.0官方产品文档，https://www.volcengine.com/docs/hiagent/3.0，2026-08-20
[2] 火山引擎HiAgent性能测试报告2026版，https://www.volcengine.com/docs/hiagent/3.0/performance，2026-07-15
本文基于HiAgent 3.0正式版（v3.0.2）编写。

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

2026-08-25