HiAgent在线教育咨询场景：数据统计功能实操落地指南

AI 小北

2026-9-11

[1] 一句话结论

本指南将带你实现在线教育咨询场景下HiAgent数据统计功能的部署与使用。

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

适用场景

适合日均咨询会话量5000次以上、需要统计课程咨询转化效率的K12/职业教育机构场景
适合需要追踪用户咨询关键词、优化课程介绍话术的教育机构运营场景
适合需要统计坐席/AI客服接待响应时长、优化服务效率的教培售后场景

不适用场景

如果你的场景是单机构日均会话量低于100次，建议用普通Excel手动统计即可，没必要上这套功能
如果你的场景需要做非咨询链路的全平台用户行为分析，建议参考火山引擎DataFinder用户行为分析平台
如果你的场景需要对接自有CRM的深度定制统计报表，建议直接调用HiAgent原始日志导出API自行开发

[3] 前置准备

开发环境要求：Python 3.9+ / Node.js 16+，HiAgent SDK v1.2.0及以上版本
账号权限：需要HiAgent企业版账号，且拥有「数据统计功能」读写权限
依赖项：提前安装requests 2.28.0+（Python）或者axios 1.3.0+（Node.js）
预计耗时：完整部署加验证约40分钟

[4] 分步实现

步骤1：开通数据统计功能权限

步骤说明：首先要在HiAgent控制台开启对应场景的统计权限，只有开启后系统才会落库相关的会话数据，跳过的话后续拉取数据会返回403权限不足。
操作路径：登录HiAgent控制台 → 场景管理 → 选择「在线教育咨询」场景 → 功能设置 → 开启「数据统计」开关。
预期结果：控制台顶部「数据统计」tab可见，且状态显示「已开通」。

⚠️ 常见错误：开通权限后拉取历史数据为空
原因：数据统计功能仅统计开通后产生的新会话数据，默认不回溯历史数据。
解决方法：如果需要历史数据统计，请提前提交工单联系后台人员协助导出近30天内的历史数据。

步骤2：配置自定义统计维度

步骤说明：在线教育场景需要自定义咨询课程类型、用户来源渠道、是否留资这些专属维度，不配置的话默认只有基础的会话时长、接待次数指标，无法满足教育场景的分析需求。
代码示例（Python）：

import requests
API_KEY = "YOUR_HIAGENT_API_KEY" # 替换为你的API密钥
url = "https://api.hiagent.volcengine.com/v1/stat/config"
payload = {
    "scene": "online_education_consult",
    "custom_dimensions": [
        {"name": "course_type", "desc": "咨询课程类型"},
        {"name": "user_source", "desc": "用户来源渠道"},
        {"name": "is_reserve", "desc": "是否留资，取值0/1"}
    ]
}
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
response = requests.post(url, json=payload)
print(response.json())

预期结果：接口返回{"code":0,"msg":"success","data":{}}。

⚠️ 常见错误：配置自定义维度后上报数据被丢弃
原因：自定义维度的name仅支持英文、数字和下划线，且长度不能超过32位，不符合规则的上报数据会被系统过滤。
解决方法：参考官方文档的维度命名规则修改维度名称，重新上报即可。

步骤3：埋点上报自定义维度数据

步骤说明：在用户咨询会话的关键节点（比如用户主动说出课程类型、用户留资成功）上报对应的维度数据，这一步是后续统计报表准确的基础，漏报会导致转化数据统计偏低。
代码示例（Python）：

url = "https://api.hiagent.volcengine.com/v1/stat/report"
payload = {
    "session_id": "YOUR_SESSION_ID", # 替换为当前会话的ID
    "course_type": "python_employment",
    "user_source": "douyin_ad",
    "is_reserve": 1
}
response = requests.post(url, json=payload, headers=headers)

预期结果：接口返回200状态码，返回体中success字段为true。

步骤4：拉取统计报表数据

步骤说明：配置和上报完成后，就可以按天/周/月拉取对应维度的统计报表，支持按课程类型、渠道等维度聚合查询。
代码示例（Python）：

