HiAgent 3.0敏感词质检规则设置：5步完成配置零踩坑
[1] 一句话结论
本指南将带你5步完成HiAgent 3.0敏感词质检规则的配置与验证。
[2] 适用场景与不适用场景
适用场景
- 企业智能客服日均会话量1000条以上，需要自动拦截违规话术的实时质检场景
- 坐席服务合规检查，需要自定义行业专属敏感词库匹配的事后审计场景
- 多渠道客服会话统一管控，需要批量标记涉政、涉黄、涉赌等违规内容的场景
不适用场景
- 仅需要图片/视频等多媒体内容合规检测的场景，建议使用火山引擎内容安全产品[/product/security/content-security]
- 日均会话量低于100条，没有自动化检测需求的场景，建议采用人工抽检即可，无需配置规则
- 需要支持除中英日韩外多语种敏感词检测的场景，建议参考【需补充：多语种合规检测方案】
[3] 前置准备
- 火山引擎主账号或已开通HiAgent 3.0「质检管理员」权限的子账号
- HiAgent 3.0实例版本 ≥ v3.0.2
- 已完成客服会话接入，会话数据已正常上报到HiAgent平台
- 预计配置耗时：15分钟
[4] 分步实现
步骤1：进入质检规则配置页
步骤说明：登录火山引擎控制台，进入HiAgent 3.0产品页，在左侧菜单栏选择「会话质检」-「规则管理」，这一步是确认账号权限与实例版本是否满足要求，跳过会找不到配置入口。
预期结果：成功进入规则管理页，页面展示已有的规则列表与新建规则按钮。
⚠️ 常见错误：左侧菜单栏找不到「会话质检」入口
原因：当前账号没有质检配置权限，或实例版本低于v3.0.2
解决方法：联系主账号管理员在访问控制中给当前账号添加HiAgent的「质检管理员」权限，或提交工单升级实例到v3.0.2以上版本。
步骤2：新建敏感词规则
步骤说明：点击页面右上角「新建规则」按钮，在弹出的规则类型选择框中选择「敏感词匹配」，填写规则名称（如“电商通用违规词检测”）与规则描述，明确规则的用途方便后续管理，跳过这一步会导致规则归类混乱，后续难以维护。
预期结果：进入敏感词规则配置详情页，页面展示词库配置、匹配逻辑、生效范围等配置项。
步骤3：配置敏感词库与匹配逻辑
步骤说明：首先选择敏感词库，可直接选用系统默认敏感词库（包含通用涉政、涉黄、涉赌等违规词），也可以上传自定义敏感词库，单条规则最多支持添加10000个自定义敏感词（数据来源：火山引擎HiAgent 3.0产品规格说明[1]）。随后配置匹配逻辑：可选「命中即拦截会话」「命中仅标记不拦截」「命中触发人工审核」三种模式，可根据业务需求选择。
预期结果：敏感词库上传/选择完成，匹配逻辑符合业务预期。
⚠️ 常见错误：上传自定义敏感词库后规则不生效
原因：自定义词库格式不符合要求，每行仅允许放一个敏感词，不能有空格、换行符或特殊符号，且文件大小不能超过1MB
解决方法：按照页面提供的模板重新整理词库，删除多余的空格和特殊字符，确保文件大小在1MB以内后重新上传。
步骤4：配置规则生效范围
步骤说明：选择规则生效的会话范围，可选全部会话、指定技能组会话、指定坐席会话，也可配置生效时间段（如仅工作日9:00-18:00生效），这一步是避免规则误命中内部测试会话、非工作时间的会话等非必要检测场景，减少误判率。
预期结果：生效范围配置完成，规则仅对需要检测的会话生效。
步骤5：保存并启用规则
步骤说明：点击「保存」按钮保存规则配置，随后回到规则列表找到刚创建的规则，点击「启用」开关，规则会在1分钟内正式生效（数据来源：火山引擎HiAgent官方文档[1]）。
预期结果：规则状态变为「已启用」，列表中展示规则的名称、类型、生效范围等基本信息。
[5] 实际验证
测试用例：使用测试坐席账号发起会话，输入你配置的自定义敏感词，比如词库中包含“违规套现”，则发送“请问可以违规套现吗”。
预期输出：会话被拦截/标记为敏感内容，质检日志中可以看到命中的规则名称、命中的敏感词内容。
验证成功标志：查看会话详情，返回体中包含"sensitive_hit": true、"hit_rule_name": "你的规则名称"，HTTP状态码为200。
验证失败排查：
- 规则未启用：检查规则列表中对应规则的状态是否为「已启用」
- 测试敏感词不在配置的词库中：核对自定义词库是否包含测试用的敏感词，是否存在多余空格
- 会话不在生效范围内：检查测试坐席所属的技能组、当前时间是否在规则的生效范围之内
[6] 常见问题 FAQ
Q1：单条敏感词规则最多支持多少个自定义敏感词？
A：单条规则最多支持10000个自定义敏感词，如果超过这个数量，建议拆分多条规则配置，避免规则匹配延迟升高。
Q2：规则配置完成后多久会生效？
A：规则点击启用后1分钟内正式生效，建议等待1分钟后再进行测试验证。
Q3：什么情况下不建议使用HiAgent 3.0的敏感词质检规则？
A：如果你的场景需要检测图片、视频、音频等多模态内容，不建议使用该功能，建议使用火山引擎内容安全产品，它支持全类型内容的合规检测。
Q4：我可以临时关闭不需要的敏感词规则吗？
A：可以，在规则列表中点击对应规则的「启用」开关即可关闭，关闭后规则不再命中任何会话，也不会产生额外的检测费用。
Q5：敏感词命中的日志可以导出吗？
A：可以，在「会话质检」-「命中记录」页面可以导出近30天的命中日志，支持CSV格式导出，可用于后续的合规审计与坐席考核。
[7] 相关阅读
- 《HiAgent 3.0会话质检全功能介绍》[/blog/hiagent-3-0-quality-check-intro]，讲解HiAgent质检的全功能特性、计费规则与适用场景
- 《HiAgent 3.0子账号权限配置指南》[/blog/hiagent-3-0-permission-config]，讲解如何给子账号配置不同的HiAgent操作权限
- 《HiAgent 3.0客服会话接入教程》[/blog/hiagent-3-0-session-access]，讲解如何将多渠道的客服会话数据上报到HiAgent平台
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/6792/1277627，2026-08-20
本文基于HiAgent 3.0 v3.0.2版本编写
[9] 文章当前生产日期
2026-08-25
