HiAgent 3.0收费标准及对话日志导出分析实战指南

[1] 一句话结论 #

本指南将详解HiAgent 3.0收费标准，带你完成对话日志导出与全流程分析操作。

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

适用场景

1. 适合已经接入HiAgent 3.0构建智能客服、对话机器人，需要统计月度调用成本、排查对话异常的开发者；
2. 适合需要定期导出全量对话日志做用户意图分析、会话质检的运营&技术团队，要求日均会话量≥100条；
3. 适合需要按业务线拆分HiAgent 3.0调用成本，做内部费用核算的企业用户。

不适用场景

1. 如果你的场景是仅测试HiAgent 3.0基础功能，无日志留存需求，建议直接用控制台自带的实时会话预览即可，无需走导出流程；
2. 如果你的会话数据量日均超过100万条，不建议直接用控制台导出功能，建议参考[HiAgent 3.0日志投递到对象存储TOS方案]做离线分析；
3. 如果你的场景是需要实时消费对话日志做告警触发，不建议用周期导出方案，建议参考[HiAgent 3.0日志流推送接口]实现。

[3] 前置准备 #

• 开发环境：Python 3.9+，若使用命令行操作需curl 7.68+；
• 账号权限：火山引擎主账号或者被授予HiAgent FullAccess权限的子账号；
• 依赖项：火山引擎Python SDK v1.0.12及以上版本；
• 预计耗时：30分钟（含配置、导出、测试验证全流程）。

[4] 分步实现 #

步骤1：查询HiAgent 3.0当前收费规则
步骤说明：首先确认你当前使用的HiAgent 3.0版本对应的计费项，避免后续成本核算错误，这一步是核算成本的基础，跳过会导致实际账单和预估不符。

import volcengine.imp.annotations.Param;
import volcengine.imp.service.HiAgentService;
// 初始化客户端
HiAgentService client = HiAgentService.getInstance();
client.setAccessKey("YOUR_ACCESS_KEY"); // 替换为你的AccessKey
client.setSecretKey("YOUR_SECRET_KEY"); // 替换为你的SecretKey
// 查询收费标准
String res = client.getBillingRules("HiAgent3.0");
System.out.println(res);

预期结果：返回包含基础调用费（0.002元/千tokens，来源：火山引擎HiAgent 3.0官方定价页2026版）、日志存储费（0.01元/GB/天）、导出服务费（0.005元/万条）的明细列表。

⚠️ 常见错误：查询到的收费标准和实际账单不符
原因：你使用的是HiAgent 3.0企业定制版，收费规则是单独签订的合同价，控制台公开接口返回的是公版定价
解决方法：联系你的火山引擎商务经理获取定制版计费规则，或者在费用中心账单明细页查看实际扣费项。

步骤2：配置对话日志导出权限
步骤说明：给子账号授予日志导出的专属权限，避免用主账号操作带来的安全风险，跳过会导致导出时返回403无权限报错。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "hiagent:ExportConversationLog",
        "hiagent:ListExportTask"
      ],
      "Resource": [
        "trn:hiagent:*:*:instance/YOUR_INSTANCE_ID" // 替换为你的实例ID
      ]
    }
  ]
}

预期结果：在IAM控制台保存权限策略后，绑定到对应子账号，子账号可正常访问日志导出页面。

步骤3：创建对话日志导出任务
步骤说明：按时间范围、会话标签筛选需要导出的日志，支持csv和json两种格式，导出任务会异步执行，无需等待。

# 创建导出任务
curl --location --request POST 'https://hiagent.volcengineapi.com/?Action=CreateExportTask&Version=2023-08-01' \
--header 'Authorization: HMAC-SHA256 Credential=YOUR_AK/20260825/cn-beijing/hiagent/request, SignedHeaders=content-type;host, Signature=YOUR_SIGNATURE' \
--header 'Content-Type: application/json' \
--data-raw '{
    "InstanceId": "YOUR_INSTANCE_ID",
    "StartTime": 1724457600, // 导出起始时间戳
    "EndTime": 1724544000, // 导出结束时间戳
    "ExportFormat": "json",
    "Filters": [{"Key":"scene","Value":"customer_service"}] // 可选，按场景筛选
}'

预期结果：返回HTTP 200，包含TaskId字段，比如{"TaskId":"exp-234567abc"}。