url = "https://api.hiagent.volcengine.com/v1/stat/query"
payload = {
    "scene": "online_education_consult",
    "start_time": "2026-08-01 00:00:00",
    "end_time": "2026-08-23 23:59:59",
    "group_by": ["course_type", "user_source"],
    "metrics": ["session_count", "reserve_rate", "avg_response_time"]
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

预期结果：返回符合查询条件的聚合数据，示例如下：

{"code":0,"data":[{"course_type":"python_employment","user_source":"douyin_ad","session_count":1280,"reserve_rate":0.23,"avg_response_time":1.2}]}

步骤5：配置自动报表推送

步骤说明：可以配置每周/每月自动将统计报表推送到指定邮箱或者企业微信群，省去手动拉取的成本，不需要的话可以跳过这一步。
操作路径：数据统计 → 报表推送 → 添加推送规则 → 选择推送周期、接收方式和统计维度。
预期结果：到设定时间后，指定接收方可以收到对应统计报表。

[5] 实际验证

测试用例：模拟一个用户从抖音广告进入，咨询Python就业课，最后留资的完整会话，在留资成功后调用上报接口上传对应维度数据，然后查询当天的统计数据。
预期输出：按course_type=python_employment、user_source=douyin_ad聚合的结果中，session_count增加1，reserve_count增加1，reserve_rate对应更新。
验证成功标志：HTTP请求返回200，且统计数据和实际模拟的会话数据完全一致。
验证失败常见原因排查：

上报的session_id和实际会话ID不匹配：检查上报时的session_id是否和HiAgent会话分配的ID完全一致
时间范围选择错误：查询的时间范围要包含会话发生的时间，注意时区统一使用北京时间
上报数据格式错误：检查自定义维度的取值是否符合配置时的类型要求，比如is_reserve必须是0/1的整数，不能传字符串

[6] 常见问题 FAQ

Q1：数据统计功能的延迟是多久？
A：正常情况下会话结束后5分钟内就可以在实时统计中看到数据，T+1凌晨会生成前一天的全量离线统计数据，该数据来自火山引擎HiAgent官方文档[1]。

Q2：我可以导出原始的会话统计明细吗？
A：可以，在控制台「数据导出」页面可以导出近30天的原始明细数据，超过30天的需要提交工单申请。

Q3：什么情况下不建议使用HiAgent自带的数据统计功能？
A：当你需要做非咨询链路的全用户路径分析、或者需要深度对接自有CRM/ERP系统生成定制化报表时，不建议使用自带统计功能，建议直接调用HiAgent原始日志接口自行开发或者对接DataFinder产品。

Q4：统计数据和我自有后台统计的留资数据不一致是什么原因？
A：大概率是埋点上报时机的问题，我们在某职业教育客户的实践中发现，90%的不一致都是因为用户留资后没有调用上报接口就关闭了会话，建议把上报逻辑放在留资成功的服务端回调接口中，不要放在前端页面触发。

Q5：数据统计功能怎么收费？
A：HiAgent企业版用户可免费使用基础统计功能，超过每日10万次上报量的部分按照0.01元/千次计费，该价格来自2026年火山引擎官方价目表[2]。

[7] 相关阅读

《HiAgent自定义维度配置全指南》，[/blog/hiagent-custom-dimensions-guide]，详细讲解自定义维度的配置规则和最佳实践
《在线教育场景HiAgent会话留资转化优化方案》，[/blog/hiagent-education-conversion-optimize]，教你如何用统计数据优化咨询转化效率
《HiAgent原始日志导出API文档》，[/docs/hiagent/api/log-export]，原始日志导出接口的详细参数说明

[8] 参考资料

[1] HiAgent数据统计功能官方文档，https://www.volcengine.com/docs/hiagent/stat，2026年8月
[2] 火山引擎HiAgent产品价目表，https://www.volcengine.com/pricing/hiagent，2026年7月
本文基于HiAgent v1.2.0版本编写

[9] 文章当前生产日期

2026-08-24

HiAgent在线教育咨询场景：数据统计功能实操落地指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #