HiAgent 3.0知识库容量上限：包含附件及配额规则解读

[1] 一句话结论 #

本指南将明确HiAgent 3.0知识库容量上限是否包含附件，附配套配额规则与实操避坑指南。

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

适用场景

1. 企业需要搭建挂载PDF、合同、音视频等多格式附件的智能客服、内部员工答疑等RAG场景；
2. 单知识库文档量在1500万以内、向量存储需求≤9999GB的企业级智能体落地场景；
3. 需要统一管控知识库所有类型文件存储配额，避免超额导致业务中断的运营场景。

不适用场景

1. 单知识库需要存储超过1500万份文档的超大规模RAG场景，建议参考火山引擎向量数据库+大模型RAG自研方案；
2. 仅需要存储纯文本数据、无附件上传需求的轻量化场景，建议使用豆包API原生知识库功能，成本更低；
3. 单附件大小超过【需补充：HiAgent3.0单附件最大支持大小】的场景，建议先拆分附件再上传，或对接对象存储单独存放附件。

[3] 前置准备 #

• 已开通火山引擎HiAgent 3.0账号，拥有知识库管理权限
• 确认当前账号所属版本（标准版/旗舰版）对应的基础配额
• 准备好待上传的测试附件（支持PDF/DOC/音视频等官方兼容格式）
• 预计操作耗时：15分钟

[4] 分步实现 #

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

步骤说明：先确认自己的HiAgent版本对应配额，避免后续上传超出限制被拦截，跳过这一步可能会出现上传到一半被驳回影响业务进度。
操作路径：登录火山引擎HiAgent控制台，进入「知识库管理」-「配额信息」页面即可查看。
预期结果：页面清晰展示当前版本的单知识库文档数上限、音视频容量上限、向量存储上限三类核心配额值。

⚠️ 常见错误：看到的配额和官方宣传的3.0版本配额不一致
原因：账号可能是从2.x版本升级到3.0，配额未自动同步，或者是专属定制版配额有特殊调整
解决方法：提交工单联系火山引擎客服，申请同步3.0版本最新配额，一般1个工作日内可以完成调整。

步骤2：上传附件到知识库

步骤说明：直接上传需要加入知识库的各类附件，平台会自动解析内容生成向量，附件本身的存储大小和解析后的向量都会计入配额。
代码示例（API上传）：

import volcengine.hiagent
# 初始化客户端
client = volcengine.hiagent.Client(endpoint='hiagent.volcengineapi.com')
client.set_ak('YOUR_ACCESS_KEY') # 替换为你的AK
client.set_sk('YOUR_SECRET_KEY') # 替换为你的SK

# 上传附件接口调用
resp = client.upload_knowledge_file(
    knowledge_base_id='YOUR_KNOWLEDGE_BASE_ID', # 替换为你的知识库ID
    file_path='./test_contract.pdf', # 替换为本地附件路径
    auto_parse=True # 开启自动解析，关闭则仅存储附件不生成向量
)
print(resp)

预期结果：返回HTTP 200状态码，响应体包含file_id、parse_status字段，parse_status为pending表示正在后台解析。

⚠️ 常见错误：上传音视频附件后配额扣减远大于文件本身大小
原因：音视频解析后生成的字幕文本、对应的向量数据都会额外占用向量存储配额，不是仅计算原文件大小
解决方法：上传大体积音视频前先预估解析后大小，预留3倍于原文件的配额空间，避免中途超额。

步骤3：查看已使用配额

步骤说明：上传完成后查看当前已使用的配额，判断剩余空间是否满足后续上传需求，避免高峰期上传失败。
操作路径：在「知识库管理」点击对应知识库进入详情页，查看「配额使用统计」模块。
预期结果：能看到文档数已用/总量、音视频容量已用/总量、向量存储已用/总量三类数据实时更新（解析完成后10分钟内同步）。

步骤4：配置超额预警

步骤说明：配置配额阈值告警，避免突然超出上限导致业务不可用，跳过这一步可能会出现业务高峰期用户上传知识库失败的问题。
操作路径：进入「监控告警」-「告警规则」，新建知识库配额使用率告警，触发阈值设为80%，通知方式选择飞书/短信/邮件。
预期结果：配额使用率达到80%时会收到告警通知，可以提前处理扩容或者清理无用文件。

[5] 实际验证 #

测试用例：上传一个1MB的10页纯文本PDF合同文件，开启自动解析。
预期输出：上传成功后，文档数已用配额+1，向量存储已用配额增加约0.5MB（解析后的文本向量大小），搜索合同内的特定关键词能返回对应内容片段。
验证成功标志：HTTP 200状态码，搜索结果匹配，配额统计页数据更新正确。
常见失败原因排查：

1. 配额统计未更新：等待5-10分钟，解析完成后数据会同步，若仍未更新可刷新页面或提交工单排查；
2. 上传失败提示配额不足：先删除回收站中无用的旧文件释放配额，或升级到更高版本获得更大配额；
3. 附件上传后搜索不到内容：检查附件解析状态是否为success，若解析失败可重新上传或手动录入内容。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0知识库容量上限包含附件文件吗？
A1：包含，上传的所有格式附件的数量、原文件存储空间、解析后生成的向量数据，都会计入对应版本的知识库配额上限。

Q2：标准版和旗舰版的知识库配额分别是多少？
A2：根据火山引擎官方公开数据¹，标准版单知识库最多可上传500个文档，音视频总容量上限10GB，向量存储空间100GB；旗舰版单知识库最多支持1500万个文档，音视频上限1000个，向量存储空间可达9999GB。

Q3：什么情况下不建议使用HiAgent 3.0原生知识库？
A3：如果你的单知识库需要存储超过1500万份文档，或者有自定义向量检索逻辑的需求，不建议使用原生知识库，建议对接火山引擎自研向量数据库实现RAG功能，灵活性更高。

Q4：我可以只上传附件不解析内容吗，这样会不会占用配额？
A4：可以关闭自动解析开关，但附件本身的存储空间还是会计入配额，只是不会占用向量存储配额。不过未解析的附件无法被检索到，仅能作为关联文件下载。

Q5：删除文件后配额会立即释放吗？
A5：不会，删除的文件会进入回收站保留7天，期间仍会占用配额，需要手动清空回收站才会立即释放配额。

Q6：HiAgent3.0支持的附件格式有哪些？
A6：目前支持PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX、TXT、MP3、MP4、JPG、PNG等常见格式，其他格式建议先转换为上述格式再上传。

[7] 相关阅读 #

1. 《HiAgent 3.0知识库搭建全流程指南》[/docs/84313/1339027]：从0到1搭建可生产可用的HiAgent知识库实操教程
2. 《HiAgent 3.0版本升级说明》[/docs/84313/1339028]：HiAgent 3.0相比2.x版本的新增功能与配额调整详细说明
3. 《HiAgent API官方文档》[/docs/84313/1339029]：知识库上传、管理、检索相关的API接口参数与调用示例
4. 《HiAgent价格计费说明》[/docs/84313/1339030]：各版本HiAgent的定价与对应配额权益对照表

[8] 参考资料 #

[1] 火山引擎官方文档：知识库配额说明，https://www.volcengine.com/docs/84313/1339026?lang=zh，2026-08-20
[2] CSDN博客：FORCE 2026 现场发布 HiAgent 3.0 完整解读，https://blog.csdn.net/lpfasd123/article/details/162229660，2026-06-25
本文基于HiAgent 3.0 2026年6月正式发布版本编写。

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

2026-08-25