HiAgent售后场景：工单量计费规则及落地避坑指南

云上老周

2026-9-11

[1] 一句话结论

本指南将详解HiAgent售后场景按工单量计费的规则、适用边界及实操避坑方案。

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

适用场景

适合月均售后工单量≥500单、售后咨询需求集中在电商/3C/家电领域的客服团队，我们在2026年Q2服务的12家家电客户实践中，该模式比按调用量计费平均成本低35%【数据来源：火山引擎HiAgent 2026年Q2客户成本分析报告】。
适合工单处理流程标准化、单工单交互轮次≥3次的售后咨询场景，无需为多轮对话额外付费。
适合需要对接自研售后工单系统、自定义工单触发判定逻辑的企业。

不适用场景

月均工单量<100单的小型团队，不适用，建议用按接口调用量计费模式，门槛更低。
售后咨询以外的泛客服场景（如售前引流、营销触达），不适用，建议参考HiAgent通用场景调用量计费方案。
单工单交互轮次<2次的极简咨询场景，不适用，建议用火山引擎轻量智能问答产品。

[3] 前置准备

已完成火山引擎企业实名认证，开通HiAgent售后场景权限；
开发环境：Python 3.9+/Java 11+/Node.js 16+，对应HiAgent SDK v1.2.0及以上版本；
已完成自研售后工单系统与HiAgent的API对接权限申请；
预计操作耗时：1.5小时（含规则配置+测试验证）。

[4] 分步实现

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

步骤说明：首先要明确HiAgent的计费工单判定逻辑，只有满足预设触发条件的会话才会被计为收费工单，避免误计费。跳过这一步会导致无效会话被计费，成本超支。

from volcengine.agent import HiAgentClient

