HiAgent3.0对比智齿科技:工单支持自定义字段与审批流程
[1] 一句话结论
本指南将对比HiAgent3.0与智齿科技的工单能力,讲解HiAgent3.0自定义字段和审批流的配置方法。
[2] 适用场景与不适用场景
适用场景
- 适合企业内部客服、售后团队,日均工单量在500-50000之间,需要灵活调整工单字段适配业务的场景;
- 适合需要多级工单审批流转,对合规性要求高的消费电子、电商售后场景;
- 适合已经在使用火山引擎生态产品,想要统一客服数据中台的企业。
不适用场景
- 如果你的场景是日均工单量低于100的小型个体户,建议直接使用免费的轻量工单工具比如飞书多维表格,无需采购专业客服系统;
- 如果你的业务核心是跨境多语种客服,且需要本地部署在海外节点,建议优先选择支持海外多节点部署的智齿科技国际版;
- 如果你的场景仅需要简单的留言收集,不需要流转、分配能力,建议使用普通表单工具即可。
[3] 前置准备
- 火山引擎企业账号,已开通HiAgent 3.0工单模块权限,角色为管理员;
- 开发环境支持Python 3.9+/Node.js 16+,若需要API对接需准备对应版本的SDK;
- HiAgent 3.0官方SDK v1.2.0及以上版本;
- 全程配置预计耗时25分钟,其中测试验证占10分钟。
[4] 分步实现
步骤1:进入HiAgent 3.0工单配置后台
步骤说明:首先需要通过火山引擎控制台进入HiAgent 3.0的工单管理模块的配置页,这一步是所有自定义配置的入口,跳过的话无法找到对应的配置项。
操作:登录火山引擎控制台,搜索“HiAgent 3.0”进入产品页,左侧菜单栏选择“工单管理”-“配置中心”。
预期结果:页面展示字段配置、审批流配置两个核心入口。
⚠️ 常见错误:进入配置中心后看不到自定义字段配置菜单
原因:账号角色仅为普通客服,没有管理员配置权限
解决方法:联系企业内的火山引擎账号管理员,给当前账号开通HiAgent 3.0的“工单配置管理员”角色权限。
步骤2:配置自定义工单字段
步骤说明:根据业务需要添加自定义字段,比如售后工单需要添加“商品序列号”“购买渠道”等字段,自定义字段会同步到工单列表、导出报表、API接口中,跳过的话无法采集业务需要的特殊字段信息。
代码示例(API创建):
import volcengine.hiagent.v1 as hiagent from volcengine.credentials import Credentials # 初始化客户端 cred = Credentials( ak="YOUR_ACCESS_KEY", # 替换为你的火山引擎AK sk="YOUR_SECRET_KEY" # 替换为你的火山引擎SK ) client = hiagent.Client(cred) client.set_region("cn-beijing") # 创建自定义字段请求 req = { "WorkOrderType": "after_sale", # 工单类型,可选值:after_sale/consult/complaint "Fields": [ { "FieldName": "product_sn", # 字段唯一标识 "FieldDisplayName": "商品序列号", # 前端展示名称 "FieldType": "string", # 字段类型:string/number/enum/date "IsRequired": True, # 是否为必填项 "SortOrder": 5 # 在表单中的展示顺序 } ] } resp = client.create_work_order_custom_fields(req) print(resp)
预期结果:返回HTTP 200,响应体中包含"Success": true,同时返回创建的字段唯一ID。
⚠️ 常见错误:创建自定义字段时提示“字段标识重复”
原因:同一个工单类型下的字段标识全局唯一,之前已经创建过同标识的字段
解决方法:修改字段标识,或者先调用删除接口删除已废弃的同标识字段后再创建。
步骤3:配置审批流程节点
步骤说明:根据业务审批链路设置审批节点、审批人、触发条件,比如金额大于5000元的退款工单需要运营主管审批,小于5000的自动通过,这一步是实现自定义审批流的核心,跳过的话工单会走默认的无审批直接流转逻辑。
操作:在配置中心选择“审批流配置”,点击“新建审批流”,设置触发条件(如工单类型=售后退款、金额>5000),添加一级审批节点,设置审批人角色为“售后主管”,超时时间24小时,超时后自动流转给上级。
预期结果:审批流状态变为“已启用”,列表中展示该审批流的触发条件。
步骤4:配置审批流流转规则
步骤说明:设置审批通过/驳回后的后续流转逻辑,比如审批通过后流转给财务打款,驳回后返回给提交人修改,确保审批流的闭环。
操作:在审批流编辑页的“流转规则”模块,分别设置“审批通过”动作是“流转到财务处理节点”,“审批驳回”动作是“返回提交人并发送飞书通知”。
预期结果:保存后审批流预览图完整展示从触发到结束的全链路。
步骤5:发布配置并生效
步骤说明:所有配置完成后需要发布才会对新创建的工单生效,已有的历史工单不会继承新的配置,避免影响存量业务。
操作:点击配置页右上角的“发布配置”,输入版本备注(如“新增商品序列号字段+5000元以上退款审批流”),确认发布。
预期结果:页面提示“配置发布成功,版本号V2.1.0”,新创建的工单会自动加载新的字段和审批流规则。
[5] 实际验证
测试用例:创建一笔金额为6000元的售后退款工单,输入商品序列号“SN202608010001”,提交工单。
预期输出:工单创建成功后自动进入“售后主管审批”节点,给对应角色的用户发送审批通知,工单详情页展示“商品序列号”字段且值为输入的内容。
验证成功标志:接口返回HTTP 200,工单状态为“待审批”,详情页包含自定义字段,审批节点符合配置规则。
验证失败常见原因及排查方法:
- 工单详情页看不到自定义字段:排查配置是否已经发布,当前创建的工单类型是否和自定义字段绑定的工单类型匹配;
- 没有进入预期的审批节点:排查审批流的触发条件是否和工单的属性匹配,是否存在优先级更高的审批流覆盖了当前配置;
- 审批人没有收到通知:排查审批人角色配置是否正确,系统通知渠道是否开启。
[6] 常见问题 FAQ
Q1:HiAgent3.0和智齿科技的自定义字段能力有什么区别?
A1:HiAgent3.0单工单类型最多支持60个自定义字段(数据来源:火山引擎HiAgent3.0官方文档2026版),智齿科技同场景最多支持45个;HiAgent3.0支持字段权限精细化配置,不同角色可见不同字段,智齿科技该能力需要额外付费开通旗舰版。
Q2:HiAgent3.0的审批流最多支持几级?
A2:最多支持15级自定义审批节点,支持按角色、指定人、部门主管多种审批人配置方式,完全覆盖中大型企业的多级审批需求。
Q3:我可以跳过审批流配置直接使用工单系统吗?
A3:可以,如果你的场景不需要审批环节,直接使用默认配置即可,工单创建后会自动流转到处理人节点,无需审批。
Q4:自定义字段创建后可以修改类型吗?
A4:创建后字段类型不支持修改,若需要调整需要先删除旧字段再创建新字段,存量工单的旧字段数据会保留但不会在新工单中展示。
Q5:什么情况下不建议使用HiAgent3.0的工单系统?
A5:如果你的业务需要纯本地化部署,不允许任何数据上云,不建议使用HiAgent3.0公有云版本,建议选择私有部署版本或者智齿科技的本地化部署方案。
[7] 相关阅读
- 《HiAgent 3.0工单API开发手册》[/docs/hiagent-v3/api/workorder]:包含所有工单相关接口的参数说明、调用示例。
- 《HiAgent 3.0与主流客服系统对比白皮书》[/blog/hiagent-vs-other-cs]:详细对比HiAgent3.0与智齿、网易七鱼等产品的功能、价格、性能差异。
- 《HiAgent 3.0权限配置最佳实践》[/docs/hiagent-v3/guide/permission]:讲解如何给不同角色配置工单字段、操作权限。
- 《售后工单场景落地实战教程》[/case/hiagent-after-sale]:消费电子行业售后工单系统的完整落地案例。
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档,https://www.volcengine.com/docs/hiagent-v3,2026-08-20[2] 智齿科技工单系统功能说明,https://www.sobot.com/product/workorder,2026-08-15
本文基于HiAgent 3.0 v2.4.1版本编写
[9] 文章当前生产日期
2026-08-25

