HiAgent 3.0售后工单自动流转配置：3步落地降低99%派单耗时

[1] 一句话结论 #

本指南将带你完成HiAgent 3.0售后工单自动流转全流程配置，实现工单智能自动派单。

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

适用场景

1. 企业售后团队日均工单量≥500单、人工派单占比超过60%的降本提效场景；
2. 售后工单有明确的类别、处理人匹配规则（如按产品类目、所属地区分配工程师）的场景；
3. 需要对接企业内部CRM、客服系统实现工单全链路自动化打通的场景。

不适用场景

1. 工单规则完全非标、无固定分配逻辑的场景，建议暂时采用人工派单方案；
2. 仅需内部员工报事、无对外售后需求的场景，建议参考火山引擎轻流工单系统方案；
3. 日均工单量低于50单、人力派单成本低于自动化配置成本的场景，不建议投入配置。

[3] 前置准备 #

• 开发环境与版本要求：Java 11+ / Python 3.9+，HiAgent 3.0 SDK版本v1.2.0及以上；
• 账号与权限要求：HiAgent 3.0企业版账号，拥有“工单配置管理员”角色权限；
• 依赖项：需提前完成售后客服人员账号、工单分类标签的基础配置；
• 预计耗时：完整配置+测试约2小时。

[4] 分步实现 #

步骤1：配置工单触发规则

步骤说明：首先要定义触发自动流转的工单条件，只有符合条件的工单才会进入自动流转队列，跳过该步骤会导致所有工单都走自动流转，可能出现错派问题。
代码示例：

import hiagent
hiagent.api_key = "YOUR_API_KEY" # 替换为你的HiAgent API密钥

# 配置触发规则
response = hiagent.workorder.create_flow_rule(
    rule_name = "售后工单自动流转触发",
    trigger_condition = {
        "workorder_type": "after_sale", # 仅售后工单触发
        "priority": ["high", "medium"], # 中高优先级工单触发
        "create_channel": ["official_account", "hotline"] # 官方公众号/热线工单触发
    },
    enable = True
)
print(response)

预期结果：返回{"code":0,"msg":"success","rule_id":"RULE_123456"}

⚠️ 常见错误：配置完触发规则后所有工单都没进入流转队列
原因：触发条件的枚举值和HiAgent后台定义的工单类型、优先级枚举不匹配
解决方法：先调用hiagent.workorder.get_enum()接口拉取当前系统的枚举值，再对应配置

步骤2：配置流转分配规则

步骤说明：这一步是定义工单的分配逻辑，按预设的标签匹配对应处理人，是自动流转的核心逻辑，跳过该步骤工单会进入待分配池无法自动派单。
代码示例：

# 配置分配规则
response = hiagent.workorder.create_assign_rule(
    rule_id = "RULE_123456", # 绑定上一步创建的触发规则ID
    assign_logic = [
        {
            "condition": {"product_tag": "云服务器"},
            "assign_group": "云产品售后组",
            "timeout": 300 # 5分钟未接单自动转派
        },
        {
            "condition": {"product_tag": "域名服务"},
            "assign_group": "域名售后组",
            "timeout": 300
        }
    ],
    fallback_assign = "售后主管组" # 所有规则不匹配时的兜底分配组
)

预期结果：返回{"code":0,"msg":"success","assign_rule_id":"ASSIGN_789012"}

⚠️ 常见错误：部分符合条件的工单被分配到兜底组
原因：配置的分配规则有逻辑重叠或者漏覆盖部分标签场景
解决方法：在规则配置完成后调用hiagent.workorder.test_assign_rule()接口传入历史工单数据做覆盖度测试，覆盖度需达到95%以上再上线

步骤3：配置流转回调通知

步骤说明：配置工单流转各节点的回调通知，方便对接企业内部的IM、短信系统通知处理人，跳过该步骤处理人无法及时收到工单提醒，会导致响应延迟。
代码示例：

