HiAgent3.0数据统计报表：包年包月用户操作全指南

[1] 一句话结论 #

本指南将介绍包年包月套餐下HiAgent3.0数据统计报表的查看与分析实操方法。

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

适用场景

1. 购买了HiAgent3.0包年包月套餐，需要日常监控对话成功率、响应延迟等核心指标的运营场景
2. 需要按周/月维度统计用户会话量、调用量做业务复盘的产品团队
3. 需要排查异常时段调用故障、定位性能问题的开发运维场景

不适用场景

1. 按流量计费的HiAgent3.0用户，这类用户建议参考[/doc/hiagent3.0/flow-bill-report]的流量计费专属报表操作指南
2. 需要自定义多维度交叉分析、导出超过100万行明细数据的场景，建议使用火山引擎DataV+ByteHouse组合方案
3. 需要实时（延迟低于1分钟）监控调用指标的场景，建议搭配云监控告警服务实现

[3] 前置准备 #

• 已开通火山引擎账号，且当前账号拥有HiAgent3.0的「数据查看」权限（权限配置可联系主账号管理员）
• 包年包月套餐已生效，套餐有效期内产生过至少100条以上会话数据（数据量过小统计结果无参考价值）
• 浏览器版本要求：Chrome 100+、Edge 98+，不支持IE内核浏览器
• 预计操作耗时：15分钟

[4] 分步实现 #

步骤1：进入HiAgent3.0控制台报表入口

步骤说明：登录火山引擎控制台，在顶部搜索栏直接搜索「HiAgent数据统计」快速进入对应模块，也可以在人工智能分类下找到HiAgent3.0产品页，从左侧菜单栏「数据统计」入口进入。跳过这一步直接从旧版收藏链接访问可能会跳转到已下线的v2.0报表页面。
预期结果：进入报表页后默认展示近7天的核心指标概览，页面无报错信息。

⚠️ 常见错误：点击「数据统计」后提示「无权限访问」
原因：当前账号未被配置HiAgent的数据查看权限，或者包年包月套餐已到期
解决方法：1.联系主账号管理员在访问控制(IAM)中给当前账号添加「HiAgentFullAccess」或者「HiAgentDataReadOnlyAccess」权限；2.检查套餐有效期，若已到期需续费后再查看。

步骤2：配置报表筛选条件

步骤说明：根据分析需求配置时间范围、应用ID、会话渠道三个核心筛选条件，时间范围支持近1小时、近7天、近30天、自定义区间（最长支持查询近180天的数据），应用ID可以单选或多选名下的HiAgent应用，会话渠道支持筛选网页、小程序、API调用等不同来源的会话。
预期结果：筛选条件配置完成后页面自动刷新，展示对应维度的指标数据。

⚠️ 常见错误：自定义选择超过30天的时间范围后，明细数据导出按钮置灰不可点击
原因：根据HiAgent3.0官方限制，单次导出明细数据的时间跨度不能超过30天，避免导出数据量过大导致服务超时
解决方法：拆分时间范围分多次导出，每次导出跨度不超过30天即可。

步骤3：查看核心指标概览

步骤说明：概览区会展示会话总量、调用成功率、平均响应时长、用户满意度四个核心指标，每个指标都支持和上一周期对比。我们在多个客户的实践中发现，包年包月套餐下调用成功率的基准线应不低于99.5%，低于这个值就要排查是否有接口调用异常（数据来源：火山引擎HiAgent3.0官方运营白皮书2026版）。
预期结果：可以看到每个指标的数值、环比涨跌幅，以及对应的趋势曲线图，支持点击单个指标查看单独的趋势变化。

步骤4：分析会话明细报表

步骤说明：下拉页面到「会话明细」模块，可以看到每条会话的ID、用户ID、调用时间、响应时长、是否命中知识库、满意度评分等字段，支持按单个字段排序筛选，也可以点击单条会话ID查看完整的对话上下文。这一步主要用于定位异常会话的具体原因，比如响应超时的会话是否是因为请求了大模型长文本生成能力。
预期结果：支持按响应时长倒序排序，快速定位到超时的异常会话，点击会话ID可弹出完整对话上下文弹窗。

步骤5：导出报表数据

步骤说明：点击页面右上角的「导出」按钮，支持导出CSV或Excel格式的报表数据，导出任务会在后台运行，完成后可以在右上角「消息中心」下载导出文件。如果需要定期导出，可以开启自动导出到对象存储TOS的功能，无需手动操作。
预期结果：导出任务提交后1-5分钟内收到完成通知，文件下载后可直接用Excel打开分析，字段无缺失。

[5] 实际验证 #

我们可以通过以下测试用例验证操作是否正确：
测试用例：输入筛选条件为「近7天、全部应用、全部渠道」，点击查询按钮。
预期输出：1.页面返回HTTP 200状态码，核心指标区域无异常报错；2.会话总量数值和你业务侧统计的近7天调用量误差不超过0.1%（数据来源：火山引擎HiAgent3.0数据一致性SLA承诺）；3.导出按钮可点击，提交导出任务后3分钟内可收到下载通知。
验证成功标志：核心指标趋势曲线无断崖式下跌或上涨，明细数据字段完整无缺失，导出文件可正常打开。
验证失败常见原因：1.报表显示数据为空：检查筛选的时间范围内是否有实际调用，或者应用ID选择错误；2.导出任务失败：检查导出的时间跨度是否超过30天，或者单次导出数据量超过10万行；3.指标数据和业务侧统计差异过大：检查是否筛选了相同的会话渠道，是否排除了测试环境的调用数据。

[6] 常见问题 FAQ #

Q1：为什么我查看的报表数据和前一天看到的同一时段数据有差异？
A：HiAgent3.0报表数据有5分钟的延迟，同时每日凌晨会对前一天的数据进行二次对账修正，差异在0.1%以内属于正常范围，若超过这个范围可提交工单联系技术支持排查。

Q2：包年包月套餐下报表最多可以保存多久的历史数据？
A：官方默认保存180天的历史报表数据，超过180天的数据会自动归档，若需要长期保存可以开启自动导出到对象存储TOS的功能，配置方法参考官方文档。

Q3：什么情况下不建议直接使用HiAgent自带的报表做核心业务核算？
A：如果你的业务需要多维度（比如按用户标签、地域）交叉分析，或者需要和其他业务系统数据打通核算，建议将报表数据导出后导入自己的数仓进行二次分析，自带报表仅适合基础运营监控使用。

Q4：我可以给第三方合作伙伴开通报表查看权限吗？
A：可以，通过IAM系统创建子账号，仅给子账号分配HiAgent数据只读权限，即可共享报表数据，注意不要给第三方开通编辑或操作权限，避免数据泄露。

Q5：报表中的「调用成功率」是怎么计算的？
A：调用成功率=（成功响应的会话量/总会话量）*100%，其中成功响应指的是接口返回HTTP 200且无业务错误码，因用户输入非法导致的业务错误不算入失败。

[7] 相关阅读 #

1. 《HiAgent3.0包年包月套餐计费说明》[/doc/hiagent3.0/billing/prepaid]：详细介绍包年包月套餐的权益、计费规则及到期处理策略
2. 《HiAgent3.0核心指标定义手册》[/doc/hiagent3.0/operation/metrics]：完整说明报表中所有指标的计算逻辑、统计口径
3. 《HiAgent3.0异常告警配置指南》[/doc/hiagent3.0/operation/alert]：教你如何基于报表指标配置异常告警，及时发现业务故障
4. 《HiAgent3.0数据导出到TOS配置教程》[/doc/hiagent3.0/operation/export-tos]：实现报表数据自动归档到对象存储，长期保存

[8] 参考资料 #

[1] 火山引擎HiAgent3.0官方数据统计文档，https://www.volcengine.com/docs/6458/1298762，2026-08-20
[2] 火山引擎HiAgent3.0包年包月套餐权益说明，https://www.volcengine.com/docs/6458/1298751，2026-08-15
本文基于HiAgent3.0 2026年8月v3.2.0版本编写

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

2026-08-25