HiAgent 3.0会话质检：4步实现检测结果批量导出
[1] 一句话结论
本指南将教你快速完成HiAgent 3.0会话质检检测结果的批量导出操作。
[2] 适用场景与不适用场景
适用场景
- 单次导出会话质检结果数量在1000条以内、需要导出命中规则明细的客服团队月度质检复盘场景；
- 需要同时导出会话文本+质检评分+规则命中记录用于外部BI分析的运营场景；
- 自定义选择导出字段生成专项质检报表的合规审计场景。
不适用场景
- 单次导出量超过1000条的批量离线分析场景，建议参考【HiAgent OpenAPI 批量拉取质检结果方案】；
- 需要实时同步质检结果到自有系统的场景，建议使用【HiAgent 质检结果回调接口】；
- 需要导出带音频的通话质检结果的场景，建议参考【HiAgent 通话质检专属导出方案】。
[3] 前置准备
- 账号权限：拥有HiAgent 3.0质检模块的「质检结果导出」权限（需管理员在角色管理中配置）
- 环境要求：Chrome 100+/Edge 100+浏览器，不兼容IE系列浏览器
- 预计耗时：单任务导出操作1分钟以内，1000条数据下载耗时≤30秒（来源：火山引擎HiAgent官方性能测试数据2026年6月）
- 前置条件：已完成至少1个质检任务的执行，存在可导出的质检结果
[4] 分步实现
步骤1：进入对应质检任务的结果页面
步骤说明：登录HiAgent 3.0控制台，进入「会话质检」模块，点击你需要导出结果的对应质检任务名称，进入「任务结果」页，系统会默认按会话粒度展示所有质检结果、评分、命中规则等信息。如果跳过这一步直接在质检任务列表页操作，无法自定义选择导出字段。
预期结果：页面加载完成后可以看到对应任务下的所有质检会话列表，顶部显示任务总执行数、合格率等统计数据。
⚠️ 常见错误：进入任务结果页后看不到批量导出按钮
原因：当前登录账号没有「质检结果导出」权限，或者当前任务还在执行中未完成
解决方法：先联系管理员确认账号权限，同时确认任务状态为「已完成」，运行中的任务暂不支持导出。
步骤2：选择需要导出的质检结果
步骤说明：你可以勾选列表中单个或多个会话，也可以点击列表顶部的「全选」按钮选中当前页所有结果，2026年8月版本更新后支持跨页全选最多1000条结果。选择时可以通过上方的评分区间、命中规则筛选条件先过滤出需要导出的范围，避免导出不需要的数据。
预期结果：列表顶部显示「已选中X条会话」的提示信息。
步骤3：配置导出字段
步骤说明：点击页面右上角的「批量导出」按钮，在弹出的导出配置弹窗中，勾选你需要导出的字段，可选字段包括：会话基础信息、质检评分、命中规则明细、完整对话文本、人工复核结果等。如果需要按规则维度导出，可勾选「按规则明细展开」选项，导出后每条命中规则对应一行数据。
预期结果：弹窗中勾选的字段旁显示选中状态，底部显示预计导出文件大小。
⚠️ 常见错误：导出后的Excel文件中缺少命中规则的具体内容
原因：导出配置时未勾选「命中规则明细」字段，或者未开启「按规则明细展开」选项
解决方法：重新打开导出配置弹窗，确认勾选「命中规则明细」，如需每条规则单独成行则同时勾选「按规则明细展开」后重新导出。
步骤4：下载导出文件
步骤说明：配置完成后点击「确认导出」按钮，系统会在后台生成导出文件，生成完成后浏览器会自动触发下载，导出格式默认是xlsx格式。如果导出数据量较大，系统会提示你稍后在「导出任务中心」查看下载链接，链接有效期为24小时。
预期结果：浏览器下载完成xlsx格式的文件，打开后可以看到你选择的所有字段内容，数据条数和你选中的会话数量一致。
[5] 实际验证
测试用例：选择一个已完成的、包含10条会话的质检任务，全选所有结果，导出字段勾选「会话ID、质检评分、命中规则明细、对话文本」。
预期输出：下载的xlsx文件包含10行数据（如果开启按规则展开则按命中规则条数递增），每行包含会话ID、对应评分、命中的规则名称/分值、完整的会话文本内容，HTTP状态码200，文件无损坏。
验证成功标志：打开文件后数据完整无缺失，会话ID和控制台展示的会话ID一一对应，评分数据一致。
常见排查方法：1. 文件下载失败：检查浏览器下载权限，或到导出任务中心重新下载；2. 文件内容为空：确认你选中的会话确实有质检结果，没有被过滤条件排除；3. 字段缺失：回到导出配置步骤确认所有需要的字段都已勾选。
[6] 常见问题 FAQ
Q1：单次最多可以导出多少条质检结果？
A1：目前控制台批量导出单次最大支持1000条会话，如果你需要导出超过1000条的结果，建议使用HiAgent OpenAPI的批量拉取接口，或者分多次筛选导出。
Q2：导出的文件有效期是多久？
A2：系统生成的导出文件下载链接有效期为24小时，超过有效期后需要重新发起导出请求，建议导出后及时保存到本地。
Q3：什么情况下不建议使用控制台批量导出功能？
A3：如果你的场景是需要实时同步质检结果到自有CRM或BI系统，不建议使用控制台导出，建议使用质检结果回调接口，数据延迟可低至2秒（来源：火山引擎HiAgent官方接口性能文档）。
Q4：我可以导出其他团队的质检任务结果吗？
A4：不可以，默认你只能导出你所在团队权限范围内的质检任务结果，如果需要跨团队导出，需要联系对应团队的管理员给你的账号开通对应任务的查看权限。
Q5：导出的文件可以自定义格式吗？
A5：目前控制台导出默认是xlsx格式，如果需要csv或json格式的结果，建议使用OpenAPI接口拉取后自行转换格式。
[7] 相关阅读
- 《HiAgent 3.0 OpenAPI 质检结果拉取接口文档》[/docs/hiagent/3.0/api/quality-export]
简介：教你通过API方式批量拉取超过1000条的质检结果，支持自定义返回格式。 - 《HiAgent 质检结果回调接口配置指南》[/docs/hiagent/3.0/guide/callback-config]
简介：讲解如何配置质检结果实时回调，实现数据自动同步到自有系统。 - 《HiAgent 3.0 质检模块权限配置最佳实践》[/blog/hiagent-quality-permission-best-practice]
简介：分享不同角色的质检权限配置方法，避免权限泄露风险。 - 《HiAgent 会话质检报表搭建指南》[/blog/hiagent-quality-report-build]
简介：教你用导出的质检结果搭建符合业务需求的自定义质检报表。
[8] 参考资料
[1] HiAgent 3.0 会话质检功能官方文档，https://www.volcengine.com/docs/hiagent/3.0/quality/export，2026年8月[2] 火山引擎HiAgent 2026年8月产品更新公告，http://m.toutiao.com/group/7586893976351801862/?upstream_biz=VolcEngine，2026年8月
本文基于HiAgent 3.0 2026年8月更新版本编写
[9] 文章当前生产日期
2026-08-24