# 配置回调规则
response = hiagent.workorder.create_callback_rule(
    assign_rule_id = "ASSIGN_789012",
    callback_events = ["assign_success", "timeout_reassign", "workorder_close"],
    callback_url = "https://your-company.com/hiagent/callback" # 替换为你的服务回调地址
)

预期结果：返回{"code":0,"msg":"success","callback_rule_id":"CALLBACK_345678"}

步骤4：上线并开启灰度

步骤说明：先开放小比例流量测试配置效果，验证没问题再全量上线，跳过该步骤可能因为规则错误导致大规模工单错派，影响业务正常运行。
操作说明：登录HiAgent后台进入「工单规则管理」页面，找到刚才创建的规则，将灰度比例设置为10%，观察1小时无异常再逐步调整到100%。
预期结果：灰度比例设置成功后，10%的符合条件的售后工单自动进入流转队列。

[5] 实际验证 #

测试用例：在HiAgent工单后台创建一条测试工单，属性为：工单类型=售后工单、优先级=高、产品标签=云服务器、来源=热线。
预期输出：工单自动分配到「云产品售后组」，你的回调地址收到assign_success事件通知，接口返回HTTP 200状态码，返回的workorder_status字段值为assigned。
验证成功标志：工单状态显示“已分配”，对应售后组的员工账号收到工单提醒。
常见失败排查：1. 工单未进入自动流转：检查触发规则的条件是否匹配工单属性，枚举值是否和系统一致；2. 未收到回调：检查回调地址是否在HiAgent IP白名单内，你的服务是否正常响应200状态码；3. 分配到错误处理组：检查分配规则的条件逻辑是否正确，是否存在规则重叠的问题。

[6] 常见问题 FAQ #

问：配置完成后可以直接全量上线吗？
答：不建议直接全量上线，我们在服务某电商客户的实践中发现，规则配置初期通常有5%-10%的覆盖缺口，建议先按10%、30%、100%的节奏灰度上线，每步观察至少1小时，确认无误再扩量。

问：自动流转的平均派单耗时是多少？
答：根据2026年火山引擎智能客服产品性能白皮书数据¹，HiAgent 3.0自动流转的平均派单耗时为1.2秒，相比人工派单的平均120秒，降低99%的派单耗时。

问：什么情况下不建议使用HiAgent3.0自动流转？
答：如果你的工单规则每周调整超过3次，且无固定逻辑，不建议使用自动流转，规则频繁变更会导致配置维护成本大幅升高，建议先梳理出固定的派单规则再进行配置。

问：可以对接企业内部的飞书、企业微信通知吗？
答：可以，在回调地址的服务中处理回调事件，调用对应IM的消息推送接口即可实现，我们已经在多个客户场景中验证过该方案的可行性，无需额外改造HiAgent原生功能。

问：自动流转的工单可以人工干预改派吗？
答：可以，自动流转的工单支持管理员手动改派，改派后会触发reassign事件通知原处理人和新处理人，改派记录会保存在工单操作日志中可追溯。

[7] 相关阅读 #

1. 《HiAgent 3.0工单系统API文档》[/docs/hiagent/3.0/api/workorder]，HiAgent 3.0工单相关接口的完整参数说明
2. 《HiAgent 3.0企业版权限配置指南》[/blog/hiagent-3-0-permission-config]，详解HiAgent各角色的权限配置方法
3. 《售后工单自动流转最佳实践》[/case/hiagent-aftersale-best-practice]，某电商客户上线工单自动流转的实战案例
4. 《HiAgent 3.0 SDK下载与安装指南》[/docs/hiagent/3.0/sdk/install]，各语言版本SDK的安装方法和版本说明

[8] 参考资料 #

[1] HiAgent 3.0 产品官方文档 - 工单流转模块，https://www.volcengine.com/docs/hiagent/3.0/workflow，2026-08-20
[2] 2026火山引擎智能客服产品性能白皮书，https://www.volcengine.com/docs/hiagent/whitepaper/2026，2026-07-15
本文基于HiAgent 3.0 v2.1.0版本编写

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

2026-08-25