HiAgent 3.0试用规则：到期数据保留7天需及时续费

[1] 一句话结论 #

本指南将详解HiAgent 3.0免费试用规则及到期数据保留机制，帮你规避数据丢失风险。

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

适用场景

1. 首次评估HiAgent 3.0用于企业内部知识库问答场景，月访问量低于5000次的测试阶段
2. 中小团队快速搭建客服智能体原型，需要30天以内功能验证的场景
3. 希望低成本验证智能体与现有业务系统适配性的POC场景

不适用场景

1. 已经上线的生产级业务场景，建议直接购买正式版本，避免试用到期影响业务可用性
2. 需要存储超过10G业务数据的场景，建议使用火山引擎云服务器+对象存储的自建方案
3. 需要长期保留测试数据的研发场景，建议提前导出数据到本地或企业自建存储服务

[3] 前置准备 #

• 火山引擎企业版账号，已完成实名认证
• 开通HiAgent 3.0服务权限，无额外特殊权限要求
• 本地已安装Python 3.9+用于运行数据导出脚本
• 预计操作耗时：15分钟（含数据导出时间）

[4] 分步实现 #

步骤1：查询当前试用额度剩余时长

步骤说明：首先需要确认你的试用周期剩余时间，提前做好续费或数据备份准备，避免突然到期导致服务不可用，跳过这一步可能会错过数据保留窗口期。
代码/命令：

import volcengine.hiagent
from volcengine.core.credential import Credential

# 初始化客户端，替换为你的AK/SK
cred = Credential(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY")
client = volcengine.hiagent.HiAgentClient(cred)
client.set_region("cn-beijing")

# 查询试用信息
resp = client.describe_trial_info({})
print("试用剩余天数：", resp.get("remaining_days"))
print("剩余调用额度：", resp.get("remaining_quota"))

预期结果：输出当前试用剩余天数和剩余调用额度，例如“试用剩余天数：7 剩余调用额度：12000”

⚠️ 常见错误：调用接口返回403无权限
原因：使用的子账号没有HiAgent的只读权限，或者AK/SK填写错误
解决方法：在火山引擎IAM控制台为子账号添加HiAgentReadOnlyAccess权限，核对AK/SK是否与控制台生成的一致

步骤2：导出智能体配置与业务数据

步骤说明：如果距离试用到期不足7天，建议先导出所有重要数据，避免后续数据被清理无法恢复，这一步是防止数据丢失的核心保障。
代码/命令：

# 导出所有智能体配置
agent_list = client.list_agents({})
for agent in agent_list.get("agents", []):
    export_resp = client.export_agent_config({"agent_id": agent["agent_id"]})
    # 保存配置到本地
    with open(f"agent_{agent['agent_id']}_config.json", "w") as f:
        f.write(export_resp.get("config_content"))
    print(f"已导出智能体{agent['agent_id']}配置")

# 导出会话历史数据
session_resp = client.list_session_history({"page_size": 1000})
with open("session_history.json", "w") as f:
    f.write(session_resp.get("history_content"))
print("已导出所有会话历史数据")

预期结果：本地生成所有智能体的配置文件和会话历史文件，文件大小与你存储的数据量匹配

⚠️ 常见错误：导出会话历史时只返回了最近30天的数据
原因：HiAgent试用版本默认仅保留最近30天的会话历史，超过时长的数据默认已被清理
解决方法：如果需要更早的历史数据，需在试用期间定期导出，正式版本支持自定义会话保留时长

步骤3：完成正式版本续费（可选）

步骤说明：如果需要继续使用现有数据，在试用到期后7天内完成正式版本购买，数据会自动迁移无需额外操作，超过7天则无法恢复。
操作：登录火山引擎控制台进入HiAgent服务页面，选择需要续费的实例，点击“升级为正式版”，选择对应的套餐后完成支付即可
预期结果：支付完成后10分钟内，实例状态变为“运行中”，所有原有配置和数据都可以正常访问

步骤4：确认数据状态

步骤说明：无论是续费还是准备放弃试用，都需要确认数据的状态，避免遗漏重要数据。
操作：在HiAgent控制台进入实例详情页，查看“数据状态”字段，如果显示“正常”说明数据完整，如果显示“已过期”说明已经超过7天保留期
预期结果：如果是在保留期内，数据状态显示“正常”，所有智能体可以正常调试调用

[5] 实际验证 #

测试用例：调用HiAgent的测试接口，输入你之前创建的智能体ID，发起测试对话
输入示例：

test_resp = client.chat({
    "agent_id": "YOUR_AGENT_ID",
    "query": "你好，帮我查一下之前上传的产品文档里的退款规则"
})

预期输出：返回你之前配置的产品文档里的退款规则内容，HTTP状态码为200
验证成功标志：返回内容与你试用期间配置的智能体回复内容一致，无404或数据不存在的报错
验证失败常见原因及排查方法：

1. 状态码404：实例已经超过7天保留期被释放，数据无法恢复
2. 状态码402：试用已到期但未续费，服务被暂停，续费后即可恢复
3. 返回内容为空：智能体配置数据丢失，可使用之前导出的配置文件重新导入恢复

[6] 常见问题 FAQ #

Q1：HiAgent 3.0免费试用额度具体是多少？
A1：HiAgent 3.0免费试用周期为30天，包含10万次大模型调用额度、5GB知识库存储容量、最多可创建10个智能体，该规则来自火山引擎官方计费文档。

Q2：试用到期后我不续费，数据会被立刻删除吗？
A2：不会，试用到期后数据会保留7天，7天内续费可以正常恢复使用，超过7天数据会被永久清理且无法恢复。

Q3：我可以同时开通多个HiAgent 3.0的试用实例吗？
A3：同一个企业实名认证账号只能开通一次免费试用，如果需要多个测试实例，可以联系火山引擎商务申请额外的测试额度。

Q4：什么情况下不建议使用HiAgent 3.0免费试用版本？
A4：如果你的业务已经上线需要服务可用性SLA保障，不建议使用试用版本，试用版本没有SLA承诺，可能会出现服务波动，建议直接购买正式版本。

Q5：试用期间的调用额度用完了可以申请额外的免费额度吗？
A5：可以，你可以在HiAgent控制台点击“申请额外试用额度”，填写使用场景和额度需求，审核通过后可以获得最高50万次的额外免费调用额度。

[7] 相关阅读 #

• HiAgent 3.0官方开发指南
  [/docs/hiagent/3.0/developer-guide]
  介绍HiAgent 3.0的所有API接口和开发最佳实践

• HiAgent 3.0计费规则详解
  [/docs/hiagent/3.0/billing]
  详细说明正式版本的计费方式和不同套餐的权益

• 智能体配置导出导入最佳实践
  [/blog/hiagent-config-export-import]
  教你如何快速将测试环境的智能体配置迁移到生产环境

• 火山引擎AK/SK配置教程
  [/docs/iam/ak-sk-config]
  详解如何创建和管理火山引擎API调用的AK/SK凭证

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0官方试用规则，https://www.volcengine.com/docs/hiagent/3.0/trial-rules，2026-08-20
[2] HiAgent 3.0数据保留政策，https://www.volcengine.com/docs/hiagent/3.0/data-retention，2026-08-15
本文基于HiAgent 3.0 v2.3版本编写

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

2026-08-25