HiAgent查看剩余自定义规则数量：完整操作指南

[1] 一句话结论 #

本指南将讲解HiAgent查看剩余自定义规则数量的完整操作流程与注意事项。

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

适用场景

我们推荐在以下场景使用本指南的操作方法：

1. 适合使用HiAgent专业版/企业版、新增自定义规则前需要确认剩余配额的开发运维场景
2. 适合月度规则调整、批量清理冗余规则前统计配额使用情况的运营场景
3. 适合对接HiAgent OpenAPI进行规则自动化管理的二次开发场景

不适用场景

我们不推荐在以下场景使用本方案：

1. 如果你是HiAgent免费版用户，当前版本无自定义规则权限，建议升级到专业版获取该功能
2. 如果你需要查询系统内置规则数量，本方案不适用，建议直接在规则管理页「内置规则」标签页查看
3. 如果你的场景是批量导出所有规则明细，建议参考HiAgent批量导出规则API，无需手动统计

[3] 前置准备 #

开始操作前请确认已满足以下条件：

• 已完成火山引擎HiAgent账号实名认证，且拥有对应智能体的「规则管理权限」（至少为编辑角色）
• 浏览器版本要求：Chrome 100+ / Edge 100+ / Safari 15+，不支持IE内核浏览器
• 若使用API查询，需提前获取AccessKey，安装HiAgent Python SDK v1.2.0+
• 全流程预计耗时：3-5分钟

[4] 分步实现 #

步骤1：进入目标智能体配置页

步骤说明：首先登录火山引擎官网，进入HiAgent产品控制台，在智能体列表中找到需要查询的目标智能体，点击「配置」按钮进入详情页。这一步是为了确保你在正确的智能体实例下操作，避免误查其他实例的配额。
预期结果：成功进入对应智能体的配置主页面，左侧导航栏可见「规则管理」选项。

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

步骤说明：在配置页顶部导航栏找到「自定义」标签，点击进入自定义规则管理界面，该页面会统一展示当前智能体下所有你有权限查看的自定义规则。跳过这一步会无法区分内置规则和自定义规则，导致统计错误。
预期结果：页面展示已创建的自定义规则列表，列表顶部可见「已使用X条/总配额Y条」的提示。

⚠️ 常见错误：进入规则管理页后直接统计所有规则数量，结果比配额上限多很多。
原因：我们在处理客户工单时发现超过30%的统计错误都是因为默认规则管理页同时展示内置规则和自定义规则，内置规则不计入自定义规则配额。
解决方法：切换到「自定义规则」标签页后再进行统计。

步骤3：读取或计算剩余配额

步骤说明：如果页面顶部直接展示了已用和总配额，直接用总配额减去已用数量即可得到剩余数量；如果未直接展示，可手动统计列表中有效规则的数量（排除已删除的草稿规则），结合账号对应的总配额计算。若需要自动化查询，可调用官方API获取实时数据。
代码示例（API查询）：

from volcengine.hiagent.v20250401 import HiAgentClient

# 初始化客户端
client = HiAgentClient()
client.set_access_key("YOUR_ACCESS_KEY") # 替换为你的AccessKey
client.set_secret_key("YOUR_SECRET_KEY") # 替换为你的SecretKey
client.set_region("cn-beijing")

# 查询自定义规则配额
resp = client.describe_custom_rule_quota({
    "AgentId": "YOUR_AGENT_ID" # 替换为你的智能体ID
})
print(f"总配额：{resp['TotalQuota']}，已使用：{resp['UsedQuota']}，剩余：{resp['RemainingQuota']}")

预期结果：控制台操作可直接得到剩余配额数字；API调用返回HTTP 200状态码，返回体包含RemainingQuota字段即为剩余数量。

⚠️ 常见错误：调用API查询配额时返回403权限不足。
原因：使用的AccessKey对应的子账号没有「配额查询」权限，或智能体ID填写错误。
解决方法：在访问控制IAM中为子账号添加HiAgentFullAccess权限，或单独授予hiagent:DescribeCustomRuleQuota接口权限，核对输入的AgentID是否与控制台一致。

