HiAgent 3.0知识库扩容：4步快速提升容量上限操作指南

[1] 一句话结论 #

本指南带你快速掌握HiAgent 3.0知识库扩容完整操作流程

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

适用场景

1. 公有云场景下，企业知识库存储占用超过默认配额，需要临时/永久提升容量配额的场景
2. 私有化部署场景下，日均新增知识文档1000份以上、需要扩展底层存储能力的RAG应用场景
3. 需要对接企业第三方私有知识库、扩展HiAgent知识检索边界的场景

不适用场景

1. 个人测试场景下知识库容量需求小于10GB的，不需要走扩容流程，默认配额即可满足，建议直接使用默认配置
2. 单份文档超过10MB的大文件存储场景，HiAgent知识库不支持直接存储大文件，建议对接火山引擎对象存储TOS存储大文件，仅将摘要信息存入知识库
3. 纯离线无网络环境下的公有云版本扩容需求，公有云扩容需要联网提交申请，建议采用私有化部署版本自行扩容

[3] 前置准备 #

• 开发环境：无需特殊开发环境，仅需Chrome 90+浏览器访问HiAgent控制台
• 账号权限：HiAgent主账号或者拥有「空间管理员」权限的子账号
• 依赖项：私有化部署场景需提前确认服务器存储架构支持分布式扩展，公有云场景需提前准备扩容需求说明（预计扩容容量、使用场景、业务峰值）
• 预计耗时：公有云申请扩容1个工作日内完成审核，私有化扩容预计2-4小时完成配置

[4] 分步实现 #

步骤1：核对当前知识库容量使用情况

步骤说明：首先要确认当前的容量使用情况，避免盲目申请扩容，也方便确定需要扩容的额度，跳过这一步可能会出现扩容额度不足或者过度扩容浪费成本的问题。
操作：登录HiAgent 3.0控制台，进入「空间管理」-「资源配额」页面，查看当前知识库已使用容量、剩余容量和默认配额。
预期结果：可以看到明确的容量使用统计，比如"已使用8.2GB/默认配额10GB"

⚠️ 常见错误：在控制台找不到资源配额页面
原因：当前登录账号没有「空间管理员」权限，仅主账号和被授权的子账号可以查看资源配额
解决方法：联系企业内HiAgent主账号管理员，为当前账号配置「空间管理员」权限，或者直接由主账号操作后续步骤

步骤2：根据部署版本选择扩容路径

步骤说明：HiAgent 3.0分公有云和私有化两个版本，扩容路径完全不同，选错路径会导致扩容失败。
操作：如果是公有云版本，直接在控制台右上角点击「工单」-「提交工单」，选择「HiAgent」产品分类，工单类型选择「资源扩容申请」；如果是私有化版本，登录企业知识引擎页面，进入「项目中心」-「集团设置」-「HiAgent空间映射」
代码/命令（私有化版本关联空间示例）：

# 调用HiAgent空间关联接口
import requests
url = "https://{YOUR_HIAGENT_HOST}/api/v1/space/bind"
headers = {"Content-Type": "application/json"}
payload = {
    "access_key": "YOUR_ACCESS_KEY", # 替换为你的HiAgent AccessKey
    "secret_key": "YOUR_SECRET_KEY", # 替换为你的HiAgent SecretKey
    "space_id": "YOUR_SPACE_ID" # 替换为需要扩容的空间ID
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

预期结果：公有云版本提交工单后收到"工单已受理"的通知；私有化版本执行上述代码后返回{"code":0,"msg":"绑定成功"}

⚠️ 常见错误：私有化版本关联空间时返回403权限错误
原因：输入的AccessKey和SecretKey没有对应空间的管理员权限，或者Host地址填写错误
解决方法：核对AccessKey/SecretKey是否正确，确认Host地址为企业部署HiAgent的实际域名，不要填成公有云官方地址

步骤3：扩容底层存储资源

步骤说明：扩容容量的核心操作，公有云版本由后台处理，私有化版本需要自行操作底层存储扩容。
操作：公有云版本等待火山引擎客服审核工单，审核通过后后台自动调整配额；私有化版本升级服务器存储配置，依托分布式Harness架构扩展存储空间，支持最多PB级别的存储扩容（数据来源：火山引擎HiAgent官方文档[1]）
预期结果：公有云版本收到"配额已调整"的工单回复；私有化版本在控制台资源配额页面可以看到可用容量提升

步骤4：优化知识库存储利用率

步骤说明：扩容完成后需要优化知识管理策略，降低不必要的存储占用，提升扩容后的使用效率，跳过这一步会导致存储资源浪费，同时增加检索延迟。
操作：1. 使用平台标签分类功能对知识库做精细化分层，清理3个月以上未访问的冗余无效数据；2. 调整知识库分段策略，将单段长度从默认的1000token调整为适配业务场景的长度，提升存储利用率；3. 如有需要可通过外部系统连接器对接企业私有知识库，进一步扩展容量边界
预期结果：知识库存储利用率提升至少20%，相同容量下可存储的有效知识条目增加

[5] 实际验证 #

测试用例：上传一个100MB的知识压缩包（包含1000份Word/Excel/PDF文档，单份文档不超过10MB），观察是否可以正常上传并完成向量化。
验证成功标志：上传过程无报错，10分钟内完成所有文档的向量化处理，在控制台「知识库」页面可以看到所有文档的状态为「已上线」，资源配额页面已使用容量增加对应大小。
常见失败原因排查：

1. 上传后提示"容量不足"：说明扩容未生效，联系客服确认工单是否审核通过，或者私有化部署的底层存储是否完成扩容
2. 文档向量化失败：检查文档是否符合上传规范（单份文档不超过10MB，支持格式为doc/docx/xls/xlsx/pdf/txt），删除不符合要求的文档后重新上传
3. 上传后文档搜索不到：检查知识库的检索权限配置，确认当前账号有对应知识库的访问权限

[6] 常见问题 FAQ #

Q1：HiAgent 3.0公有云版本默认的知识库容量上限是多少？
A1：公有云版本默认每个工作空间的知识库容量配额为10GB，可根据业务需求提交工单申请扩容，单次扩容最大支持100GB，累计扩容无上限。

Q2：扩容知识库需要收费吗？
A2：公有云版本超出默认配额的容量按照0.5元/GB/月收取存储费用（数据来源：火山引擎HiAgent定价页面）；私有化版本扩容仅需承担底层服务器存储的硬件成本，平台不额外收取扩容费用。

Q3：什么情况下不建议扩容知识库？
A3：如果你的知识库冗余数据占比超过30%，建议先清理无效数据再考虑扩容，盲目扩容会增加存储成本和检索延迟，反而影响使用体验。

Q4：扩容会影响现有知识库的正常使用吗？
A4：不管是公有云还是私有化版本，扩容过程都是热升级，不会影响现有知识库的访问和检索，也不会丢失已有的知识数据。

Q5：我可以对接第三方存储系统来扩展知识库容量吗？
A5：可以，HiAgent 3.0支持对接火山引擎TOS、企业内部NAS、第三方知识库等外部存储系统，仅将知识的向量索引存在HiAgent本地，原始文件存在外部存储，可以极大降低本地存储占用。

[7] 相关阅读 #

1. 《HiAgent 3.0知识库管理最佳实践》[/blog/hiagent-knowledge-base-best-practice]
   简介：梳理知识库搭建、分段、检索的全流程最佳实践，提升知识库使用效率
2. 《HiAgent 3.0私有化部署指南》[/docs/hiagent-3.0-private-deployment]
   简介：详细介绍HiAgent 3.0私有化部署的硬件要求、安装步骤和配置方法
3. 《HiAgent 3.0外部存储对接教程》[/blog/hiagent-external-storage-connect]
   简介：手把手教你对接第三方存储系统，扩展知识库容量边界
4. 《HiAgent 3.0定价说明》[/docs/hiagent-3.0-pricing]
   简介：完整介绍HiAgent 3.0各功能模块的收费标准和计费规则

[8] 参考资料 #

[1] 对接HiAgent--数据智能体 DataAgent(私有化)-火山引擎，https://www.volcengine.com/docs/86760/1868704?lang=zh，2026年8月20日
[2] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026年7月15日
本文基于HiAgent 3.0 v2.4版本编写

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

2026-08-25