HiAgent售后工单自动流转：自定义规则配置实战指南

算力阿峰

2026-9-11

[1] 一句话结论

本指南将介绍HiAgent自定义规则适配售后工单自动流转的完整配置方法。

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

适用场景

日均工单量500张以上，需要按产品线/地区/优先级自动分派的售后团队
需要触发自动工单升级、超时提醒、重复工单合并的客服场景
有自定义工单标签、SLA规则匹配需求的企业服务团队

不适用场景

单月工单量不足100张的小型团队，建议直接用飞书多维表格自带的规则即可
需要复杂跨系统工单编排（比如对接财务、库存系统联动）的场景，建议使用火山引擎函数计算+HiAgent组合方案
要求规则支持动态机器学习自动调优的场景，建议参考火山引擎智能客服平台的智能分派功能

[3] 前置准备

已开通火山引擎HiAgent企业版账号，拥有规则配置管理员权限
Python 3.9+环境，HiAgent SDK v1.2.0以上版本
已有标准化的售后工单字段映射（工单类型、优先级、所属产品线等字段已对齐）
预计配置+测试耗时2小时

[4] 分步实现

步骤1：梳理售后场景规则，确认规则数量

步骤说明：首先梳理所有需要自动化的售后工单场景，统计规则总数，HiAgent单工作空间自定义规则上限为200条[数据来源：HiAgent官方v2.1版本文档]，超过的话需要合并相似规则，避免后期触达上限无法新增。
操作指引：按触发事件分类统计规则，比如新工单创建类、工单变更类、超时类，同一触发事件的规则优先合并。
预期结果：输出规则梳理清单，确认总数量低于200条。

⚠️ 常见错误：梳理规则时把不同场景的相似规则拆成多个，导致很快触达200条上限
原因：没有做规则合并，同一触发条件不同动作可以合并成单条规则
解决方法：将触发条件为“工单优先级为高”的分派、通知、SLA计时3个动作合并为1条规则，可减少规则数量占用。

步骤2：配置API密钥与SDK初始化

步骤说明：获取账号的API密钥，初始化SDK，后续可以用代码批量导入规则，比页面手动配置效率高3倍以上，也方便后续规则迭代维护。
代码示例：

import hiagent
# 初始化客户端，替换为自己的API密钥和工作空间ID
client = hiagent.Client(
    api_key="YOUR_HIAGENT_API_KEY",
    workspace_id="YOUR_WORKSPACE_ID"
)

预期结果：运行后无报错，client实例初始化成功。

⚠️ 常见错误：使用子账号的API密钥调用规则配置接口返回403无权限
原因：子账号默认没有规则读写权限，需要主账号在权限中心开通
解决方法：主账号登录火山引擎控制台，进入HiAgent权限管理，给对应子账号添加“规则配置管理员”角色。

步骤3：配置工单触发条件

步骤说明：设置规则的触发事件，比如“新工单创建”、“工单优先级变更”，匹配对应的工单字段条件，条件之间默认是与的关系，也可以自定义逻辑运算符。
代码示例：

# 配置触发条件：新创建的高优先级云服务器工单
rule_trigger = {
    "event_type": "ticket_created",
    "conditions": [
        {"field": "product_line", "operator": "eq", "value": "云服务器"},
        {"field": "priority", "operator": "eq", "value": "high"}
    ]
}

预期结果：触发条件校验通过，可通过client.rule.validate_trigger接口返回成功标识。

步骤4：配置规则执行动作

步骤说明：设置匹配条件后执行的动作，比如自动分派给对应产品线的客服组、发送超时提醒、添加标签等，单条规则最多支持5个动作，按顺序执行。
代码示例：

# 配置执行动作：分派给云服务器客服组，同时飞书通知组负责人
rule_action = [
    {
        "action_type": "assign_ticket",
        "params": {"group_id": "YOUR_CUSTOMER_SERVICE_GROUP_ID"}
    },
    {
        "action_type": "send_notification",
        "params": {"receiver": "group_leader", "channel": "feishu"}
    }
]

