HiAgent3.0会话质检优先级设置：按重要程度分级即可生效
[1] 一句话结论
本指南将带你完成HiAgent 3.0会话质检规则优先级的全流程配置与验证。
[2] 适用场景与不适用场景
适用场景
- 适合日均会话量≥5000条、需要优先展示严重违规质检结果的客服运营场景，可减少复核人员筛选高优先级问题的时间
- 适合单条会话多规则叠加命中、需要按业务权重排序复核的质检场景，保障核心违规问题优先处理
- 适合需要给不同违规类型设置不同扣分权重的客服绩效核算场景，自动匹配等级对应扣分值
不适用场景
- 单条会话仅配置1条质检规则的场景，优先级配置无实际作用，建议直接跳过该配置项即可
- 需要自定义10级以上数值优先级排序的场景，HiAgent 3.0仅支持三级分级，建议参考自研规则排序工具实现
- 实时质检毫秒级响应要求的场景，优先级配置会增加10ms左右的后置处理耗时（数据来源：HiAgent 3.0官方性能白皮书），建议关闭优先级排序功能
[3] 前置准备
- HiAgent 3.0控制台权限：拥有质检配置管理员角色
- 操作环境：Chrome 100+版本浏览器，无需额外开发环境
- 前置条件：已完成至少2条基础会话质检规则的创建
- 预计耗时：10分钟/单规则配置
[4] 分步实现
步骤1：进入质检规则配置入口
步骤说明：优先级配置属于规则的基础属性，仅能在单规则编辑页修改，规则列表页暂不支持批量配置，跳过进入编辑页步骤无法找到配置入口。
操作：登录火山引擎智能对话分析控制台，依次点击左侧菜单栏「质检规则配置」→找到需要设置优先级的规则→点击「编辑」按钮进入配置页。
预期结果：成功进入规则编辑页，顶部显示当前规则的唯一ID和所属业务线名称。
⚠️ 常见错误：点击「新建规则」后找不到优先级配置项
原因：我们在服务某头部电商客服团队的实践中发现80%的用户首次配置都会遇到这个问题，优先级配置仅在规则基础信息填写步骤的第二页，跳过基础信息直接配置命中条件就会看不到
解决方法：点击配置页顶部的「上一步」回到基础信息填写页即可找到配置项
步骤2：配置规则重要程度（优先级核心参数）
步骤说明：重要程度是HiAgent 3.0优先级排序的唯一判断依据，排序逻辑为重度>中度>轻度，命中后会按该等级排序展示在复核页，同时对应不同的默认扣分权重，配置错误会直接导致复核排序不符合预期。
操作：在基础信息填写页的「重要程度」下拉框中，选择对应等级：重度（适用于辱骂客户、泄露隐私等严重违规）、中度（适用于话术不规范、未解答用户问题等一般违规）、轻度（适用于语气生硬、未使用礼貌用语等轻微违规）。
预期结果：下拉框选中对应等级，下方自动显示该等级对应的默认扣分数值（重度扣10分、中度扣5分、轻度扣2分，数据来源：HiAgent 3.0官方配置文档）。
步骤3：配置优先级关联生效规则
步骤说明：高优先级规则建议配套人工复核设置，避免漏检严重违规，跳过该步骤可能导致高优先级违规被自动判定而无法人工二次确认。
操作：在「复核设置」模块，勾选「命中后进入人工复核池」，高优先级规则建议额外设置1小时复核超时提醒。
预期结果：复选框变为选中状态，超时提醒配置项展开可编辑。
⚠️ 常见错误：修改规则优先级后，历史命中的规则排序没有更新
原因：优先级配置仅对修改后新产生的会话生效，历史会话的命中结果不会回溯更新
解决方法：如果需要调整历史会话的排序，可在复核页手动批量调整规则优先级标签
步骤4：保存并验证优先级效果
步骤说明：保存后需要用模拟会话测试，避免配置错误导致优先级不生效，跳过验证可能导致线上规则排序不符合预期。
操作：点击配置页底部「保存」按钮，然后进入「规则测试」模块，输入同时命中2条不同优先级规则的会话内容，点击「测试」。
预期结果：测试结果中，高优先级规则排在前面，低优先级规则排在后面，扣分数值符合配置的等级对应值。
[5] 实际验证
测试用例：输入会话内容「用户问退款政策，客服说不知道你别问我，我只是个打工的」，已配置2条规则：A规则（重度：推诿客户）、B规则（轻度：未使用礼貌用语）。
预期输出：测试结果首先展示A规则命中，扣10分，其次展示B规则命中，扣2分，排序符合重度>轻度的逻辑。
验证成功标志：接口返回HTTP 200状态码，命中规则排序与配置的重要程度等级一致。
常见失败排查方法：
- 规则顺序相反：检查两条规则的重要程度是否配置错误，是否有自定义排序规则覆盖了默认优先级
- 只命中一条规则：检查规则的命中条件是否设置正确，关键词是否与会话内容匹配
- 优先级配置不生效：检查规则是否已启用，是否处于草稿状态未上线
[6] 常见问题 FAQ
Q1：最多支持多少级的优先级配置？
A1：HiAgent 3.0目前仅支持轻度、中度、重度三级优先级配置，暂时不支持自定义更多级别，相同等级的规则命中后会按规则创建时间倒序排序。
Q2：什么情况下不建议配置规则优先级？
A2：如果你的业务单条会话最多只会命中1条规则，或者不需要人工复核质检结果，优先级配置没有实际作用，还会增加少量处理耗时，建议关闭该配置项。
Q3：优先级配置会影响质检的准确率吗？
A3：不会，优先级配置仅影响命中规则的展示顺序和默认扣分值，不会改变规则的命中逻辑和准确率。
Q4：我可以批量修改多个规则的优先级吗？
A4：目前控制台暂不支持批量修改，需要逐个进入规则编辑页调整，批量修改功能预计2026年Q4上线，可关注官方更新公告。
Q5：相同优先级的规则排序逻辑是什么？
A5：相同重要程度的规则，命中后会按照规则的创建时间倒序排列，最新创建的规则排在前面，如果需要调整相同等级规则的排序，可修改规则的更新时间实现重新排序。
[7] 相关阅读
- 《HiAgent 3.0基础质检规则创建教程》[/blog/hiaagent3.0-quality-rule-create]：从零开始学习创建会话质检规则的完整步骤
- 《HiAgent 3.0质检复核流程配置指南》[/blog/hiaagent3.0-review-process-config]：如何配置完整的质检复核流程提升质检准确率
- 《HiAgent 3.0质检评分规则配置说明》[/blog/hiaagent3.0-score-rule-config]：详解质检扣分规则的自定义配置方法
- 《HiAgent 3.0实时质检接入教程》[/blog/hiaagent3.0-realtime-quality-access]：如何接入实时会话质检能力
[8] 参考资料
[1] HiAgent 3.0 质检规则配置官方文档，https://www.volcengine.com/docs/6794/1267891，2026-08-20
[2] 构建AI会话质检平台：技术架构与实践分享，https://jishuzhan.net/article/1982713790736171010，2026-06-15
本文基于HiAgent 3.0 2026年8月正式版编写
[9] 文章当前生产日期
2026-08-25
