HiAgent知识库容量超限：批量删除释放空间实操指南
[1] 一句话结论
本指南将讲解HiAgent知识库容量规则及批量删除释放空间的全流程操作。
[2] 适用场景与不适用场景
适用场景
- 适合HiAgent各版本用户，知识库容量接近上限、需要清理闲置内容避免无法新增文档的场景；
- 适合定期运维HiAgent知识库，需要批量清理过期业务文档、优化知识库检索效率的场景；
- 适合需要临时释放容量优先上传高优先级文档的应急场景。
不适用场景
- 如果需要恢复已删除的知识库内容，本操作不适用，建议提前备份后再执行删除，替代方案参考《HiAgent知识库备份与恢复操作指南》；
- 如果需要一次性删除整个知识库所有内容且后续还要复用该知识库ID，不适用直接删除知识库，建议用批量删除文档功能；
- 如果是容量需求长期超出当前版本上限，不适合反复清理，替代方案为升级会员版本或申请企业定制容量。
[3] 前置准备
- HiAgent平台账号，拥有目标知识库的编辑/管理权限；
- 浏览器环境：Chrome 100+、Edge 98+，不兼容IE内核浏览器；
- 提前备份需要留存的知识库文档，避免误删；
- 预计操作耗时：1000条以内文档批量删除约5分钟。
[4] 分步实现
步骤1：进入知识库管理页面
步骤说明：这是所有知识库操作的入口，跳过该步骤无法找到对应操作路径。
操作：打开火山引擎HiAgent控制台，登录个人/企业账号，左侧导航栏点击「知识库」选项，进入知识库列表页。
预期结果：页面展示你有权限管理的所有知识库，包含每个库的已用容量、文档数量信息。
⚠️ 常见错误：左侧导航栏找不到「知识库」选项
原因：当前账号只有智能体查看权限，没有知识库管理权限；或者当前登录的是子账号，未被主账号分配知识库相关权限。
解决方法：联系主账号管理员在访问控制中给当前账号开启「知识库管理」权限，确认权限后刷新页面即可。
步骤2：进入目标知识库详情页
步骤说明：只有进入知识库详情页才能查看内部文档列表执行批量操作，直接在列表页只能删除整个知识库。
操作：在知识库列表中找到需要清理的目标知识库，点击知识库名称进入详情页，页面会展示该库所有上传的文档列表、每条文档的大小、上传时间。
预期结果：正确加载该知识库的所有文档条目，顶部展示该库当前已用容量/总容量的进度条。
步骤3：批量勾选待删除的文档
步骤说明：批量选择需要清理的闲置、过期文档，避免逐条删除的低效操作，选的时候注意核对文档归属业务。
操作：点击文档列表顶部的全选框，或者手动勾选需要删除的文档，支持跨页选择，最多单次可勾选1000条文档【数据来源：火山引擎HiAgent官方文档】。
预期结果：选中的文档条目会高亮显示，顶部操作栏显示已选中的文档数量。
⚠️ 常见错误：跨页勾选后切换页面，之前勾选的文档被取消选中
原因：当前版本的跨页选择仅支持同一次分页会话，刷新页面或者切换到其他知识库再返回会清空选中状态。
解决方法：单次批量删除控制在1000条以内，勾选完成后立即执行删除操作，不要中途切换其他页面。
步骤4：执行批量删除操作
步骤说明：确认选中的文档无误后执行删除，操作不可逆，一定要提前核对。
操作：点击文档列表顶部的「批量删除」按钮，在弹出的二次确认窗口中，勾选「我已知晓删除操作不可逆，无法恢复」，点击确认即可。
预期结果：页面弹出「删除成功」的提示，选中的文档从列表中消失，顶部的已用容量进度条同步下降。
步骤5：清理闲置空知识库（可选）
步骤说明：如果有长期不用的空知识库，直接删除可以释放额外的容量配额，减少冗余资源占用。
操作：返回知识库列表页，找到需要删除的空知识库，点击操作列的「删除」按钮，二次确认后即可删除。
预期结果：该知识库从列表中消失，总账号已用容量同步扣减该库的占用容量。
[5] 实际验证
测试用例：清理一个已用容量800MB的知识库，批量删除100条总大小为300MB的过期文档。
输入：选中100条总大小300MB的文档执行批量删除。
预期输出：1. 页面返回HTTP 200状态码，弹出删除成功提示；2. 知识库已用容量从800MB下降到500MB，释放300MB空间；3. 被删除的文档不再出现在文档列表中。
验证成功标志：容量进度条同步更新，尝试上传一个200MB的新文档可以正常上传成功。
验证失败常见原因及排查：1. 删除后容量没有变化：系统同步延迟，等待1-2分钟刷新页面即可；2. 删除失败提示“权限不足”：当前账号只有该知识库的查看权限，找管理员开通编辑权限即可；3. 部分文档删除失败：这些文档正被关联的智能体训练任务占用，等待训练任务结束后再删除即可。
[6] 常见问题 FAQ
Q1：HiAgent不同版本的知识库容量上限分别是多少？
A1：入门版单账号总知识库容量上限为5GB，专业版为50GB，团队版为200GB，企业版支持自定义扩容【数据来源：火山引擎ADG社区会员权益对比文档】。如果容量长期超出上限，建议升级对应版本。
Q2：删除的知识库文档可以恢复吗？
A2：删除操作不可逆，无法恢复。我们在多个客户实践中都遇到过误删文档的情况，建议执行删除前一定要先备份需要留存的文档到本地或者对象存储。
Q3：什么情况下不建议使用批量删除功能？
A3：如果待删除的文档中有超过30%的内容仍在被智能体引用回答用户问题，不建议批量删除，否则会导致智能体相关问题的回答准确率下降，建议先更新替代文档后再删除旧文档。
Q4：批量删除文档后，关联的智能体需要重新发布吗？
A4：不需要，知识库内容的增删操作会实时同步到关联的智能体，不需要重新发布智能体即可生效。
Q5：单次批量删除的文档数量有限制吗？
A5：单次批量删除最多支持1000条文档，如果需要删除超过1000条，可以分多批次执行操作。
[7] 相关阅读
- 《HiAgent会员权益对比：各版本功能与配额差异》[/docs/86681/2205639]，快速了解不同版本的知识库容量、调用量等配额规则
- 《HiAgent知识库备份与恢复操作指南》[/blog/hiagent-backup]，讲解如何批量备份知识库文档避免误删损失
- 《HiAgent知识库容量优化最佳实践》[/docs/85637/1860221]，教你除了删除之外的其他知识库容量优化方法
[8] 参考资料
[1] 《HiAgent删除知识库文档官方文档》，https://www.volcengine.com/docs/86681/2205642?lang=zh，2026年08月24日
[2] 《AI Agent平台会员权益对比：入门版、专业版、团队版差在哪》，https://adg.csdn.net/6a867a14662f9a54cb9ec8b5.html，2026年08月24日
本文基于HiAgent平台V2.4版本编写
[9] 文章当前生产日期
2026-08-24
