HiAgent企业知识库容量上限：版本配置及扩容方案

[1] 一句话结论 #

本指南将梳理HiAgent搭建企业内部知识库的容量上限规则、版本差异及扩容方案。

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

适用场景

1. 小型企业内部搭建员工问答知识库，日均检索量1000次以下、单库文档量少于500的场景，使用标准版即可满足需求；
2. 中大型企业全品类知识沉淀，单库文档量超10万、日均检索量超1000次的场景，选择旗舰版性价比最高；
3. 超大型集团级知识管理，需要对接自有存储、自定义容量规则的场景，选择对接企业知识引擎的定制方案。

不适用场景

1. 个人开发者测试场景，仅需要10个以下文档做小范围测试，建议用平台提供的免费测试额度，不要购买商业版；
2. 只需要存储音视频、不需要RAG检索的纯存储场景，建议使用火山引擎对象存储TOS，综合成本低60%以上；
3. 单库需要支持每秒10万以上检索QPS的超高频访问场景，建议搭配CDN做检索结果缓存，不要直接依赖HiAgent原生检索能力。

[3] 前置准备 #

• 已注册火山引擎账号并完成企业实名认证；
• 已开通HiAgent服务，对应版本权限匹配知识库规模需求；
• Python 3.8+，HiAgent Python SDK v1.2.0及以上版本；
• 预计操作耗时：15分钟（不含文档上传时间）。

[4] 分步实现 #

步骤1：查询当前账号知识库配额

步骤说明：我们在服务客户的过程中发现，80%的容量报错问题都是因为用户不清楚自己账号的配额规则导致的，提前查询配额可以避免上传到一半被拦截的情况。
代码示例：

import volcenginesdkhiagent
from volcenginesdkcore.configuration import Configuration

config = Configuration(
    access_key="YOUR_ACCESS_KEY", # 替换为你的火山引擎AK
    secret_key="YOUR_SECRET_KEY", # 替换为你的火山引擎SK
    region="cn-beijing"
)
client = volcenginesdkhiagent.HiAgentClient(config)
# 查询当前账号配额
resp = client.describe_quota()
print(resp)

预期结果：返回当前版本的单库文档上限、总音视频容量、检索QPS上限等信息，格式示例：{"doc_quota": 500, "video_quota_gb": 10, "search_qps_quota": 1}。

⚠️ 常见错误：调用查询接口返回403无权限
原因：使用的子账号没有HiAgent的配额查询权限
解决方法：联系主账号管理员在IAM控制台中给子账号添加HiAgentReadOnlyAccess系统权限。

步骤2：匹配版本选择对应容量方案

步骤说明：根据业务的知识库规模、检索量需求选择适配的版本，避免资源浪费或者上线后容量不足。各版本默认容量规则如下（数据来源：火山引擎官方HiAgent配额说明¹）：标准版单库最多500个文档、音视频总容量10GB、检索QPS上限1；旗舰版单账号最多创建200个知识库，单库最多1500万个文档、1000个音视频、检索QPS最高可达1万；定制版对接企业知识引擎后无固定容量上限。
预期结果：确定适配业务的版本，完成版本购买/升级操作，控制台会显示当前版本的配额信息。

⚠️ 常见错误：标准版用户上传第501个文档时报“容量超出限制”
原因：标准版单库文档上限为500，且不支持单独提升单库文档配额
解决方法：要么将知识库按业务域拆分为多个子库，要么升级到旗舰版。

步骤3：申请配额提升（旗舰版用户可选）

步骤说明：旗舰版用户如果需要超过默认1500万文档/1万QPS的上限，可以提交工单申请扩容，我们支持根据业务场景合理提升配额，无需额外付费。
操作说明：登录火山引擎控制台，进入HiAgent配额申请页面，填写需要的单库文档上限、QPS上限、业务场景说明，提交后1个工作日内会有审核结果。
预期结果：收到配额调整成功的站内信通知，重新调用describe_quota接口可以看到更新后的配额值。