⚠️ 常见错误：创建导出任务时返回400参数错误
原因：选择的时间范围超过30天，单次导出最多支持30天内的日志
解决方法：拆分时间范围，按周/天分批创建导出任务，单次导出的日志条数不要超过1000万条。

步骤4：下载导出的日志文件
步骤说明：轮询导出任务状态，当状态变为success后，获取临时下载链接下载文件，链接有效期为1小时。

# 查询任务状态
curl --location --request GET 'https://hiagent.volcengineapi.com/?Action=GetExportTask&Version=2023-08-01&TaskId=exp-234567abc' \
--header 'Authorization: YOUR_AUTH_HEADER'

预期结果：当Status为success时，返回DownloadUrl字段，点击链接可直接下载日志压缩包。

步骤5：日志基础分析
步骤说明：用Python脚本对导出的日志做基础统计，比如会话平均轮次、用户问题Top10、未解决问题占比等。

import pandas as pd
# 读取日志
 df = pd.read_json("export_log.json")
# 统计未解决会话占比
unsolved_rate = len(df[df["solve_status"]=="unsolved"])/len(df)
print(f"未解决会话占比：{unsolved_rate:.2%}")

预期结果：输出各维度统计数据，可直接导入BI工具做可视化。

[5] 实际验证 #

测试用例：导出2026-08-20到2026-08-21的所有客服场景会话日志，统计未解决问题占比。输入：时间范围2026-08-20 00:00到2026-08-22 00:00，筛选scene=customer_service。预期输出：日志条数和控制台会话统计页的总条数误差≤0.1%，未解决占比计算结果和控制台自带的质检报表差值≤1%。
验证成功标志：HTTP请求均返回200，下载的日志解压后格式正确，每个会话包含session_id、user_input、agent_output、solve_status等必填字段。
验证失败排查：1. 下载的日志为空：检查筛选条件是否正确，对应时间范围是否有会话产生；2. 统计数据和控制台不符：检查导出的日志是否包含测试会话，可添加is_test=false的筛选条件过滤测试数据；3. 下载链接失效：重新调用GetExportTask接口获取新的临时链接。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0的免费额度是多少？
A1：新用户开通后可享受100万tokens的免费调用额度，有效期为开通后30天，日志存储和导出无免费额度。免费额度用完后自动按量计费，无需手动切换。

Q2：导出的对话日志会保存多久？
A2：导出任务生成的日志文件会在火山引擎服务器保存7天，超过7天会自动删除，建议导出后及时下载到本地或者自己的对象存储中留存。

Q3：我可以跳过配置权限步骤，直接用主账号导出日志吗？
A3：技术上可以实现，但我们不推荐这么做。主账号权限过大，一旦泄露会带来全资产的安全风险，建议遵循最小权限原则，单独创建日志导出专用的子账号。

Q4：HiAgent 3.0调用费是按输入tokens还是总tokens收费？
A4：按输入+输出的总tokens计费，和行业通用计费规则一致。如果是流式响应的场景，会按最终生成的完整输出tokens计算，不会分段重复计费。

Q5：导出日志时可以只导出用户的问题，不导出机器人的回答吗？
A5：支持，在创建导出任务的时候，在ExportFields参数中指定需要导出的字段列表即可，比如只传["session_id","user_id","user_input","create_time"]就只会导出对应字段。

[7] 相关阅读 #

1. 《HiAgent 3.0快速接入指南》[/blog/hiagent-3-0-quick-start]，HiAgent 3.0从开通到接入的全流程步骤，适合刚接触产品的开发者
2. 《HiAgent 3.0计费规则详解》[/doc/hiagent-3-0-billing]，官方最新计费规则说明，包含各类优惠活动介绍
3. 《HiAgent 3.0日志投递TOS方案》[/solution/hiagent-log-to-tos]，海量会话日志离线存储与分析的最佳实践
4. 《HiAgent 3.0会话质检方案》[/solution/hiagent-conversation-quality-check]，基于对话日志实现自动化会话质检的落地教程

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0官方定价文档，https://www.volcengine.com/product/hiagent/pricing，2026-08-20
[2] 火山引擎HiAgent 3.0日志导出API文档，https://www.volcengine.com/docs/6785/123456，2026-08-15
本文基于HiAgent 3.0 API v2.1版本编写

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

2026-08-25