HiAgent数据统计功能使用教程：附免费额度申领规则

[1] 一句话结论 #

本指南将带你快速掌握HiAgent数据统计功能的使用方法及免费额度规则

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

适用场景

1. 企业智能客服场景：日对话量1000次以上，需要统计用户满意度、问题解决率的运维团队
2. 智能体迭代场景：每月有至少2次模型精调需求，需要回流对话数据做训练数据集的算法团队
3. 成本管控场景：需要实时监控Tokens消耗，设置用量预警的中小团队技术负责人

不适用场景

1. 个人玩具类智能体场景：日均调用量不足10次，只需要基础对话功能，建议直接使用豆包个人版即可
2. 离线数据清洗场景：需要处理百万级历史非结构化文本数据，建议使用火山引擎大数据计算服务MaxCompute
3. 无权限访问后台的前端开发场景：仅负责前端交互开发，不需要查看全量运营数据，无需使用本功能

[3] 前置准备 #

• 开发环境：无特殊编码要求，仅需要Chrome 110+ / Edge 110+版本浏览器访问后台
• 账号权限：已完成火山引擎企业实名认证，拥有HiAgent后台「数据洞察」模块的读写权限
• 依赖项：无额外SDK依赖，无需安装本地软件
• 预计耗时：15分钟即可完成全流程配置与试用

[4] 分步实现 #

步骤1：申领免费试用额度

步骤说明：首先确认你的账号符合免费额度申领条件，提前领取额度可以避免后续统计功能使用产生不必要的计费，跳过这一步可能会导致额度耗尽后功能自动停用。
操作：登录火山引擎HiAgent控制台，进入「权益中心」板块，点击「免费额度申领」按钮，提交企业信息即可完成申领。
预期结果：页面显示“额度申领成功”，可查看剩余Tokens额度：基础款50万，参与协作计划企业可额外获得500万（数据来源：火山引擎HiAgent官方2026年权益规则）

⚠️ 常见错误：点击申领后提示“权限不足”
原因：当前账号仅为子账号，没有企业实名认证的主账号授权
解决方法：联系主账号管理员在访问控制RAM中为你的账号添加「HiAgentFullAccess」权限后重新申领

步骤2：进入数据统计模块

步骤说明：数据统计功能统一放在「数据洞察」板块，这里汇总了所有智能体的运行、消耗、效果数据，不需要逐个进入智能体实例查看，跳过这一步你可能找不到正确的统计入口。
操作：登录HiAgent管理后台，在左侧菜单栏找到「数据洞察」选项，点击进入即可看到默认的核心指标看板。
预期结果：页面展示近7天的总对话量、问题解决率、用户满意度、Tokens消耗4个核心指标的折线图

步骤3：自定义数据报表配置

步骤说明：默认看板仅展示通用指标，你可以根据自己的业务需求自定义统计维度，避免后续每次查看都要重新筛选数据，节省运维时间。
操作：点击看板右上角「自定义报表」按钮，勾选你需要统计的指标（支持对话量、工具调用成功率、资源消耗、用户反馈标签等20+维度），选择统计时间范围，点击「保存为常用报表」即可。
代码示例（API导出报表）：

import requests
# 替换为你的火山引擎API密钥
API_KEY = "YOUR_VOLC_ENGINE_API_KEY"
SECRET_KEY = "YOUR_VOLC_ENGINE_SECRET_KEY"
url = "https://hiagent.volcengineapi.com/?Action=ExportDataReport&Version=2026-01-01"
headers = {"Content-Type": "application/json"}
params = {
    "report_id": "你的自定义报表ID",
    "start_time": "2026-08-01 00:00:00",
    "end_time": "2026-08-23 23:59:59"
}
response = requests.post(url, json=params, headers=headers, auth=(API_KEY, SECRET_KEY))
print(response.json())

预期结果：返回HTTP 200状态码，响应体中包含报表下载链接，有效期24小时

⚠️ 常见错误：调用导出API时返回403 Forbidden
原因：当前API密钥没有数据导出的权限，或者IP不在白名单范围内
解决方法：1. 前往RAM访问控制，为密钥添加「HiAgentDataExportAccess」权限；2. 确认请求IP在HiAgent控制台设置的IP白名单内

步骤4：配置监控预警规则

