HiAgent知识库容量查询：上限规则与已用容量查看方法

[1] 一句话结论 #

本指南将介绍HiAgent知识库容量上限规则，以及查看已用容量的实操方法。

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

适用场景

1. 打算扩容知识库前，需要先确认当前已用容量、剩余额度的HiAgent个人/团队开发者
2. 需要定期统计团队知识库资源消耗，做成本管控的团队管理员
3. 上传知识库文件提示容量不足，需要先核对容量使用情况的场景

不适用场景

1. 使用其他AI Agent平台（如豆包企业版、腾讯云智能体平台）的用户，建议参考对应平台的资源管理文档
2. 需要查询单条知识库文件大小上限的用户，建议参考【知识库文件上传规范】文档
3. 需要申请超出自定义容量配额的用户，直接走工单联系商务对接，无需走本文的查询流程

[3] 前置准备 #

• 已注册并激活火山引擎HiAgent账号，拥有对应知识库的查看权限
• 支持的浏览器版本：Chrome 100+、Edge 99+，不兼容IE浏览器
• 预计操作耗时：1分钟以内

[4] 分步实现 #

步骤1：进入HiAgent知识库管理页

步骤说明：首先要进入正确的功能入口，权限不足的话会看不到容量数据，跳过这一步直接找其他入口会找不到目标数据。
操作：打开火山引擎官网，登录账号后进入HiAgent产品控制台，在左侧导航栏点击「智能体开发 > 知识库管理」。
预期结果：页面顶部展示当前账号所有知识库的总已用容量、剩余容量，以及单知识库的容量使用明细。

⚠️ 常见错误：左侧导航栏找不到「知识库管理」入口
原因：你的账号权限是普通成员，没有知识库的全局查看权限，或者当前账号归属的团队还没有开通知识库功能
解决方法：联系团队管理员给你开通知识库查看权限，或者确认团队已经购买了包含知识库功能的套餐。

步骤2：查看单知识库容量明细（可选）

步骤说明：如果需要查看某个特定知识库的容量使用情况，就做这一步，方便排查单个知识库容量占比过高的问题。
操作：在知识库管理列表中，点击你要查看的知识库名称，进入详情页，右侧「资源统计」模块可以看到该知识库的已用容量、文档数量、索引大小等数据。
预期结果：可以看到精确到KB级的容量使用数据，数据更新延迟不超过5分钟（数据来源：火山引擎HiAgent官方V2.1.0版本文档）。

⚠️ 常见错误：详情页显示的容量总和和总容量统计不一致
原因：总容量统计包含了已删除但还在回收站保留的知识库文件容量，回收站默认保留7天，7天后自动释放
解决方法：如果需要立即释放容量，可以进入回收站手动删除不需要的文件。

步骤3：团队管理员查看全量资源看板（团队版/企业版专属）

步骤说明：团队管理员需要统计全团队的容量消耗做成本核算的话走这个入口，普通成员看不到这个页面。
操作：点击右上角头像下拉菜单，选择「平台管理 > 数据报表 > 资源看板」，筛选「知识库资源」维度即可查看近30天的容量消耗趋势。
预期结果：可以导出CSV格式的容量消耗报表，支持按成员、按知识库维度筛选。

[5] 实际验证 #

测试用例：登录个人HiAgent专业版账号，查看总知识库容量
输入：按照步骤1进入知识库管理页
预期输出：页面顶部显示「总容量：50GB，已用：12.3GB，剩余：37.7GB」（专业版默认容量上限50GB，数据来源：火山引擎ADG社区会员权益对比文档）
验证成功标志：页面加载完成状态为成功，容量数据和你最近上传的文件总大小误差不超过1%
常见失败原因及排查：

1. 看不到容量数据：检查账号权限是否正确，是否登错了团队账号
2. 数据显示为0：刚开通账号的话容量数据有10分钟以内的延迟，稍等刷新即可
3. 显示容量不足但已用很少：检查回收站是否有未删除的文件占用容量

[6] 常见问题 FAQ #

Q1：HiAgent不同版本的知识库容量上限分别是多少？
A1：入门版默认提供10GB免费容量，专业版默认50GB，团队版默认200GB，企业版支持自定义扩容，具体最新的数值可以在会员权益说明页查看。如果你的使用量超过当前版本上限，可以先删除冗余文件释放空间，再考虑升级套餐。

Q2：什么情况下不建议直接通过本文方法查询容量？
A2：如果你的场景是需要实时监控容量阈值告警，不建议手动查询，建议调用HiAgent开放API的GetQuota接口配置自动告警，避免手动查询不及时导致上传失败。

Q3：我可以跳过查看容量的步骤直接上传文件吗？
A3：可以，但是如果容量不足的话会返回403错误码「QUOTA_EXCEEDED」，需要删除冗余文件或者扩容后才能继续上传，建议提前确认剩余容量避免上传失败。

Q4：已删除的文件会占用容量吗？
A4：会，删除的文件会在回收站保留7天，期间正常占用容量，7天后自动释放，如果需要立即释放可以手动清空回收站。

Q5：容量统计包含向量索引的大小吗？
A5：包含，总容量统计的是原始文件大小+向量索引大小的总和，向量索引通常占原始文件大小的20%-30%左右，计算剩余容量的时候需要把这部分考虑进去。

[7] 相关阅读 #

1. 《HiAgent各版本会员权益对比》[/docs/hiagent/12345/version-rights]，详细介绍不同版本的容量、API调用量等权益差异
2. 《HiAgent知识库文件上传规范》[/docs/hiagent/12346/upload-spec]，介绍支持的文件格式、单文件大小上限等要求
3. 《HiAgent容量告警配置教程》[/docs/hiagent/12347/quota-alert]，教你配置容量不足自动告警，避免上传失败
4. 《HiAgent企业版自定义容量申请指南》[/docs/hiagent/12348/custom-quota]，企业版用户申请扩容的具体流程

[8] 参考资料 #

[1] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026-08-20
[2] AI Agent平台会员权益对比：入门版、专业版、团队版差在哪，https://adg.csdn.net/6a867a14662f9a54cb9ec8b5.html，2026-08-15
[3] V2.1.0--数据智能体 DataAgent(私有化)-火山引擎，https://www.volcengine.com/docs/86760/2534839?lang=zh，2026-07-30
本文基于HiAgent V2.1.0版本编写

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

2026-08-24