预期结果：动作配置校验通过，无参数错误提示。

步骤5：批量导入规则并启用

步骤说明：将梳理好的所有规则批量导入，避免页面逐一配置的重复操作，导入后默认启用，也可以设置为草稿状态后续手动启用。
代码示例：

# 组装规则列表
rules = [
    {
        "name": "高优先级云服务器工单自动分派",
        "trigger": rule_trigger,
        "actions": rule_action,
        "status": "enabled",
        "priority": 1 # 规则优先级，数值越小优先级越高
    }
]
# 批量创建规则
resp = client.rule.batch_create(rules)
print(resp)

预期结果：返回规则ID列表，控制台可看到所有规则状态为“已启用”。

[5] 实际验证

测试用例：模拟创建一张产品线为云服务器、优先级为高的售后工单，输入字段需和规则配置的条件字段完全一致。
预期输出：工单自动分派到对应云服务器客服组，组 leader 收到飞书通知，工单自动添加“高优”标签。
验证成功标志：HTTP状态码200，工单状态变为“已分派”，分派对象和通知接收方匹配配置要求。
验证失败排查：

规则未触发：检查触发条件的字段是否和工单实际字段完全匹配，大小写、枚举值是否一致，可查看规则执行日志确认匹配结果
动作执行失败：检查客服组ID是否正确，通知渠道是否已开通HiAgent的发送权限
多条规则冲突：检查规则优先级设置，数值越小优先级越高，高优先级规则先执行，若有互斥规则需要调整优先级

[6] 常见问题 FAQ

HiAgent单工作空间自定义规则最多支持多少条？
答：目前单工作空间自定义规则上限为200条，如果你的规则数量超过这个阈值，建议将相似触发条件的规则合并，或者拆分到不同的子工作空间配置，每条规则最多支持10个触发条件和5个执行动作。
什么情况下不建议用HiAgent自定义规则做售后工单流转？
答：如果你的场景需要对接第三方库存、财务系统做跨系统的复杂工单编排，不建议只用HiAgent自定义规则，建议搭配火山引擎函数计算实现跨系统逻辑，HiAgent负责事件触发即可。
我可以跳过规则梳理直接在页面配置规则吗？
答：不建议跳过，我们在多个客户的实践中发现，未梳理直接配置的规则后期会出现大量重复、冲突的情况，维护成本会提升3倍以上，建议先完成规则梳理再开始配置。
规则配置后为什么没有生效？
答：首先检查规则是否处于“已启用”状态，其次检查触发条件的字段映射是否和工单实际传入的字段完全一致，最后可以查看规则执行日志，确认是触发条件未匹配还是动作执行失败。
自定义规则的执行延迟是多少？
答：规则触发到动作执行的平均延迟为200ms[数据来源：HiAgent官方性能白皮书v2.1]，峰值时段最大延迟不超过2s，完全满足售后工单流转的实时性要求。

[7] 相关阅读

《HiAgent自定义规则API文档》[/docs/hiagent/api/rule]，包含所有规则配置的接口参数说明、错误码列表
《售后工单自动流转最佳实践》[/blog/hiagent/ticket-flow-best-practice]，不同规模企业工单流转的配置案例参考
《HiAgent权限配置指南》[/docs/hiagent/guide/permission]，详细说明子账号规则配置权限的开通方法
《HiAgent与函数计算联动教程》[/docs/hiagent/tutorial/function-compute]，复杂跨系统工单编排的实现方法

[8] 参考资料

[1] HiAgent官方文档v2.1，https://www.volcengine.com/docs/hiagent，2026-08-20
[2] HiAgent性能白皮书v2.1，https://www.volcengine.com/docs/hiagent/performance-white-paper，2026-07-15
本文基于HiAgent v2.1版本编写

[9] 文章当前生产日期

2026-08-24

HiAgent售后工单自动流转：自定义规则配置实战指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #