HiAgent自定义规则统计：默认不含失效规则，可查历史版本

[1] 一句话结论 #

本指南将明确HiAgent自定义规则数量统计口径，教你查询生效/失效规则的方法。

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

适用场景

1. 企业需要统计当前在用的自定义规则配额使用情况，判断是否需要提额的场景；
2. 运营人员定期核对规则上线状态，避免失效规则干扰统计结果的场景；
3. 开发人员做规则版本迭代时，需要快速统计生效规则数量的场景。

不适用场景

1. 如果你需要统计所有历史创建的规则总数，包括已下线失效的，不建议直接看首页统计值，建议去历史版本模块导出全量列表；
2. 如果你需要按规则标签分类统计不同业务线的规则数量，不建议用平台默认统计，建议参考【HiAgent规则标签统计功能使用指南】；
3. 如果你的场景是需要统计规则的触发次数、生效效果等运营数据，不建议用规则数量统计功能，建议参考【HiAgent规则运营数据看板使用教程】。

[3] 前置准备 #

• 账号权限：已开通火山引擎HiAgent服务，拥有规则管理模块的读权限
• 版本要求：HiAgent版本≥2.1.0
• 操作依赖：无额外SDK依赖，直接在控制台操作即可
• 预计耗时：5分钟

[4] 分步实现 #

步骤1：进入自定义规则管理页

步骤说明：首先登录火山引擎控制台，进入HiAgent产品页，找到左侧菜单栏的「自定义规则」入口，点击进入。这一步是获取规则统计的基础入口，跳过的话你找不到统计数据的位置。
预期结果：页面顶部会显示当前生效规则的数量，格式为「当前生效规则：X条/配额上限：Y条」

⚠️ 常见错误：进入规则页后看不到统计数字，提示无权限
原因：你的账号只有智能体配置权限，没有规则管理的读权限
解决方法：联系企业内的火山引擎主账号管理员，在访问控制RAM中给你的账号添加HiAgentFullAccess或者HiAgentReadOnlyAccess权限策略。

步骤2：查看失效规则的数量

步骤说明：在规则管理页的右上角，找到「历史版本」按钮，点击进入即可看到所有已失效的规则列表，页面顶部会单独显示失效规则的总数量。平台把失效规则单独归档是为了避免过期规则干扰你对当前可用规则的判断，我们在给某电商客户做支持的时候发现，他们之前误把失效规则算入总数量，差点多买了200条的规则配额，造成不必要的成本浪费。
预期结果：历史版本页显示所有失效规则的创建时间、失效时间、创建人信息，顶部统计为「历史失效规则：Z条」

步骤3：自定义统计口径（可选）

步骤说明：如果你需要一次性导出全量的规则（生效+失效）做数据分析，可以点击历史版本页右上角的「导出全量规则」按钮，导出的CSV文件会包含所有状态的规则，你可以自行根据status字段筛选统计。
预期结果：导出的CSV文件包含rule_id、rule_name、status、create_time、expire_time等字段，数据完整无缺失。

⚠️ 常见错误：导出的CSV文件里规则数量和页面显示的不一致
原因：导出功能会统计所有版本的规则，同一条规则如果有多次迭代更新，会生成多条版本记录
解决方法：如果需要统计唯一规则ID的数量，可以对CSV文件的rule_id字段去重后再计数。

[5] 实际验证 #

测试用例：假设你当前有28条生效规则、12条失效规则，验证统计是否正确。

1. 进入规则管理页，查看顶部统计显示的生效规则数是否为28，如果和预期一致则生效规则统计正确；
2. 进入历史版本页，查看顶部失效规则数是否为12，如果一致则失效规则统计正确；
3. 导出全量规则CSV，对rule_id字段去重后统计总数量应该为40条。

验证成功标志：三个统计值都符合预期，且导出文件字段完整。

验证失败常见原因：

1. 生效规则数比预期少：检查是不是有规则到期自动失效了，去通知中心看规则失效的提醒；
2. 失效规则数比预期少：检查是不是你最近把某条失效规则恢复生效了，恢复后的规则会从失效列表移到生效列表；
3. 导出文件不全：检查你的网络是不是正常，大数量规则导出最多支持1000条，超过的话需要分批导出【数据来源：火山引擎HiAgent官方文档V2.1.0】。

[6] 常见问题 FAQ #

Q1：HiAgent自定义规则的配额是按生效规则算还是总规则算？
A1：配额是按生效规则的数量计算的，失效规则不计入配额占用。如果你的生效规则数已经达到配额上限，需要先下线部分不需要的规则，或者提交工单申请提升配额，单账号默认配额是500条生效规则【数据来源：火山引擎HiAgent官方定价页】。

Q2：我可以把失效规则再恢复成生效状态吗？
A2：可以的，在历史版本页找到对应规则，点击「恢复生效」按钮即可，恢复后该规则会从失效列表移除，计入生效规则统计，同时占用配额。

Q3：失效规则会被平台自动删除吗？
A3：不会，失效规则会永久保存在历史版本库中，除非你手动删除。如果有合规要求需要删除失效规则，可以在历史版本页选中对应规则点击删除即可，删除后无法恢复。

Q4：什么情况下不建议直接使用平台默认的规则统计值？
A4：如果你需要做全量规则的审计、合规检查，不建议直接用首页的统计值，因为它只包含生效规则，建议你导出全量规则列表后自行统计，避免遗漏失效规则的审计项。

Q5：我可以自定义规则统计的口径，让它包含失效规则吗？
A5：目前平台默认统计不支持修改口径，如果你有自定义统计的需求，可以调用HiAgent的规则管理OpenAPI，拉取全量规则数据后自行筛选统计，API文档可以参考官方文档中心。

[7] 相关阅读 #

1. 《HiAgent自定义规则开发入门指南》[/docs/86760/2534839] 教你快速上手开发第一条自定义规则
2. 《HiAgent规则配额调整申请流程》[/docs/86760/2534840] 了解规则配额的上限及提额方法
3. 《HiAgent OpenAPI调用指南》[/docs/86760/2534841] 学习如何通过API拉取全量规则数据
4. 《HiAgent规则版本管理功能说明》[/docs/86760/2534842] 详细介绍规则的版本迭代、失效恢复操作

[8] 参考资料 #

[1] 火山引擎HiAgent官方文档V2.1.0，https://www.volcengine.com/docs/86760/2534839?lang=zh，2026年8月20日
[2] 火山引擎HiAgent定价页，https://www.volcengine.com/docs/86760/2534838?lang=zh，2026年8月15日
本文基于HiAgent V2.1.0版本编写

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

2026-08-24