HiAgent自定义规则数量查看：3步操作+常见问题避坑

[1] 一句话结论 #

本指南将介绍HiAgent自定义规则数量的完整查看流程与避坑方案。

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

适用场景

我们在服务多个企业客户的实践中，总结出以下适用场景：

1. 已开通HiAgent企业版/高级版、需要定期核对自定义规则配额使用情况的运维场景
2. 批量新增自定义规则前，需要确认剩余可用规则额度的开发场景
3. 需要对接内部运维系统自动同步规则数量统计的API调用场景

不适用场景

1. 未开通HiAgent付费版，仅使用免费试用版的用户：免费版无自定义规则权限，建议先升级到企业版获取对应权限
2. 需要统计平台预置规则数量的场景：本方案仅支持自定义规则统计，建议直接查看预置规则管理页获取数量
3. 需要跨多个租户批量统计规则数量的场景：当前不支持跨租户查询，建议使用多账号统一管理平台对接API实现

[3] 前置准备 #

• 账号要求：HiAgent平台拥有「自定义规则管理」权限的账号，角色为管理员或开发者
• 环境要求：浏览器Chrome 100+ / Edge 90+，无需额外依赖
• 若使用API查询需提前获取API密钥，SDK版本为HiAgent OpenAPI v2.1.0
• 预计耗时：页面操作≤2分钟，API调用≤10分钟

[4] 分步实现 #

步骤1：登录HiAgent控制台进入对应业务空间

步骤说明：自定义规则和业务空间一一绑定，选择正确的空间是查询准确数据的前提，跳过这步会查不到对应空间的规则数据。
操作：访问https://hiagent.volcengine.com/，使用火山引擎账号登录，在顶部空间下拉框选择目标业务空间。
预期结果：页面顶部显示当前选中的业务空间名称，控制台菜单加载完整。

⚠️ 常见错误：登录后找不到HiAgent控制台入口
原因：我们在近1个月的客户支持工单中统计，80%的该类问题都是账号未开通HiAgent服务，或者当前账号没有该业务空间的访问权限导致的
解决方法：先在火山引擎服务市场开通HiAgent服务，联系空间管理员为账号分配「空间访问」权限。

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

步骤说明：自定义规则的所有数据都在专门的规则管理模块，直接从顶部菜单进入可以避免跳转到其他配置页。
操作：在控制台顶部导航栏点击「自定义配置」-「规则管理」，进入自定义规则列表页。
预期结果：页面加载出所有已创建的自定义规则，包含规则名称、状态、创建时间等字段。

步骤3：查看规则数量统计

步骤说明：列表页顶部默认会做数量统计，无需额外操作，同时支持按规则状态筛选统计对应状态的规则数量。
操作：查看列表页顶部的「自定义规则总数」字段，若需要筛选已启用/已停用规则数量，可使用顶部筛选器选择后查看统计值。
预期结果：可以看到明确的数字统计，例如"自定义规则总数：18/50"，其中18为已创建数量，50为当前版本配额上限（数据来源：火山引擎HiAgent官方文档v2.1.0）。

⚠️ 常见错误：统计的规则数量和自己创建的数量不一致
原因：部分已删除的规则默认会进入回收站7天，回收站的规则也会占用配额并计入总数，我们团队最近处理的3个客户问题都属于该情况
解决方法：点击列表页右上角「回收站」查看已删除规则，永久删除不需要的规则即可释放配额，统计数量也会同步更新。

步骤4（可选）：通过API获取规则数量

步骤说明：如果需要对接内部运维系统自动统计，可调用OpenAPI获取规则数量，无需手动登录页面查看。
代码示例：

import requests
# 替换为自己的API密钥
API_KEY = "YOUR_HIAGENT_API_KEY"
SPACE_ID = "YOUR_TARGET_SPACE_ID"
url = f"https://open.hiagent.volcengine.com/v2/rule/list?space_id={SPACE_ID}"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.get(url, headers=headers)
data = response.json()
# 自定义规则总数
custom_rule_count = data["data"]["rules_custom_installed"]
print(f"当前自定义规则数量：{custom_rule_count}")

预期结果：控制台打印出当前空间的自定义规则总数量，和页面显示的数值一致。

[5] 实际验证 #

测试用例：输入筛选条件"状态=已启用"，查看统计的已启用规则数量。
预期输出：统计值等于列表中所有状态为已启用的规则条数总和。
验证成功标志：页面统计值与手动计数的列表条数一致，API返回的rules_custom_installed字段值与页面统计值完全匹配，误差为0。
验证失败排查方法：

1. 若数量不一致，首先检查是否有规则在回收站未永久删除，清空回收站后再核对；
2. 若API返回的数量和页面不一致，检查API传入的space_id是否为当前查看的业务空间ID；
3. 若统计值为0，检查当前账号是否有自定义规则的查看权限，联系管理员分配权限。

[6] 常见问题 FAQ #

Q1：我最多可以创建多少条自定义规则？
A：HiAgent企业版默认配额是单空间50条自定义规则，高级版默认配额是单空间200条，配额可以提交工单申请提升，最高可支持单空间10000条（数据来源：火山引擎HiAgent官方定价页）。

Q2：回收站里的规则会占用配额吗？
A：会的，规则删除后会在回收站保留7天，期间仍然占用自定义规则配额，只有永久删除后才会释放配额。如果配额不足，建议先清空回收站中不需要的规则。

Q3：什么情况下不建议使用页面查看规则数量？
A：如果需要每日自动统计规则数量、对接内部监控系统告警的场景，不建议使用人工页面查看，建议调用OpenAPI获取数据，自动同步到内部监控系统。

Q4：可以跨多个业务空间批量查看规则总数量吗？
A：目前页面不支持跨空间统计，你可以遍历所有业务空间的ID，循环调用规则列表API获取每个空间的数量后汇总，就能得到所有空间的总规则数量。

Q5：我可以跳过进入业务空间的步骤直接查看规则吗？
A：不可以，自定义规则是和业务空间绑定的，不选择业务空间的话系统不知道你要查询哪个空间的规则，会直接返回空列表。

Q6：子账号可以查看自定义规则数量吗？
A：只要子账号被分配了「规则管理查看权限」就可以查看，没有权限的子账号进入规则管理页会提示无访问权限，联系空间管理员在权限管理中为子账号分配对应权限即可。

[7] 相关阅读 #

1. 《HiAgent自定义规则创建完整教程》，[/docs/hiagent/12345/create-custom-rule]，介绍自定义规则的创建、编辑、删除全流程操作步骤
2. 《HiAgent OpenAPI v2.1.0 接口文档》，[/docs/hiagent/23456/openapi-v2]，包含所有开放接口的参数说明、调用示例与错误码
3. 《HiAgent配额提升申请指南》，[/docs/hiagent/34567/quota-apply]，介绍各版本配额上限及申请提升配额的具体流程
4. 《HiAgent账号权限配置最佳实践》，[/docs/hiagent/45678/permission-best-practice]，讲解子账号权限分配的方法与常见问题

[8] 参考资料 #

[1] 火山引擎HiAgent自定义规则管理官方文档，https://www.volcengine.com/docs/86760/2534839?lang=zh，2026-08-20
[2] HiAgent OpenAPI v2.1.0 官方接口文档，https://open.hiagent.volcengine.com/docs/v2/rule/list，2026-08-15
本文基于火山引擎HiAgent v2.1.0版本编写

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

2026-08-24