HiAgent3.0自定义对话流程配置：对比网易七鱼实操指南

[1] 一句话结论 #

本指南将带你完成HiAgent3.0自定义对话流程配置，并对比与网易七鱼的配置差异与选型建议。

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

适用场景

1. 适合需要自主对接内部业务系统、日均对话量5万次以上的企业智能客服场景，我们在某零售客户实践中确认该场景下成本比网易七鱼低32%（数据来源：火山引擎2026年智能客服客户ROI报告）；
2. 适合需要多模态（文本/语音/视频）统一对话流程配置的泛互娱乐客服场景；
3. 适合需要和火山引擎其他云产品（如语音识别、大模型推理）深度联动的运维助手场景。

不适用场景

1. 仅需要标准化电商客服流程、无自研开发能力的中小商家，建议直接使用网易七鱼现成模板；
2. 仅需要单渠道微信公众号客服、没有多渠道联动需求的个体商户，建议参考火山引擎智能外呼轻量化版本；
3. 预算低于5000元/月的小型团队，建议使用免费版轻量客服工具。

[3] 前置准备 #

• 开发环境：Python 3.9+ 或 Node.js 18+，HiAgent SDK版本v3.0.2；
• 账号权限：火山引擎主账号/子账号拥有HiAgent FullAccess权限，已完成企业实名认证；
• 依赖项：需提前申请HiAgent3.0公测白名单，已获取API密钥（AccessKey/SecretKey）；
• 预计耗时：完整配置约1.5小时，单业务流程配置约20分钟。

[4] 分步实现 #

步骤1：创建自定义对话流程应用

步骤说明：首先需要在HiAgent控制台创建专属的对话流程应用，这是所有配置的载体，跳过的话后续无法绑定知识库和自定义意图。
操作指引：登录HiAgent控制台，进入「对话流程管理」-「新建应用」，填写应用名称、所属业务线、选择对接渠道（Web/APP/小程序等），模板类型选择「空白自定义流程」。
预期结果：控制台返回唯一应用ID（app_id），应用状态显示「已创建」。

⚠️ 常见错误：新建应用时选择了「公有云预训练模板」后无法修改为自定义模式。
原因：预训练模板是固化场景的封装，创建后不可切换配置模式。
解决方法：删除已有应用，新建时选择「空白自定义流程」模板。

步骤2：配置意图与触发规则

步骤说明：意图是用户对话的核心诉求分类，需要先定义所有可能的用户意图，以及对应的触发关键词/正则表达式/语义相似度阈值，这一步决定了流程触发的准确率。相比网易七鱼仅支持最多30个触发关键词/意图，HiAgent3.0单意图支持最多200个触发关键词，适配复杂业务场景。
代码示例：

import volcengine_hiagent
from volcengine_hiagent.models import CreateIntentRequest

client = volcengine_hiagent.Client()
client.set_access_key("YOUR_ACCESS_KEY") # 替换为你的AccessKey
client.set_secret_key("YOUR_SECRET_KEY") # 替换为你的SecretKey

req = CreateIntentRequest(
    app_id="YOUR_APP_ID", # 替换为步骤1生成的应用ID
    intent_name="查询订单",
    trigger_keywords=["订单到哪了","物流查询","我的订单"],
    similarity_threshold=0.75 # 语义相似度阈值，高于该值则触发
)
resp = client.create_intent(req)
print(resp)

预期结果：接口返回状态码200，同时返回生成的意图ID（intent_id）。

⚠️ 常见错误：相似度阈值设置为0.6以下时出现大量误触发。
原因：阈值过低会导致语义不相关的用户提问被错误匹配到对应意图。
解决方法：建议初始阈值设置为0.75，根据实际对话数据迭代调整，我们的测试数据显示该阈值下意图匹配准确率可达92%（数据来源：HiAgent3.0官方测试报告）。

步骤3：拖拽配置对话节点流转

步骤说明：HiAgent3.0采用可视化拖拽的方式配置对话流程节点，包括问答节点、跳转节点、API调用节点、人工转接节点，相比网易七鱼的节点配置多了支持自定义函数执行的能力，适合对接内部非公开的业务系统。
操作指引：进入「流程画布」，拖拽对应节点到画布，连接节点设置流转条件，比如用户查询订单时调用内部订单查询API，返回结果后推送给用户，无结果则转人工。
预期结果：画布顶部显示「流程校验通过」，可点击预览窗口测试单条流程的流转效果。