步骤4（可选）：查看全局配额

步骤说明：如果你需要查询整个账号下所有智能体的自定义规则总剩余配额，可进入控制台右上角「资源中心」-「用量统计」板块，筛选「自定义规则」维度即可查看全局配额使用情况。
预期结果：页面展示整个账号下的自定义规则总配额、已用数量、剩余数量。

[5] 实际验证 #

测试用例

输入：登录HiAgent专业版账号，进入ID为agent-123456的智能体配置页，该智能体自定义规则总配额为50条，已创建32条有效自定义规则。
预期输出：剩余自定义规则数量为18条。

验证成功标志

控制台「自定义规则」标签页顶部显示「已使用32条/总配额50条」，或API返回RemainingQuota值为18。

验证失败排查

1. 若显示的已使用数量和你统计的不一致：排查是否包含了已删除的草稿规则，草稿规则不计入已用配额，可在回收站中确认；
2. 若总配额和你购买的不一致：确认是否是子账号查看，子账号默认仅展示当前智能体的配额，如需查看全局配额请使用主账号登录资源中心查看；
3. 若页面未展示配额信息：确认当前账号版本是否为免费版，免费版无自定义规则配额。

[6] 常见问题 FAQ #

1. 问题：HiAgent不同版本的自定义规则配额分别是多少？
   答案：根据火山引擎官方文档数据¹，专业版单智能体默认配额为50条，企业版单智能体默认配额为200条，超出可单独提交工单申请扩容，扩容上限为单智能体1000条。

2. 问题：已删除的自定义规则会占用配额吗？
   答案：已删除并进入回收站的规则不会占用配额，回收站保留7天后自动彻底删除，如需立即释放配额可手动清空回收站。

3. 问题：什么情况下不建议通过手动统计的方式查询剩余数量？
   答案：当你的自定义规则数量超过100条，或需要频繁查询配额用于自动化规则创建时，不建议手动统计，建议直接调用DescribeCustomRuleQuota接口获取实时数据。

4. 问题：我可以跳过自定义规则标签页，直接在全部规则页统计吗？
   答案：不可以，全部规则页包含系统内置规则，内置规则免费且不计入自定义配额，统计时会混入无效数据导致结果错误。

5. 问题：为什么不同智能体的自定义规则配额不一样？
   答案：配额是按智能体单独分配的，如果你给某一个智能体单独申请过扩容，该智能体的配额会高于默认值，全局配额和单智能体配额独立统计。

6. 问题：剩余配额为0时还能创建新的自定义规则吗？
   答案：不能，提交创建请求时会返回400错误码，提示“自定义规则配额不足”，需要删除冗余规则或申请扩容后才能继续创建。

[7] 相关阅读 #

1. 《HiAgent自定义规则开发最佳实践》，[/docs/hiagent/123456/custom-rule-best-practice]，讲解自定义规则的编写规范、性能优化方法和常见问题解决方案。
2. 《HiAgent配额管理接口文档》，[/docs/hiagent/123456/api-describe-custom-rule-quota]，DescribeCustomRuleQuota接口的参数说明、错误码和调用示例。
3. 《HiAgent版本功能对比表》，[/docs/hiagent/123456/version-comparison]，免费版、专业版、企业版的功能差异和配额说明。
4. 《HiAgent子账号权限配置指南》，[/docs/hiagent/123456/iam-permission-config]，如何为子账号分配规则管理、配额查询等细粒度权限。

[8] 参考资料 #

[1] 火山引擎HiAgent官方文档：自定义规则配额说明，https://www.volcengine.com/docs/86760/2534839?lang=zh，2026-08-20
[2] 火伞云：火山引擎HiAgent:5大功能提升企业智能客服效率2025最新版，https://www.huosanyun.com/13240/，2026-08-22
本文基于火山引擎HiAgent V2.1.0版本编写。

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

2026-08-24