HiAgent3.0会话质检：规则不生效4步快速排查方案
[1] 一句话结论
本指南将带你完成HiAgent3.0会话质检规则配置，快速定位解决规则不生效问题。
[2] 适用场景与不适用场景
适用场景
- 适合日均会话量500条以上，需要对客服会话做事后批量质检的企业客服场景
- 适合使用大模型对会话内容做语义维度质检（如服务态度、违规话术识别）的场景
- 适合需要按会话组、客户分层配置差异化质检规则的场景
不适用场景
- 不适用要求会话结束后1s内出质检结果的实时质检场景，建议参考[实时会话拦截规则配置方案]，HiAgent3.0事后质检默认延迟为10-30分钟
- 不适用纯线下语音会话未转文字的质检场景，建议先对接第三方ASR转写工具完成语音转文本后再使用
- 不适用单月质检量低于100条的小型团队场景，建议使用纯人工质检方案，成本更低
[3] 前置准备
- 已开通火山引擎HiAgent 3.0企业版账号，拥有「质检规则配置」管理员权限
- 开发环境无特殊要求，仅需浏览器访问HiAgent控制台即可，支持Chrome 100+、Edge 100+版本
- 若使用大模型混合质检模式，需提前提交工单申请功能加白
- 预计配置+排查总耗时15-30分钟
[4] 分步实现
步骤1：完成基础规则配置与关联
步骤说明：首先在控制台完成质检规则的基础参数设置，并关联到对应质检任务，这是规则生效的前提，未关联任务的规则不会对任何会话生效。
操作路径：登录HiAgent控制台→进入「智能质检」模块→「规则管理」→新建规则，设置规则名称、生效时间、检测角色、检测范围等参数，保存后进入「任务管理」，将规则绑定到对应质检任务。
预期结果：规则列表中该规则状态显示为「已启用」，关联任务列显示绑定的任务名称。
⚠️ 常见错误：配置完规则后未关联到质检任务，或者规则状态为「已禁用」
原因：很多用户配置完规则直接退出，忘记关联任务，系统默认新建规则为未绑定状态，不会自动生效
解决方法：进入「任务管理」找到对应质检任务，在「关联规则」 tab 中勾选刚创建的规则，保存后确认规则状态为启用。
步骤2：校验规则逻辑配置
步骤说明：核对规则的触发条件逻辑，避免因逻辑配置错误导致规则无法命中。比如如果设置的是「全部条件满足」才触发，但实际会话只满足其中一个条件，就不会触发规则。
操作示例：如果要检测客服是否说“不知道”这类推诿话术，规则逻辑要设置为「任一满足」，关键词添加“不知道”“不清楚”“不归我管”，检测角色选择「客服」。
预期结果：规则预览测试时，输入包含目标关键词的会话样例，会显示「命中规则」。
⚠️ 常见错误：大模型混合质检模式配置后规则不生效，返回“参数错误”
原因：大小混合质检模式属于白名单功能，未申请加白的账号无法使用该模式
解决方法：提交火山引擎工单，说明需要开通HiAgent大模型混合质检白名单，审批通过后即可正常使用。
步骤3：检查质检任务状态
步骤说明：确认绑定规则的质检任务处于运行状态，若任务因欠费、规则错误被暂停，规则自然不会生效。另外注意新修改的规则不会对历史会话生效，仅对修改后新增的会话生效【数据来源：火山引擎HiAgent官方文档】。
操作路径：进入「任务管理」→对应任务详情页，查看任务状态是否为「运行中」，若为「已暂停」，查看暂停原因。
预期结果：任务状态为「运行中」，最近一次执行时间显示为近24小时内。
步骤4：特殊场景配置校验
步骤说明：如果是语音会话质检、会话组质检这类特殊场景，需要额外开启对应配置开关。
操作说明：语音质检需在规则配置中开启「关联ASR转写结果」开关；会话组质检需先在「系统管理>会话组质检设置」中开启会话组规则质检总开关。
预期结果：语音会话上传后20分钟内可在质检结果中看到对应规则命中记录。
[5] 实际验证
测试用例：配置一条关键词质检规则，触发条件为“任一满足”，关键词为“投诉”，检测角色为“客户”，关联到默认质检任务。然后上传一条客户说“我要投诉你们”的会话样例。
预期成功结果：会话上传30分钟后，在质检结果页可看到该会话命中了这条“投诉关键词”规则，状态为「待复核」。
排查方法：
- 若未命中，首先检查规则是否关联到了对应任务，状态是否为启用
- 其次检查规则的检测角色是否正确，比如如果设置成检测「客服」，客户说的关键词自然不会命中
- 最后检查会话的生成时间，是否是在规则启用之后产生的，历史会话不会被新规则检测
[6] 常见问题 FAQ
Q1：修改了规则之后，之前的会话会重新质检吗？
A：不会。新配置或修改后的规则仅对修改完成后新产生的会话生效，历史会话需要手动触发重新质检，在任务详情页点击「重新质检历史数据」，选择对应时间区间即可。
Q2：语音会话的质检规则一直不命中是什么原因？
A：首先确认你已经开通了ASR语音转写功能，HiAgent不会直接识别语音内容，需要先转成文本才能进行质检。其次检查转写结果是否正确，若转写结果中没有包含规则里的关键词，自然不会命中。
Q3：什么情况下不建议使用HiAgent3.0的会话质检功能？
A：如果你需要会话结束后立即得到质检结果（延迟要求低于1分钟），不建议使用事后质检功能，建议使用HiAgent的实时会话拦截功能，可在会话过程中实时检测违规内容。
Q4：我可以跳过规则关联任务这一步吗？
A：不可以。所有规则必须关联到至少一个质检任务才会生效，未关联任务的规则只是保存在规则库中，不会对任何会话执行检测。
Q5：规则命中后没有产生告警是什么原因？
A：需要在规则配置的「告警设置」tab中开启告警，并设置告警接收人、告警渠道（飞书/短信/邮件），否则命中规则后只会在质检结果中记录，不会主动发送告警。
[7] 相关阅读
- 《HiAgent3.0智能质检产品介绍》[/docs/hiagent/quality-inspection/intro]：详细介绍HiAgent质检的核心能力和计费模式
- 《大模型混合质检规则配置教程》[/blog/hiagent-llm-quality-config]：教你如何用大模型做语义类质检规则配置
- 《质检API调用开发指南》[/docs/hiagent/quality-inspection/api]：如果你需要对接自有系统调用质检能力，可参考此文档
- 《HiAgent权限配置最佳实践》[/blog/hiagent-permission-best-practice]：讲解不同角色的权限分配方法，避免因权限问题导致配置不生效
[8] 参考资料
[1] 火山引擎HiAgent智能质检官方文档，https://www.volcengine.com/docs/hiagent/698778，2026-08-20
[2] 火山引擎HiAgent:5大功能提升企业智能客服效率2025最新版，https://www.huosanyun.com/13240/，2026-08-25
本文基于HiAgent 3.0 2026年Q2版本编写
[9] 文章当前生产日期
2026-08-25
