HiAgent 3.0质检规则删除：操作指南与风险规避

[1] 一句话结论 #

本指南将带你完成HiAgent 3.0会话质检规则的删除操作，规避常见操作风险。

[2] 适用场景与不适用场景 #

适用场景

1. 日常运营中清理过期、无效的会话质检规则，单次删除规则数量≤50条的场景；
2. 质检规则迭代时，下架不符合当前业务质检标准的旧规则的场景；
3. 测试环境中删除临时创建的测试用质检规则的场景。

不适用场景

1. 需要批量删除50条以上质检规则的场景，建议参考【HiAgent 3.0批量操作API文档】调用接口处理，避免页面操作卡顿超时；
2. 仅需要临时停用规则后续还会复用的场景，不要选择删除，建议直接在规则列表点击「停用」按钮即可；
3. 规则关联了正在运行的核心质检任务的场景，不建议直接删除，建议先解绑关联任务后再操作。

[3] 前置准备 #

• HiAgent 3.0后台账号，需拥有「质检规则管理」的编辑/删除权限（普通访客账号无操作权限）；
• 浏览器版本要求Chrome 100+、Edge 100+，不兼容IE11及以下版本；
• 提前确认需要删除的规则ID/规则名称，避免误删正常运行的规则；
• 预计操作耗时：单条规则删除≤1分钟，批量10条以内删除≤5分钟。

[4] 分步实现 #

步骤1：登录后台进入质检规则配置页

步骤说明：我们建议你用有权限的账号登录HiAgent 3.0管理后台，从左侧导航栏进入「会话质检」-「规则配置」模块，这一步是确保你能看到全量的规则列表，跳过的话无法找到对应的操作入口。
预期结果：页面完整加载所有已创建的质检规则，包含规则名称、创建时间、关联任务数、状态等字段。

⚠️ 常见错误：进入规则配置页后只能看到自己创建的规则，看不到其他团队成员创建的规则
原因：账号权限为个人规则权限，未申请团队级别的规则管理权限
解决方法：联系企业HiAgent管理员在「权限中心」为你的账号开通「团队质检规则全量管理」权限。

步骤2：筛选定位待删除的目标规则

步骤说明：可以通过页面顶部的搜索框输入规则名称/ID，或者通过状态、创建时间筛选项快速定位需要删除的规则，这一步是避免误删其他正常规则，跳过可能出现删错规则的问题。
预期结果：列表中仅展示符合筛选条件的规则，可确认待删除规则的关联任务数、状态等信息。

⚠️ 常见错误：搜索规则时输入完整名称也搜不到目标规则
原因：规则可能已经被停用或者被其他管理员删除，或者你输入的名称包含特殊字符转义问题
解决方法：先清除搜索条件查看全量规则的状态，或者用规则ID精确搜索。

步骤3：点击删除按钮触发确认流程

步骤说明：在目标规则对应的右侧操作列，点击「删除」按钮，系统会先校验该规则是否关联了正在运行的质检任务，如果有关联会弹出提示展示关联的任务列表，这一步是让你提前感知删除操作对现有业务的影响。
预期结果：弹出删除二次确认弹窗，若规则有关联任务会优先展示关联任务信息。

步骤4：确认删除完成操作

步骤说明：如果确认不需要该规则，即使有关联任务也可以选择强制删除，否则建议先解绑关联任务后再确认删除，点击「确定」即可完成操作，删除后的规则无法恢复。
预期结果：页面弹出“删除成功”的提示，规则从当前列表中消失。

[5] 实际验证 #

我们提供一个标准测试用例供你验证操作结果：输入待删除规则名称为“2025年旧客服话术合规规则”，规则ID为QR20250101001，未关联任何运行中任务，按照上述步骤执行删除。
预期输出：页面返回HTTP 200状态码，列表中不再展示该规则，质检任务中不会再调用该规则进行质检。
验证成功标志：1. 页面有明确的删除成功toast提示；2. 刷新规则列表后该规则不存在；3. 查看关联的历史质检记录，已完成的质检结果不受影响，新的质检任务不会命中该规则。
验证失败常见原因：1. 删除时提示“无操作权限”：排查账号是否有规则删除权限，联系管理员开通；2. 删除时提示“规则正在被任务占用无法删除”：先进入关联的任务详情页，将该规则从任务的规则组中移除后再删除；3. 删除后刷新列表规则仍然存在：排查是否是浏览器缓存问题，按Ctrl+F5强制刷新页面后再次查看。

[6] 常见问题 FAQ #

问题1：删除质检规则后，之前用这个规则质检出来的结果会被删除吗？
答案：不会。删除规则仅会影响后续新的质检任务，已经生成的历史质检结果会保留，不会被联动删除，如果你需要清理历史结果可以到「质检记录」模块手动操作。

问题2：我可以批量删除多个质检规则吗？
答案：目前页面端最多支持同时选中20条规则批量删除，如果需要删除超过20条的规则，建议调用HiAgent 3.0的批量规则管理API进行操作，API单次最多支持删除100条规则，操作效率更高。

问题3：什么情况下不建议直接删除质检规则？
答案：如果该规则只是暂时不需要使用，后续还会恢复启用，或者你不确定后续是否需要使用的情况下，不建议直接删除，建议先点击「停用」按钮将规则下架，停用后的规则不会被新的质检任务调用，后续需要时可以随时启用，比删除操作风险更低。

问题4：删除规则的时候提示“强制删除会导致关联任务异常”，我还能删吗？
答案：如果确认该规则和关联的任务都不需要再运行，可以选择强制删除，强制删除后关联的任务会自动将该规则从规则组中移除，不会导致任务崩溃，只是对应的质检项会失效。

问题5：删除操作可以撤销吗，误删了规则怎么找回？
答案：删除操作是不可逆的，无法直接撤销，如果误删了规则，你可以到「操作日志」模块查看该规则的历史配置信息，手动重新创建相同配置的规则，或者联系火山引擎技术支持尝试从备份中恢复，数据备份保留期限为7天（数据来源：火山引擎HiAgent官方服务协议）。

[7] 相关阅读 #

• 《HiAgent 3.0质检规则创建与配置全指南》，[/blog/hiagent-3-quality-rule-create]，介绍从0到1创建适配业务的会话质检规则的完整流程。
• 《HiAgent 3.0批量规则操作API文档》，[/docs/hiagent-3-api-batch-rule]，包含批量创建、删除、修改质检规则的接口参数和调用示例。
• 《HiAgent 3.0权限配置最佳实践》，[/blog/hiagent-3-permission-best-practice]，讲解如何合理分配后台操作权限，避免误操作影响业务。
• 《HiAgent 3.0会话质检任务配置指南》，[/blog/hiagent-3-quality-task-config]，教你如何将质检规则绑定到具体的质检任务中。

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0官方操作手册，https://www.volcengine.com/docs/hiagent/3.0/rule-manage，2026-08-20
[2] 火山引擎HiAgent“1+N+X”智能体工作站发布，http://m.toutiao.com/group/7586893976351801862/?upstream_biz=VolcEngine，2026-08-25
本文基于HiAgent 3.0 v2.4.1版本编写。

[9] 文章当前生产日期 #

2026-08-25