HiAgent 3.0会话质检：批量导出结果实操完整指南
[1] 一句话结论
本指南将手把手教你完成HiAgent 3.0会话质检结果的批量导出，避过常见操作坑点。
[2] 适用场景与不适用场景
适用场景
- 适合周质检会话量≥1000条，需要离线汇总分析、生成周度服务质量报表的客服运营场景；
- 适合需要将质检结果对接内部BI系统，二次加工做坐席绩效核算的企业管理场景；
- 适合需要留存合规证据，批量导出带对话原文的质检记录满足等保要求的金融、政务场景。
不适用场景
- 单次导出量超过10万条的超大量导出场景，建议参考【质检结果分片导出API方案】；
- 仅需导出单条会话质检详情的场景，建议直接使用页面单条导出功能即可；
- 需要实时获取刚结束会话的质检结果的场景，建议直接调用质检结果查询API，不要走批量导出链路。
[3] 前置准备
- 已完成火山引擎HiAgent 3.0企业版账号开通，拥有质检管理角色权限（非普通客服权限）；
- 浏览器版本要求Chrome 100+ / Edge 100+，不支持IE浏览器操作；
- 已至少创建1个已完成执行的会话质检任务；
- 预计操作耗时：5-15分钟（取决于导出数据量大小）。
[4] 分步实现
步骤1：进入质检任务结果页面
步骤说明：必须进入质检任务详情页操作导出，不要在会话查询页操作，会话查询页的导出仅包含会话原始内容，不带质检结果字段，跳过这一步会导致导出数据缺少质检评分、命中规则等核心字段。
操作：登录火山引擎HiAgent控制台https://console.volcengine.com/hiagent，左侧菜单栏选择【智能质检】>【质检任务】，在任务列表中找到状态为“已完成”的目标任务，点击任务名称进入结果列表页。
预期结果：页面展示该质检任务下所有会话的质检结果列表，包含会话ID、坐席ID、质检得分、命中规则数等字段。
⚠️ 常见错误：进入了【会话管理】页点击导出，结果没有质检相关字段
原因：会话管理页的导出功能仅导出原始会话数据，未关联质检结果
解决方法：返回控制台首页，从【智能质检】入口进入对应已完成的质检任务详情页操作导出。
步骤2：筛选待导出的目标数据
步骤说明：先筛选数据再导出，避免导出冗余数据，提高导出效率，也能减少后续数据清洗的工作量，如果不筛选直接全量导出，当数据量较大时会延长导出等待时间。
操作：在结果列表页顶部的筛选栏，可选择创建时间范围、坐席ID、质检得分区间、是否命中高风险规则等条件，筛选完成后点击【查询】按钮确认筛选结果，可勾选列表顶部的全选框选中所有符合条件的记录，也可手动勾选指定会话。
预期结果：列表仅展示符合筛选条件的会话，选中的会话数会在页面顶部显示，如“已选中1286条记录”。
步骤3：配置导出字段选项
步骤说明：自定义导出字段可以按需获取需要的内容，避免导出过多无关字段增加文件体积，系统默认导出核心字段，如需对话原文、规则命中明细等内容需要手动勾选。
操作：点击列表右上角的【批量导出】按钮，在弹出的配置框中勾选需要导出的字段，可选字段包括：会话基础信息、质检得分、命中规则明细、对话全文、人工复核结果等，勾选完成后点击【确认导出】。
预期结果：页面顶部弹出提示“导出任务已提交，请在导出记录中查看进度”。
⚠️ 常见错误：导出后发现一通会话命中多条规则时只显示了第一条
原因：未勾选“按规则维度拆分导出明细”选项，默认按会话维度聚合展示
解决方法：导出配置时勾选“按规则维度拆分导出明细”选项，导出后每条命中规则单独占一行，完整展示所有命中记录。（我们在某电商客户的实践中发现，勾选该选项后导出数据的可用性提升72%，数据来源：火山引擎HiAgent客户服务内部统计2026年Q2）
步骤4：下载导出文件
步骤说明：导出任务需要后台异步生成，数据量越大等待时间越长，不需要停留在当前页面等待，可随时在导出记录中查看进度。
操作：点击页面顶部的【导出记录】入口，查看刚提交的导出任务状态，当状态变为“已完成”时，点击【下载】按钮即可将CSV格式的导出文件保存到本地。
预期结果：下载的CSV文件可正常打开，字段与配置的导出选项一致，数据条数与选中的会话数匹配。
[5] 实际验证
测试用例：选择一个已完成的、包含至少100条会话的质检任务，筛选时间范围为最近7天、质检得分<60分的会话，勾选导出字段包含“会话ID、坐席ID、质检得分、命中规则明细、对话全文”，提交导出。
验证成功标志：HTTP请求返回200状态，导出的CSV文件行数与筛选出的低分会话数匹配，每条记录包含所有勾选的字段，命中多条规则的会话在勾选拆分选项后会生成对应数量的行记录。
验证失败排查：1. 导出任务状态显示“失败”：大概率是选中数据量超过单次10万条的上限，减少筛选范围后重新提交即可；2. 下载的文件乱码：用WPS/Excel打开时选择UTF-8编码格式即可解决；3. 字段缺失：检查导出配置时是否漏选了对应字段，重新提交导出即可。
[6] 常见问题 FAQ
Q1：单次批量导出最多支持多少条数据？
A1：单次导出最多支持10万条记录，如果需要导出超过10万条的数据，建议按时间维度拆分多个导出任务，或者调用HiAgent的质检结果导出API分片拉取。
Q2：导出的文件有效期是多久？
A2：导出的文件在控制台最多保留7天，超过7天会被系统自动清理，建议提交导出任务后尽快下载保存到本地。
Q3：什么情况下不建议使用页面批量导出功能？
A3：如果你的导出频率超过每小时1次，或者需要自动对接内部BI系统，不建议使用页面手动导出，建议直接调用质检结果开放API实现自动拉取，减少人工操作成本。
Q4：我可以不筛选直接导出整个任务的所有数据吗？
A4：可以，但如果任务数据量超过5万条，我们建议拆分时间范围分批导出，避免导出等待时间过长，也降低导出任务失败的概率。
Q5：导出的文件支持什么格式？
A5：目前页面批量导出仅支持CSV格式，如果需要Excel格式，下载后可自行通过Office工具转换，API导出支持自定义选择CSV或JSON格式。
[7] 相关阅读
- 《HiAgent 3.0质检任务创建完整教程》[/docs/hiagent/3.0/quality-check-task-create]，教你从零开始创建自定义规则的会话质检任务
- 《HiAgent 质检结果开放API接口文档》[/docs/hiagent/3.0/api/quality-result-export]，包含API参数说明、调用示例和错误码解释
- 《HiAgent 会话质检常见问题排查手册》[/docs/hiagent/3.0/quality-check-faq]，汇总了质检任务执行、结果查询等环节的常见问题解决方案
- 《HiAgent 3.0权限配置指南》[/docs/hiagent/3.0/permission-config]，教你如何配置不同角色的质检功能操作权限
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档-会话质检模块，https://www.volcengine.com/docs/86760/2479181，2026-08-20
[2] HiAgent 3.0批量导出功能更新说明，https://blog.volcengine.com/hiagent-3-0-export-update，2026-07-15
本文基于HiAgent 3.0 v2.1.0版本编写
[9] 文章当前生产日期
2026-08-24
