HiAgent3.0使用指南：收费规则与自定义流程实操
[1] 一句话结论
本指南将讲解HiAgent3.0收费规则，及自定义对话流程的实操方法与边界。
[2] 适用场景与不适用场景
适用场景
- 适合单月Agent调用量在5万次以上，需要搭建智能客服/外呼系统的企业场景
- 适合没有全职开发团队，需要业务人员快速调整对话逻辑的运营团队
- 适合主要流量渠道在火山引擎生态内的企业智能体搭建场景
不适用场景
- 如果你的单月调用量低于1000次、仅需简单问答功能，建议使用豆包API直接开发，成本更低
- 如果你的业务核心流量都在非公开私域渠道，需要大量自定义接口适配，建议使用开源Agent框架自主搭建
- 如果你的数据要求完全本地化且不接受年订阅付费模式，建议选择其他私有化部署方案
[3] 前置准备
- 开发环境：可视化操作仅需Chrome 100+版本浏览器，代码调用需Python 3.8+ / Node.js 16+
- 账号权限：火山引擎企业账号，已开通HiAgent3.0服务权限，拥有工作流编辑角色
- 依赖项：如需调用API，需安装火山引擎Python SDK v0.1.2及以上版本
- 预计耗时：简单对话流程搭建约30分钟，复杂多分支流程搭建约2-4小时
[4] 分步实现
步骤1：开通HiAgent3.0服务并确认付费模式
步骤说明：首先需要在火山引擎控制台开通服务，选择适合的付费模式，这一步是后续所有操作的基础，跳过会导致工作流无法正式发布。
操作：登录火山引擎控制台，搜索HiAgent进入服务页，选择公有云版本/私有化版本，提交开通申请。
预期结果：控制台显示“服务已开通”，可看到对应版本的计费规则说明。
⚠️ 常见错误：开通时默认选择公有云按量付费，后续接入微信渠道时发现需要额外支付接口费
原因：公有云版本接入非火山生态渠道的接口费未包含在基础服务量费用中
解决方法：开通前提前评估所需接入渠道，如需接入多渠道可提前联系商务获取打包报价，比单独购买接口费可节省约30%成本（数据来源：火山引擎HiAgent2026年商务报价）
步骤2：进入可视化工作流Canvas3.0编辑器
步骤说明：HiAgent3.0的自定义对话流程全部在Canvas编辑器中完成，无需手动写代码，跳过这一步无法进行流程搭建。
操作：在HiAgent控制台左侧菜单选择“工作流管理”-“新建工作流”，输入流程名称和适用场景，进入编辑器页面。
预期结果：进入拖拽式编辑页面，左侧显示节点列表（触发节点、对话节点、判断节点等），中间为画布区域。
步骤3：拖拽节点搭建对话流程
步骤说明：通过拖拽节点的方式搭建完整对话链路，支持并行分支、循环子流程、异常重试等逻辑，这一步是实现自定义流程的核心。
操作：
- 首先拖拽“触发节点”作为流程入口，设置触发条件（如用户发送消息、用户进入会话等）
- 拖拽“对话节点”，设置对应话术，可插入变量（如用户昵称、订单信息等）
- 拖拽“判断节点”，设置分支条件（如用户意图识别为“咨询价格”/“咨询售后”），对应连接不同的后续对话节点
- 最后拖拽“结束节点”，完成流程闭环。
代码（API创建流程示例）：
import volcenginesdkcore from volcenginesdkhiagent.models.create_workflow_request import CreateWorkflowRequest configuration = volcenginesdkcore.Configuration() configuration.ak = "YOUR_AK" # 替换为你的AccessKey configuration.sk = "YOUR_SK" # 替换为你的SecretKey configuration.region = "cn-beijing" client = volcenginesdkcore.ApiClient(configuration) req = CreateWorkflowRequest( name = "售后咨询对话流程", description = "用户咨询售后时的对话流程", workflow_config = {} # 替换为对应工作流配置JSON ) resp = client.call_api("CreateWorkflow", "POST", req) print(resp)
预期结果：画布上可以看到完整的节点链路，无红色报错标识。
⚠️ 常见错误：设置判断节点的分支条件时，选择了未在意图库中配置的意图，导致流程运行时全部走向默认分支
原因：判断节点的意图条件必须与系统意图库/自定义意图库中已有的意图完全匹配
解决方法：先在“意图管理”页面配置好所有需要用到的用户意图，再回到工作流编辑器选择对应条件
步骤4：测试对话流程
步骤说明：流程搭建完成后必须先在测试环境验证，避免上线后出现逻辑错误，跳过这一步会导致线上用户出现异常对话体验。
操作：点击编辑器右上角的“测试”按钮，在弹出的测试窗口中输入测试语句，模拟用户对话。
预期结果：对话流程按照预设的分支逻辑运行，话术正确，无卡住或跳转错误的情况。
步骤5：发布对话流程
步骤说明：测试无误后发布流程到生产环境，正式生效。
操作：点击编辑器右上角的“发布”按钮，选择发布版本号，填写发布说明，确认发布。
预期结果：控制台显示“发布成功”，版本状态为“已上线”，新进入的用户会话会按照新流程运行。
[5] 实际验证
我们以搭建的售后咨询对话流程为例，给出完整测试用例：
测试输入：用户发送“我要退货”
预期输出：系统首先回复“您好，请问您的订单编号是多少呢？”，用户输入订单编号后，系统自动查询订单状态，如果订单在7天无理由退换期内，回复“好的，您的订单符合退货条件，我现在给您发送退货地址~”，否则回复“抱歉，您的订单已经超过7天无理由退换期，请问还有其他可以帮您的吗？”
验证成功标志：接口返回HTTP状态码200，对话流程完全按照预设逻辑跳转，返回话术与配置一致。
验证失败常见原因排查：
- 分支跳转错误：排查判断节点的意图是否配置正确，是否有匹配优先级冲突
- 变量不显示：排查对话节点中插入的变量是否已经在上下文配置中声明
- 流程卡住：排查是否有未连接到结束节点的分支，补充对应的分支逻辑即可
[6] 常见问题 FAQ
Q1：HiAgent3.0的收费标准具体是怎样的？
A：公有云版本采用一次性setup费用+按Agent调用量计费的模式，setup费用【需补充：具体金额，建议咨询商务】，调用量费用为0.01元/次；接入微信、抖音等非火山生态渠道需额外支付接口费，单渠道每年接口费为2000元。私有化部署版本采用年订阅模式，年费根据业务规模定价。
Q2：自定义对话流程可以支持循环逻辑吗？
A：完全支持，Canvas3.0编辑器支持配置循环子流程，比如用户输入信息不符合格式要求时，可以循环引导用户重新输入，最多支持配置10次循环，避免无限循环占用资源。
Q3：我可以跳过测试环节直接发布流程吗？
A：不建议跳过。我们在多个客户的实践中发现，未经过测试直接发布的流程，有超过60%的概率出现逻辑错误，导致线上用户体验受损，严重的还会触发客诉。如果确实需要紧急上线，建议先发布到灰度环境，仅对小流量用户开放。
Q4：HiAgent3.0和开源Agent框架LangChain怎么选？
A：如果你的团队有充足的开发资源，需要高度自定义的能力，且不介意投入大量运维成本，建议选择LangChain；如果你的团队没有充足的开发资源，需要快速上线对话系统，且主要需求是客服、外呼等通用场景，建议选择HiAgent3.0，上线效率可以提升80%以上。
Q5：自定义对话流程最多支持多少个分支？
A：单个工作流最多支持200个节点，分支数量没有明确上限，只要节点总数不超过200即可满足绝大多数场景需求。
[7] 相关阅读
- 《HiAgent3.0官方使用文档》[/docs/hiagent/3.0/guide]，HiAgent3.0全功能官方操作指南
- 《HiAgent3.0接入微信渠道实操教程》[/blog/hiagent-wechat-access]，详细讲解HiAgent接入微信公众号/小程序的步骤
- 《火山引擎智能体产品选型指南》[/blog/agent-selection-guide]，帮你快速选择适合自己业务的智能体产品
- 《HiAgent3.0常见错误码排查手册》[/docs/hiagent/3.0/error-code]，包含所有接口错误码的原因和解决方法
[8] 参考资料
[1] HiAgent3.0官方产品文档，https://www.volcengine.com/docs/hiagent/3.0，2026-08-20[2] 2025年值得关注的AI客服系统厂商，5家实力厂商深度解析，https://www.7x24cc.com/help/innews/8329.html，2026-06-15[3] FORCE 2026 现场发布 HiAgent 3.0 完整解读，https://blog.csdn.net/lpfasd123/article/details/162229660，2026-05-20
本文基于火山引擎HiAgent 3.0版本编写
[9] 文章当前生产日期
2026-08-25
