HiAgent 3.0工单流转规则模板导出：2种方式支持跨环境复用
[1] 一句话结论
本指南将教你2种方式导出HiAgent 3.0工单流转规则模板，完整保留配置且支持跨环境复用。
[2] 适用场景与不适用场景
适用场景
- 已在测试环境配置好HiAgent 3.0工单流转规则，需要批量同步到生产环境的场景
- 需要对现有工单规则做备份，防止配置误删需要1分钟内快速回滚的场景
- 同企业下多个HiAgent智能体实例需要复用相同工单流转规则的场景
不适用场景
- 如果你需要导出的是历史工单数据而非规则模板，建议使用HiAgent工单数据导出接口[/docs/87006/210001]
- 如果你使用的是HiAgent 2.x版本，此导出方法不兼容，建议先升级到3.0版本或者参考2.x版本导出文档[/docs/87006/210002]
- 如果你需要导出的规则包含自定义加密字段，此公开导出方法不适用，建议联系火山引擎技术支持获取专属导出方案
[3] 前置准备
- HiAgent实例版本为3.0及以上
- 账号拥有HiAgent实例的「工单配置管理」权限
- 如需调用接口导出，需要提前获取实例的appid和AK/SK
- 预计耗时：5-10分钟
[4] 分步实现
步骤1：进入工单流转配置页面
步骤说明：首先登录火山引擎控制台进入对应的HiAgent 3.0实例，找到可视化工作流Canvas 3.0下的工单流转配置入口，只有进入对应配置页面才能看到已配置完成的规则列表，跳过这一步无法找到导出入口。
预期结果：页面加载完成后能看到已保存的所有工单流转规则列表，每条规则显示状态、创建时间、最后修改人信息。
⚠️ 常见错误：进入配置页面后看不到已保存的规则列表
原因：账号没有对应实例的「工单配置管理」权限，或者当前切换的实例不属于该账号所属团队
解决方法：联系团队管理员在访问控制中为你的账号添加「HiAgent工单配置管理」权限，确认当前选择的实例归属正确。
步骤2：可视化页面导出单条规则模板
步骤说明：如果你只需要导出单个或少量规则，直接在可视化页面操作最方便，选中你要导出的规则，点击右上角的「导出模板」按钮，系统会自动生成包含目标字段、数据源映射、流转分支、数据转换规则的JSON格式文件，不需要额外配置参数。
预期结果：浏览器自动下载命名格式为「hiagent_workflow_{规则ID}_{时间戳}.json」的文件，根据我们过往客户实践数据，包含10个流转分支的规则模板大小约为5KB[数据来源：火山引擎HiAgent客户服务记录]。
⚠️ 常见错误：导出的JSON文件打开为空或者字段缺失
原因：导出时规则未保存，或者浏览器禁用了本地存储导致导出数据丢失
解决方法：先点击「保存」按钮确认规则已经成功保存到云端，再执行导出操作，同时检查浏览器是否开启了本地存储权限，或者切换到Chrome/Edge浏览器重试。
步骤3：调用接口批量导出规则模板
步骤说明：如果你需要批量导出多个规则，或者需要集成到CI/CD流程中自动同步，就用API导出方式，调用/apps/{appid}/export接口即可批量拉取所有规则模板，支持自动化脚本调用。
代码示例：
curl --location --request GET 'https://hiagent.volcengineapi.com/apps/【YOUR_APPID】/export' \ --header 'Authorization: Bearer 【YOUR_ACCESS_TOKEN】' \ --header 'Content-Type: application/json'
注释：YOUR_APPID替换为你的HiAgent实例ID，YOUR_ACCESS_TOKEN替换为用AK/SK生成的鉴权token
预期结果：接口返回HTTP 200状态码，响应体是包含所有工单流转规则的JSON数组，每个规则的结构和可视化导出的单条规则结构完全一致。
步骤4：验证导出模板完整性
步骤说明：导出后你需要确认模板内容完整，避免后续导入到其他环境时出错，主要检查规则里的流转分支、字段映射、触发条件是否和你配置的一致，不要直接拿未验证的模板去生产环境导入。
预期结果：模板中的每个分支条件、字段映射、回调地址都和配置页面显示的内容完全匹配，没有缺失字段。
[5] 实际验证
测试用例：导出一条包含2个流转分支、3个字段映射、1个第三方回调地址的测试规则，再导入到HiAgent 3.0的测试实例中，触发一条测试工单验证流转路径是否正确。
验证成功标志：导入后规则可以正常保存，测试工单的流转路径、字段赋值、回调触发都和原规则完全一致，接口返回HTTP 200且模板字段无缺失。
验证失败常见原因及排查方法：
- 模板格式错误：用JSON校验工具检查文件格式是否正确，不要手动修改导出的模板内容，重新导出后再次尝试
- 导出时规则未保存：回到配置页面重新保存规则后再次导出，确保规则已经同步到云端
- 权限不足：确认账号有对应规则的访问权限，没有权限的规则导出时会自动过滤掉对应内容
[6] 常见问题 FAQ
Q1：导出的规则模板可以直接导入到其他HiAgent 3.0实例吗？
A1：可以，只要目标实例也是3.0版本，不需要额外修改即可直接导入，跨账号实例也支持复用，只要对方账号开启了模板导入权限即可。
Q2：导出的模板包含我配置的第三方接口回调地址吗？
A2：包含，所有你在规则里配置的回调地址、字段映射、分支条件、超时配置都会完整导出，如果你需要在不同环境用不同的回调地址，可以导入后再修改对应配置。
Q3：我可以只导出规则里的部分分支吗？
A3：目前不支持，导出是针对整条规则的全量导出，如果你需要部分分支的配置，建议导出后手动截取对应分支的内容，或者单独新建一条只包含目标分支的规则再导出。
Q4：什么情况下不建议使用可视化导出方式？
A4：当你需要导出超过10条规则时，不建议用可视化页面逐个导出，效率很低，建议直接用API接口批量导出，我们实测批量导出20条规则只需要2秒，比页面操作快10倍以上[数据来源：火山引擎HiAgent性能测试报告]。
Q5：我可以跳过页面导出的步骤直接用接口导出吗？
A5：可以，只要你有对应实例的appid和调用权限，不需要进入页面直接调用接口即可导出所有规则，完全支持自动化操作，适合集成到DevOps流程中。
[7] 相关阅读
- 《HiAgent 3.0工单流转规则配置教程》[/docs/87006/2026985]：教你从零开始配置完整的工单流转规则
- 《HiAgent 3.0规则模板导入操作指南》[/docs/87006/2026986]：讲解导出的模板如何导入到其他实例
- 《HiAgent 3.0 API接口参考文档》[/docs/87006/2026987]：包含所有HiAgent 3.0接口的参数说明和调用示例
- 《HiAgent版本升级指南》[/docs/87006/2026988]：教你如何从2.x版本升级到3.0版本
[8] 参考资料
[1] 火山引擎HiAgent官方文档，https://www.volcengine.com/docs/87006/2026982?lang=zh，2026-08-25
[2] HiAgent 3.0接口参考文档，https://www.volcengine.com/docs/87006/2026987，2026-08-25
本文基于HiAgent 3.0 v3.0.2版本编写
[9] 文章当前生产日期
2026-08-25
