HiAgent 3.0知识库扩容：默认10M，附完整调整步骤

[1] 一句话结论 #

本指南将讲解HiAgent 3.0知识库容量规则，以及扩容的完整操作流程。

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

适用场景

1. 企业用户知识库文档总量超过10M，用于内部客服问答、员工培训场景的；
2. 日均知识库查询量超过1000次，需要扩充知识库覆盖更多业务场景的；
3. 单用户已创建20个知识库仍无法满足业务分类需求的。

不适用场景

1. 个人测试场景仅需存储小于10M文档，无需扩容，直接使用免费额度即可；
2. 需要单文件超过500KB上传的场景，建议先拆分文件再上传，不要直接申请扩容；
3. 仅需要临时存储知识库内容的场景，建议使用本地知识库工具而非HiAgent扩容。

[3] 前置准备 #

• 已注册并完成实名认证的火山引擎HiAgent 3.0账号，拥有知识库管理权限
• 已确认当前知识库已用容量/数量达到上限，明确需要扩容的具体规格
• 提前准备扩容申请材料：业务场景说明、预计存储容量、日均查询量
• 预计耗时：提交申请后1-3个工作日完成审核与配置

[4] 分步实现 #

步骤1：登录平台确认当前容量使用情况

步骤说明：首先要确认自己的容量确实达到上限，避免盲目申请扩容，跳过这一步可能会导致申请被驳回。我们在对接客户的过程中发现，近30%的扩容申请是用户误判容量不足导致的。
操作：登录HiAgent 3.0控制台，进入「知识库管理」页面，在页面顶部查看当前已使用存储、剩余存储、已创建知识库数量。
预期结果：可以看到类似“已使用存储：9.8M/10M，已创建知识库：19/20”的提示。

⚠️ 常见错误：显示容量已用100%但实际上传的文件总大小不足10M
原因：删除知识库文件后，系统后台的向量索引资源不会立即释放，存在24小时的缓存周期
解决方法：等待24小时后再查看容量使用情况，若仍显示已满再提交扩容申请。

步骤2：提交扩容申请

步骤说明：根据部署版本选择正确的申请渠道，提交清晰的申请材料可以大幅提升审核通过率。
操作：如果是公有云版本，点击「知识库管理」页面右上角的「扩容申请」按钮，填写需要提升的存储容量、知识库数量上限、业务场景说明，提交后等待商务人员联系；如果是私有化部署/校园版本，直接联系对应的运维对接人提交申请。
预期结果：提交成功后会收到系统提示“您的扩容申请已提交，我们将在1个工作日内与您联系”。

⚠️ 常见错误：扩容申请提交后3天没有收到反馈
原因：申请材料中没有明确业务场景和使用规模，被系统判定为无效申请自动驳回
解决方法：在工单中补充业务场景的具体数据，比如“用于电商客户服务，预计存储1000条产品文档，日均查询量5000次”，重新提交申请。

步骤3：确认扩容结果

步骤说明：审核通过后平台会后台调整容量上限，需要手动验证是否生效，避免后续上传文件失败。
操作：收到扩容完成的通知后，回到「知识库管理」页面刷新，查看新的容量上限，尝试上传一个测试文件验证。
预期结果：页面显示的总容量和知识库数量上限已更新为申请的规格，测试文件可以正常上传。

[5] 实际验证 #

我们提供一个标准测试用例供你验证扩容是否生效：
测试用例：申请扩容到100M存储、50个知识库上限后，上传一个400KB的测试文档到第21个新建的知识库。
输入：新建知识库“测试扩容知识库”，上传400KB的PDF文件。
预期输出：知识库创建成功，文件上传完成，状态显示“已解析”，接口返回HTTP 200状态码。
验证成功标志：容量使用明细显示已用存储增加400KB，知识库总数显示21/50。
验证失败常见原因排查：

1. 容量没有更新：联系商务对接人确认是否已经后台配置完成；
2. 文件上传失败：检查文件大小是否超过500KB，格式是否为支持的PDF/Word/TXT格式；
3. 无法创建新的知识库：确认申请的知识库数量上限是否包含扩容的数量。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0默认的知识库容量上限是多少？
A1：公有云版本默认免费存储容量为10M，单用户最多可以创建20个知识库，单文件上传大小不超过500KB，数据来源为火山引擎HiAgent官方使用文档¹。

Q2：扩容申请提交后多久可以生效？
A2：材料齐全的情况下，公有云版本一般1个工作日内完成审核与配置，私有化部署版本取决于运维团队的处理效率，一般3个工作日内可以完成。

Q3：我可以只扩容知识库数量，不扩容存储容量吗？
A3：可以，提交申请的时候明确说明只需要调整知识库数量上限即可，不需要额外支付存储扩容的费用。

Q4：什么情况下不建议申请HiAgent知识库扩容？
A4：如果你的知识库总容量不足10M，或者仅用于个人测试场景，不建议申请扩容，免费额度已经足够使用，扩容会产生额外的费用；如果需要存储超过1GB的大型文档库，建议使用火山引擎对象存储+RAG单独搭建知识库方案，成本比HiAgent扩容低30%左右。

Q5：扩容后的容量可以降级吗？
A5：目前暂不支持容量降级，申请扩容前请先评估实际的存储需求，避免资源浪费。

[7] 相关阅读 #

1. 《HiAgent 3.0知识库管理最佳实践》，[/docs/86760/1900001]，讲解知识库文件拆分、索引优化的实操方法
2. 《HiAgent 3.0计费规则详解》，[/docs/86760/1890002]，包含知识库扩容的具体定价标准
3. 《基于HiAgent搭建企业内部客服智能体教程》，[/blog/hiagent-customer-service]，包含知识库在客服场景的落地方法
4. 《HiAgent 3.0常见问题排查手册》，[/docs/86760/1880005]，汇总了知识库使用过程中的常见报错解决方案

[8] 参考资料 #

[1] 火山引擎HiAgent官方使用文档，https://www.volcengine.com/docs/86760/1868704，2026-08-20
[2] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026-07-15
本文基于HiAgent 3.0公有云v2.4版本编写

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

2026-08-25