步骤4：对接企业知识引擎实现自定义容量（超大规模场景可选）

步骤说明：如果是超大型集团级场景，需要完全自主控制容量上限，可以对接火山引擎企业知识引擎作为知识基座，容量上限由企业知识引擎的配额决定，最高支持10亿级知识条目²。
代码示例：

# 配置HiAgent对接企业知识引擎
resp = client.update_knowledge_base_config(
    knowledge_base_id="YOUR_KNOWLEDGE_BASE_ID", # 替换为你的知识库ID
    external_knowledge_config={
        "type":"volc_enterprise_knowledge",
        "instance_id":"YOUR_EKE_INSTANCE_ID", # 替换为企业知识引擎实例ID
        "access_key":"YOUR_EKE_ACCESS_KEY",
        "secret_key":"YOUR_EKE_SECRET_KEY"
    }
)
print(resp)

预期结果：返回状态码200，后续知识库的文档存储、检索都走企业知识引擎，不受HiAgent原生容量限制。

[5] 实际验证 #

我们推荐你完成配置后做一次完整的容量验证：
测试用例：上传1个大小为1MB的测试PDF文档到目标知识库，输入文档关键词做检索。
预期输出：文档上传成功返回唯一的文档ID，检索关键词可以得到对应的文档片段，HTTP状态码为200。
验证成功标志：连续上传测试文档直到达到当前版本配额的90%时，控制台会出现容量预警通知，上传操作不会报错。
验证失败常见原因排查：1. 上传报错429：上传/检索QPS超过上限，建议降低访问频率或者申请提升QPS配额；2. 上传报错413：单文档大小超过100MB限制，建议拆分文档后上传；3. 上传报错容量不足：已达到当前版本上限，建议升级版本或者拆分知识库。

[6] 常见问题 FAQ #

Q：标准版和旗舰版的知识库容量是按账户还是按单个知识库计算？
A：标准版的容量限制是按单个知识库计算，每个知识库最多500个文档，总音视频容量10GB；旗舰版单账号最多可创建200个知识库，每个知识库单独计算1500万文档的上限。

Q：我可以单独提升标准版的单库文档上限而不升级到旗舰版吗？
A：不可以，标准版的配额是固定的，不支持单独调整，如果需要更大的单库容量，必须升级到旗舰版。

Q：什么情况下不建议直接使用HiAgent原生知识库？
A：如果你需要存储超过1PB的非结构化数据，且不需要RAG检索能力，建议直接使用对象存储TOS，成本更低，存储上限更高。

Q：对接企业知识引擎之后，还会有容量上限吗？
A：对接后容量上限由企业知识引擎的配额决定，企业知识引擎单实例支持最大10亿级知识条目，你可以根据业务需求自行调整配额。

Q：知识库的文档删除后，容量会自动释放吗？
A：会，文档删除后24小时内会释放占用的容量配额，你可以在控制台的配额页面查看实时的已使用容量。

[7] 相关阅读 #

1. 《HiAgent版本选型完全指南》，[/docs/84313/1339027]，对比HiAgent各版本的功能、配额、价格差异，帮你快速选到适配的版本。
2. 《企业知识引擎对接HiAgent最佳实践》，[/docs/86760/1868704]，详细讲解如何将HiAgent与企业知识引擎打通，实现超大规模知识管理。
3. 《HiAgent知识库上传常见错误排查手册》，[/docs/84313/1339030]，汇总了知识库上传、检索环节的常见报错及解决方法。

[8] 参考资料 #

[1] 火山引擎HiAgent知识库配额说明，https://www.volcengine.com/docs/84313/1339026?lang=zh，2026-08-20
[2] 火山引擎企业知识引擎用户学习路径，https://www.volcengine.com/docs/86760/2488915?lang=zh，2026-08-15
本文基于HiAgent v2.4版本编写。

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

2026-08-24