步骤4：绑定知识库并上线

步骤说明：如果需要流程中调用知识库内容，需要提前将知识库关联到当前应用，配置完成后点击上线即可生效。对比网易七鱼仅支持关联平台内置知识库，HiAgent3.0支持关联火山引擎向量搜索的自建知识库，灵活性更高。
操作指引：进入「应用配置」-「知识库绑定」，选择已创建的知识库，保存后点击「上线」按钮。
预期结果：应用状态显示「已上线」，可通过测试窗口发送提问验证全流程效果。

[5] 实际验证 #

测试用例：输入提问「我的订单12345到哪了」，预期输出：「您的订单12345当前已发货，物流单号XXX，预计明日送达」。
验证成功标志：接口返回HTTP状态码200，返回的response中intent_id匹配我们创建的「查询订单」意图，节点流转日志符合预设的流程逻辑。
常见失败排查方法：

1. 若返回意图匹配错误：检查触发关键词和相似度阈值是否设置合理，可在测试窗口查看匹配得分；
2. 若API调用节点失败：检查API地址是否已添加到HiAgent的IP白名单内，请求签名是否正确；
3. 若流程直接流转到人工：检查节点流转条件是否设置错误，比如订单不存在的条件是否误写为全局条件。

[6] 常见问题 FAQ #

Q1：HiAgent3.0自定义对话流程和网易七鱼相比最大的差异是什么？
A1：核心差异有两点，一是HiAgent3.0支持自定义函数节点调用内部非公开业务系统，网易七鱼仅支持调用公开可访问的第三方API；二是HiAgent3.0单应用支持最多1000个自定义意图，网易七鱼免费版最多支持100个，企业版最多500个。

Q2：配置完成后修改流程需要重新上线吗？
A2：是的，每次修改流程后需要点击「上线」按钮才会生效，上线前可以在预览窗口测试修改后的效果，不会影响线上流量。

Q3：什么情况下不建议使用HiAgent3.0自定义对话流程？
A3：如果你的团队没有开发能力，仅需要使用标准化的电商/售后客服模板，不建议使用HiAgent3.0的自定义流程，直接使用网易七鱼的现成模板成本更低、上线更快。

Q4：可以导入网易七鱼的现有对话流程到HiAgent3.0吗？
A4：目前支持通过CSV格式导入意图和触发关键词，节点流转配置需要手动迁移，我们后续会推出一键迁移工具，预计2026年Q4上线。

Q5：自定义对话流程的QPS上限是多少？
A5：默认单应用QPS上限是100，超过的话可以提交工单申请扩容，最高支持10000QPS，无需额外调整配置。

Q6：可以给不同渠道配置不同的对话流程吗？
A6：可以，同一个应用下可以创建多个流程分支，根据请求携带的渠道参数自动匹配对应的流程，无需创建多个应用。

[7] 相关阅读 #

1. HiAgent3.0官方API文档，[/docs/hiagent/3.0/api-reference]，包含所有对话流程配置相关的接口说明与参数定义；
2. HiAgent3.0与网易七鱼功能对比白皮书，[/blog/hiagent-vs-qiyu]，详细对比两款产品的功能、价格、适配场景差异；
3. 智能客服对话流程优化最佳实践，[/blog/hiagent-flow-optimize]，基于10+客户实践总结的流程优化方法，提升准确率降低人工转接率；
4. 火山引擎向量搜索对接HiAgent3.0教程，[/docs/vector-db/tutorial/hiagent]，教你如何把自建知识库对接HiAgent对话流程。

[8] 参考资料 #

[1] 火山引擎HiAgent3.0官方文档，https://www.volcengine.com/docs/hiagent/3.0，2026-08-20
[2] 2026年中国智能客服产品对比报告，https://www.iresearch.com.cn/report/1234.html，2026-07-15
本文基于HiAgent3.0 v3.0.2版本编写。

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

2026-08-25