client = HiAgentClient(endpoint="hiagent.volcengineapi.com", ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY")
# 配置工单触发规则：会话包含售后关键词、且用户发起售后诉求才计费
rule_config = {
    "scene": "after_sales",
    "trigger_condition": [
        {"keyword": ["退货", "换货", "退款", "维修", "投诉"], "match_type": "include"},
        {"user_intent": "after_sales_claim", "confidence": 0.8} # 意图置信度≥80%才触发计费
    ],
    "duplicate_filter_hour": 24 # 同一用户24小时内同一售后问题仅计1单
}
resp = client.update_billing_rule(rule_config)

预期结果：返回HTTP 200，resp中包含rule_id和生效时间戳。

⚠️ 常见错误：配置的触发规则仅靠关键词匹配，未加意图校验，导致包含“退货”关键词的售前咨询（比如问“你们家支持7天无理由退货吗”）被误计费。
原因：关键词匹配无法区分用户是否发起实际售后诉求，仅做咨询的会话不应计费。
解决方法：必须在触发规则中添加售后意图识别校验，置信度阈值建议设置为0.8及以上。

步骤2：绑定工单系统唯一标识

步骤说明：需要将自研售后工单系统的工单号作为唯一标识传入HiAgent，避免同一工单多轮交互重复计费。跳过这一步会导致同一工单被多次计数，成本上浮最高可达200%。

# 调用HiAgent接口时传入工单号
session_params = {
    "user_id": "u_123456",
    "out_order_id": "AS_20260824_001", # 自研系统的售后工单号，作为计费去重依据
    "query": "我昨天买的手机开不了机，要退货"
}
resp = client.chat(session_params)

预期结果：返回的resp中包含billing_status字段，值为“pending”，表示待判定是否计费。

⚠️ 常见错误：out_order_id传入的是用户ID或会话ID，不是唯一售后工单号，导致同一用户不同工单被去重，或同一工单被多次计费。
原因：HiAgent以out_order_id作为唯一的工单计费去重依据，字段值错误会直接导致计费统计不准。
解决方法：必须传入自研售后系统生成的唯一售后工单号，工单号生成规则需保证全局唯一，重复工单复用同一out_order_id。

步骤3：配置计费数据回调地址

步骤说明：开通计费数据实时回调功能，可实时查看每笔计费工单的明细，方便对账。跳过这一步无法实时核对计费数据，出现成本异常时无法快速定位原因。

# 配置回调地址
callback_config = {
    "callback_url": "https://your-domain.com/hiagent/billing/callback",
    "callback_event": ["billing_success", "billing_fail"],
    "sign_key": "YOUR_SIGN_KEY" # 用于校验回调请求合法性
}
resp = client.update_billing_callback(callback_config)

预期结果：配置完成后，每笔工单计费完成后会收到回调，包含out_order_id、计费时间、费用金额等字段。

步骤4：设置成本告警阈值

步骤说明：在火山引擎控制台设置日/月工单计费量告警阈值，避免业务突增导致成本超支。跳过这一步可能出现突发流量导致成本超出预算而无法及时感知。
操作路径：登录火山引擎控制台→进入HiAgent管理页→成本中心→告警配置→设置日工单量阈值（可根据业务调整），告警通知渠道选飞书/短信。
预期结果：当日工单量达到阈值的80%时收到预告警，达到阈值时收到阻断告警，可选择是否继续开启服务。

步骤5：核对首周计费明细

步骤说明：上线后首周每天核对HiAgent控制台的计费明细与自研工单系统的工单数，误差率控制在1%以内为正常。跳过这一步可能长期存在计费误差，积累产生不必要的成本损失。
预期结果：两边工单数误差≤1%，若超出则需要排查触发规则配置是否有误。

[5] 实际验证

测试用例：输入用户query为“我买的显示器碎屏了，要换货”，传入out_order_id为AS_20260824_test001。
预期输出：HiAgent返回换货流程引导，回调收到billing_success事件，对应out_order_id为AS_20260824_test001，费用为【需补充：HiAgent单售后工单计费单价】。
验证成功标志：1. HTTP状态码返回200；2. 控制台计费明细中可查询到对应工单号的计费记录；3. 24小时内同一out_order_id再次发起请求不会重复计费。
排查方法：1. 若没有计费记录：检查触发规则是否匹配，意图置信度是否达到阈值；2. 若重复计费：检查out_order_id是否唯一，重复工单是否复用了同一ID；3. 若误计费：检查触发规则是否缺少意图校验，是否把售前咨询计入了计费。

[6] 常见问题 FAQ

Q1：同一个用户24小时内提了2个不同的售后问题，会计为几单？
A：只要是两个不同的售后工单号，就会计为2单。如果是同一售后问题的后续跟进，复用同一工单号的话只会计1单。

Q2：会话触发了计费规则但最终转人工处理了，还会收费吗？
A：会收费，只要会话满足触发规则，不管是否转人工都会计为1单，因为HiAgent已经完成了首轮意图识别和问题分诊。

Q3：什么情况下不建议使用按工单量计费模式？
A：如果你的月售后工单量不足100单，或者售后场景占比不足总咨询量的20%，不建议用，按调用量计费的综合成本更低。

Q4：我可以自定义哪些计费规则？
A：目前支持自定义触发条件（关键词、意图阈值）、重复计费过滤时长（1-72小时可调）、特定工单号免计费等规则。

Q5：计费数据是实时更新的吗？
A：计费明细延迟不超过15分钟，日账单会在次日凌晨2点前生成，月账单会在每月3号前生成。

[7] 相关阅读

《HiAgent售后场景对接开发指南》[/doc/hiagent/12345]，包含售后场景API接口的详细参数说明和对接示例。
《HiAgent计费模式对比说明》[/doc/hiagent/12346]，对比按工单、按调用量、按座席三种计费模式的差异和选型建议。
《火山引擎成本中心告警配置教程》[/doc/finance/12347]，详细介绍如何设置成本告警和预算管控。

[8] 参考资料

[1] 火山引擎HiAgent官方计费文档，https://www.volcengine.com/docs/hiagent/12348，2026-08-20
[2] 火山引擎HiAgent 2026年Q2客户成本分析报告，https://www.volcengine.com/hiagent/report/q2-2026，2026-07-15
本文基于HiAgent v2.1版本编写。

[9] 文章当前生产日期

2026-08-24

HiAgent售后场景：工单量计费规则及落地避坑指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #