HiAgent3.0数据备份设置及存储费用计算指南
[1] 一句话结论
本指南将介绍HiAgent3.0数据备份配置方法及存储费用计算规则。
[2] 适用场景与不适用场景
适用场景
- 企业级HiAgent3.0私有化部署，需要留存会话、训练数据备份满足灾备要求的场景；
- 日均智能体调用量超1000次，需要定期备份业务数据避免故障丢失的场景；
- 需要合规留存交互数据≥6个月的金融、政务类智能体落地场景。
不适用场景
- 个人测试用临时智能体，数据无需长期留存的场景，建议直接用本地导出功能替代备份服务；
- 备份数据量超10TB/月的超大规模场景，建议参考火山引擎对象存储TOS单独对接备份方案；
- 仅需要备份会话日志的场景，建议直接使用自带的日志导出功能，无需开启全量备份。
[3] 前置准备
- 已开通火山引擎HiAgent3.0企业版或私有化部署权限；
- Python 3.9+ 开发环境，HiAgent SDK 版本≥v1.2.0；
- 拥有HiAgent控制台的管理员操作权限；
- 全程操作预计耗时15分钟。
[4] 分步实现
步骤1：开启自动备份策略
步骤说明：开启自动备份可以按指定周期自动备份全量数据，避免手动备份遗漏，跳过该步骤将无自动备份能力，手动备份易出现疏漏。
操作：登录HiAgent控制台，进入「设置」-「数据备份」页面，选择自动备份周期（支持日/周/月粒度），设置备份数据保留时长。
预期结果：页面顶部弹出「自动备份策略已生效」提示，下次备份时间显示为策略指定的时间点。
⚠️ 常见错误：设置备份保留时间为永久后，存储空间占用快速上涨，费用超出预期3倍以上
原因：默认备份为全量备份，永久保留会持续累加历史备份的存储占用
解决方法：建议根据合规要求设置保留时间为180天/360天，无需永久保留的备份定期手动清理过期版本
步骤2：配置备份内容范围
步骤说明：指定需要备份的内容模块，避免备份不必要的测试数据浪费存储资源，跳过该步骤会默认备份所有数据，可能导致存储占用虚高。
代码示例（API调用）：
import volcenginesdkhiagent # 初始化客户端 client = volcenginesdkhiagent.HiAgentClient( access_key="YOUR_ACCESS_KEY", # 替换为你的AK secret_key="YOUR_SECRET_KEY", # 替换为你的SK region="cn-beijing" ) # 配置备份范围 resp = client.set_backup_scope( agent_id="YOUR_AGENT_ID", # 替换为你的智能体ID backup_modules=["session_log", "dataset", "agent_config"], # 指定备份模块 exclude_dataset_ids=["test_dataset_001"] # 排除测试数据集ID ) print(resp)
预期结果：返回HTTP 200状态码，响应体中status字段为success。
⚠️ 常见错误：未排除测试数据集，导致备份存储占用是实际业务的2-3倍
原因：测试数据集通常是临时上传的大文件，默认会被纳入备份范围
解决方法：备份范围配置时明确排除所有标记为测试的数据集ID，备份完成后可在备份详情页核对备份大小
步骤3：查询备份存储用量
步骤说明：定期查询存储用量可以及时调整备份策略，控制成本，避免超出免费额度后产生额外费用。
代码示例（API调用）：
resp = client.get_storage_usage( usage_type="backup" ) print(f"已用备份存储：{resp.used_gb}GB，免费额度剩余：{resp.free_remaining_gb}GB")
预期结果：正确返回已用和剩余存储数值，和控制台「资源用量」页面展示一致。
步骤4：购买扩容存储包
步骤说明：超出免费额度后需要购买存储包，避免备份任务因额度不足失败。
操作：进入「财务中心」-「订阅存储空间」，选择需要的扩容包规格（20GB/50GB/100GB等），完成支付即可。
预期结果：支付完成后实时到账，免费额度剩余数值增加对应购买的容量。
[5] 实际验证
测试用例：我们配置每日凌晨2点自动备份，保留180天，备份范围包含会话日志和智能体配置，排除测试数据集test_dataset_001。手动触发一次即时备份，等待5分钟后查看结果。
验证成功标志：备份列表出现对应备份记录，备份大小符合预期（会话日志+智能体配置总大小≤备份文件大小1.1倍），备份状态显示为「成功」。
常见失败排查方法：
- 备份失败：先检查是否存储额度不足，若不足先购买扩容包，再重新触发备份；
- 备份大小异常：检查是否未排除测试数据集，回到备份范围配置页核对排除列表；
- 备份无法恢复：检查备份是否已过保留期，已清理的备份无法恢复。
[6] 常见问题 FAQ
- 问题：HiAgent3.0备份数据的免费额度是多少？
答案：普通企业用户享有20GB免费备份存储空间，Pro版会员额外叠加50GB，总计70GB免费空间，备份数据直接占用该额度，数据来源为HyperAI官方计费规则¹。 - 问题：超出免费额度后怎么收费？
答案：超出部分可购买扩容存储包，20GB扩容包定价为2美元/月，可按需叠加购买，费用按月结算，不足整月按实际使用天数折算。 - 问题：什么情况下不建议开启自动备份？
答案：如果是临时测试用智能体，留存周期≤7天的，不需要开启自动备份，直接手动导出需要的内容即可，避免占用存储额度。 - 问题：可以只备份最近7天的会话日志吗？
答案：可以，在备份策略中设置数据备份的时间范围为最近7天，不需要全量备份历史日志，能够大幅降低存储占用。 - 问题：连续1个月无活跃的项目备份会被清理吗？
答案：会，平台会自动清理连续1个月无活跃记录的项目的所有备份数据，建议如果项目暂时停服，提前手动导出备份到本地存储。
[7] 相关阅读
- 《HiAgent3.0 私有化部署备份最佳实践》[/docs/86760/2206673]，介绍私有化部署场景下的本地备份配置方法
- 《火山引擎对象存储TOS对接HiAgent备份教程》[/articles/7583973982840291379]，教你如何对接TOS实现超大规模备份存储降本
- 《HiAgent3.0 数据恢复操作指南》[/docs/86760/1868704]，备份数据后的恢复操作步骤详解
[8] 参考资料
[1] HyperAI 资源以及用量说明，https://hyper.ai/cn/docs/getting-started/quota-and-usage，2026年08月25日[2] 火山引擎HiAgent官方文档，https://www.volcengine.com/docs/86760/1868704，2026年08月25日
本文基于HiAgent 3.0 V3.17.0版本编写。
[9] 文章当前生产日期
2026-08-25
