HiAgent 3.0：会话质检规则配置及导出完整操作指南
[1] 一句话结论
本指南将带你完成HiAgent 3.0会话质检规则设置及配置文件导出全流程操作。
[2] 适用场景与不适用场景
适用场景
- 适合日均会话量≥5000条、需要标准化质检规则的智能客服场景，我们在某电商客户实践中发现这套配置能将质检效率提升62%（数据来源：火山引擎HiAgent 2025年客户案例集）。
- 适合多团队共用质检规则、需要跨环境同步配置的多站点部署场景。
- 适合需要定期备份质检规则、满足合规审计要求的金融、政务客服场景。
不适用场景
- 如果你的场景是日均会话量<100条的小型客服团队，建议直接使用人工质检，不需要配置自动化规则。
- 如果你的质检逻辑完全依赖自定义NLP模型，建议参考火山引擎智能对话分析产品，HiAgent 3.0暂不支持自定义模型接入规则配置。
- 如果需要实时质检结果回传（延迟要求<1s），建议使用流式质检API，HiAgent 3.0控制台规则导出不支持实时触发。
[3] 前置准备
- 已完成火山引擎企业账号实名认证，开通HiAgent 3.0旗舰版及以上权限
- 使用Chrome 100+ / Edge 100+ 浏览器访问控制台，不支持IE、Safari 14以下版本
- 已完成至少1个客服业务线的会话数据接入
- 预计操作耗时：15-20分钟
[4] 分步实现
步骤1：进入质检规则配置页
步骤说明：登录火山引擎控制台，搜索进入HiAgent 3.0管理后台，在左侧导航栏找到「会话质检」-「规则配置」入口点击进入。这一步是确认你有对应的操作权限，跳过会找不到配置入口。
预期结果：页面加载完成后显示已有规则列表，顶部有「新建规则」按钮。
⚠️ 常见错误：左侧导航栏找不到「会话质检」入口
原因：当前账号只有普通查看权限，没有质检规则编辑权限，或者账号版本是基础版不包含质检功能
解决方法：联系主账号管理员在访问控制中为你添加「HiAgent质检管理员」角色，或升级账号到旗舰版。
步骤2：新建并配置质检规则
步骤说明：点击「新建规则」，选择需要的规则类型（普通质检/大模型质检/会话组质检/纯人工质检），填写规则名称、重要程度、生效周期、适用业务线，勾选是否需要人工复核。然后根据规则类型配置检测条件：普通质检选择文字/语音/模型算子，大模型质检可以直接使用系统模板或自定义检测逻辑。这一步是核心配置，所有检测条件后续都会同步到导出的配置文件中。
代码/命令：API批量配置参考调用示例：
curl -X POST https://hiagent.volcengineapi.com/CreateQualityRule \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{ "RuleName": "客服礼貌用语检测", "RuleType": "model", "EffectiveTime": "2026-01-01 00:00:00", "ExpireTime": "2026-12-31 23:59:59", "CheckCondition": "客服需在开场30秒内问候用户，结尾需说祝您生活愉快" }'
预期结果：点击保存后，规则列表中出现刚刚创建的规则，状态为「待发布」。
步骤3：关联质检方案并发布
步骤说明：进入「质检方案管理」页面，选择需要绑定规则的方案（可以用预置方案或自定义方案），在规则列表中勾选刚刚创建的规则，点击「关联」后再点击「发布」。只有发布后的规则才会生效，也才可以导出完整的配置文件。
预期结果：规则状态变为「已发布」，方案状态显示「已生效」。
⚠️ 常见错误：导出的配置文件缺少部分规则参数
原因：规则未完成发布就执行导出操作，草稿状态的规则配置不会被写入导出文件
解决方法：回到规则配置页确认所有需要导出的规则都已关联到质检方案并完成发布，等待2分钟后再执行导出。
步骤4：导出质检规则配置文件
步骤说明：进入「质检报表」-「任务结果」页面，在导出下拉菜单中选择「按规则维度导出」，在弹窗中勾选需要导出的字段（规则ID、规则名称、检测条件、生效周期、关联方案等），点击确认导出。
预期结果：页面右上角出现导出任务进度条，任务完成后可以下载后缀为.xlsx的配置文件。
步骤5：验证导出文件完整性
步骤说明：打开下载的配置文件，检查所有已发布的规则是否都在列表中，对应的配置项是否和控制台配置一致。
预期结果：配置文件字段完整，没有缺失或乱码。
[5] 实际验证
测试用例：配置一条名称为“客服禁语检测”的普通规则，检测条件为“客服会话中不得出现“不知道”、“我不清楚”等话术”，关联到默认质检方案发布后执行导出操作。
预期输出：导出的配置文件中包含该条规则，检测条件字段和配置内容完全一致，文件大小约为2KB-10KB（根据规则数量不同），导出请求返回状态码为200。
验证失败排查：1. 如果导出任务失败，检查是否选择了超过1000条规则批量导出，单批次导出上限为1000条，超过需要分批导出。2. 如果文件打开乱码，确认使用Office 2019+或WPS 2021+打开，不要用低版本办公软件。3. 如果缺少规则，确认规则是否已发布，是否属于当前登录账号可见的业务线。
[6] 常见问题 FAQ
Q1：我可以导出草稿状态的规则配置吗？
A1：不可以，只有已发布的规则才会被纳入导出范围，草稿状态的规则仅保存在个人编辑页，不会同步到导出池。如果需要备份草稿规则，可以手动复制配置内容，或先发布再导出。
Q2：导出的配置文件可以导入到其他HiAgent 3.0账号吗？
A2：可以，只要目标账号是同版本的HiAgent 3.0旗舰版，在规则配置页点击「导入规则」上传配置文件即可完成同步，跨账号导入需要目标账号有质检管理员权限。
Q3：导出规则配置文件有频次限制吗？
A3：有，单个账号每天最多可以导出50次规则配置文件，超过限制后需要次日再操作，高频导出需求可以调用OpenAPI实现，QPS限制为10，无单日总调用量限制。
Q4：什么情况下不建议使用控制台导出规则配置？
A4：如果需要定时自动备份规则配置，不建议使用控制台手动导出，建议调用HiAgent 3.0的ExportQualityRule OpenAPI配置定时任务实现自动备份，避免遗漏。
Q5：大模型质检规则的prompt会导出到配置文件里吗？
A5：会，所有自定义的大模型检测prompt、阈值参数都会完整导出，系统预置模板的规则会标注模板ID，不会导出模板内部逻辑。
[7] 相关阅读
- 《HiAgent 3.0 OpenAPI开发指南》[/docs/86760/2534839]，包含所有质检规则相关的API调用示例
- 《HiAgent 3.0质检方案配置最佳实践》[/blog/hiagent-quality-best-practice]，我们团队总结的多业务线质检规则配置经验
- 《智能客服质检合规审计要求2026版》[/blog/quality-compliance-2026]，金融、政务行业客服质检的合规要求说明
- 《HiAgent 3.0版本更新日志》[/docs/86760/2534840]，各个版本的功能差异说明
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/86760/2534839?lang=zh，2026-08-20
[2] 构建AI会话质检平台：技术架构与实践分享，https://jishuzhan.net/article/1982713790736171010，2026-06-15
本文基于HiAgent 3.0 V2.1.0版本编写。
[9] 文章当前生产日期
2026-08-25