步骤说明：设置预警规则可以在指标异常（比如消耗超额度、响应超时）时第一时间收到通知，避免影响业务正常运行，跳过这一步可能会导致额度耗尽后智能体突然停用没有预警。
操作：进入「数据洞察」-「预警配置」页面，点击「新增预警规则」，选择预警指标（比如Tokens剩余量低于10%、问题解决率低于80%），设置通知方式（短信、飞书、邮件），保存即可。
预期结果：页面显示预警规则已启用，测试触发时可在1分钟内收到通知

步骤5：数据回流精调

步骤说明：导出的统计数据可以直接用于模型精调，形成数据闭环，提升智能体的回答准确率，跳过这一步无法实现智能体的持续迭代优化。
操作：在自定义报表中选择「对话数据导出」，勾选「标注为待训练数据」选项，导出的数据集会自动符合豆包大模型精调的格式要求，直接上传到火山方舟精调平台即可使用。
预期结果：导出的数据集为JSONL格式，字段包含prompt、response、feedback，无需额外清洗即可导入精调平台

[5] 实际验证 #

完成上述步骤后，你可以用以下测试用例验证配置是否正确：
测试用例：配置一个“Tokens剩余量低于20%”的预警规则，然后手动消耗一部分额度触发阈值
输入：1. 自定义一个统计近1天Tokens消耗的报表；2. 调用你的智能体10次产生对话数据；3. 手动将预警阈值调整为当前剩余额度以上触发预警
预期输出：1. 自定义报表可以正确显示近1天的10次调用消耗的Tokens数量；2. 触发预警后1分钟内收到你配置的通知渠道的告警信息；3. 导出的对话数据包含这10次调用的完整上下文
验证成功标志：HTTP请求返回200状态码，报表数据与实际调用量一致，预警通知正常接收
常见排查方向：1. 报表数据不更新：检查是否选择了正确的时间范围，数据延迟最长不超过5分钟；2. 收不到预警：检查通知渠道的配置是否正确，是否被拦截；3. 导出数据缺失：检查是否勾选了所有需要导出的字段

[6] 常见问题 FAQ #

Q1：免费额度的有效期是多久？
A：基础50万Tokens额度的有效期是申领成功后3个月，额外的500万协作计划额度有效期是12个月，过期未使用的额度会自动清零，不结转。

Q2：数据统计的延迟是多久？
A：正常情况下对话结束后1分钟内即可在统计看板看到数据，峰值时段延迟最长不超过5分钟，不支持实时秒级统计。

Q3：我可以跳过自定义报表步骤，直接用默认看板吗？
A：可以，但默认看板仅支持近7天的4个核心指标统计，无法满足精细化运营需求，如果你的场景只需要看基础运行数据可以跳过，否则建议配置自定义报表。

Q4：什么情况下不建议使用HiAgent数据统计功能？
A：如果你需要统计的是离线的历史非结构化文本数据，或者需要自定义复杂的机器学习分析模型，不建议使用本功能，建议使用火山引擎MaxCompute做数据处理。

Q5：多个子账号可以共享免费额度吗？
A：可以，免费额度是归属于主账号的，同一个主账号下的所有子账号的调用量都会消耗同一个额度池，你可以在数据统计模块按子账号维度拆分消耗数据。

Q6：导出的对话数据可以保存多久？
A：平台默认保存最近6个月的对话数据，超过6个月的数据会自动删除，你可以导出后本地保存长期使用。

[7] 相关阅读 #

• 《HiAgent智能体快速接入指南》[/doc/hiagent/quick-start]：10分钟教你快速搭建第一个企业级智能体
• 《火山方舟大模型精调操作手册》[/doc/ark/fine-tune]：如何使用HiAgent导出的数据集精调专属大模型
• 《HiAgent计费规则详解》[/doc/hiagent/pricing]：免费额度耗尽后的按量计费规则说明
• 《RAM访问控制权限配置教程》[/doc/iam/permission]：如何为子账号配置HiAgent模块的访问权限

[8] 参考资料 #

[1] 火山引擎HiAgent官方文档，https://www.byteoc.com/doc/hiagent，2026年8月
[2] HiAgent 2026年免费权益规则说明，https://www.huosanyun.com/13240/，2026年8月
本文基于HiAgent平台v2.4版本编写

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

2026-08-24