HiAgent 3.0电商客服话术自定义：30分钟完成全流程配置

[1] 一句话结论 #

本指南将手把手教你完成HiAgent 3.0电商客服场景的话术自定义全流程配置。

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

适用场景

1. 适合日均客服咨询量5000次以上、需统一品牌回复口径的电商店铺场景，可避免不同坐席回复口径不一致的问题。
2. 适合需要针对618、双11大促、新品上线等特殊节点批量调整客服话术的运营场景，可一次性配置定时生效，无需临时通知所有坐席。
3. 适合有自定义售后、换货、偏远地区配送等专属业务规则回复需求的垂直品类电商场景，可完全匹配自身业务规则。

不适用场景

1. 如果你的场景是完全不需要标准化回复的1v1高端私域客服，建议直接使用人工坐席系统，自定义话术无法满足高度个性化的回复需求。
2. 单店铺日均咨询量低于100次的小商家，建议直接使用HiAgent预置的通用电商话术模板，不需要额外花费时间自定义配置。
3. 需要接入非电商场景（比如政务、金融咨询）的话术需求，建议参考HiAgent行业版自定义配置文档，电商版的功能模块无法适配其他行业的规则。

[3] 前置准备 #

• 已完成HiAgent 3.0电商版账号开通，拥有客服主管admin权限
• 支持Chrome 100+、Edge 99+版本浏览器操作即可，无其他开发环境要求
• 已整理好需要自定义的话术规则文档（包含触发关键词/意图、回复逻辑、例外场景）
• 预计配置耗时：25-35分钟

[4] 分步实现 #

步骤1：进入话术自定义配置后台

步骤说明：首先你需要从火山引擎控制台进入HiAgent 3.0的电商版管理页，找到「话术配置」模块，这一步是所有配置的入口，跳过的话你无法找到对应配置项。
操作路径：登录火山引擎控制台→搜索「HiAgent智能客服」→选择对应电商版实例→左侧菜单栏点击「话术管理」→「自定义话术」。
预期结果：进入配置页后能看到当前生效的预置话术列表，顶部有「新建话术规则」按钮。

步骤2：新建话术规则并配置触发条件

步骤说明：这一步是定义什么场景下触发你自定义的话术，比如用户问“发货时间”的时候触发你设置的大促发货规则，跳过这一步的话自定义话术没有触发逻辑，无法生效。
操作：点击「新建话术规则」→填写规则名称（比如“618大促发货话术”）→设置触发条件：可选择关键词匹配、意图识别匹配、场景标签匹配三种方式，比如选择意图匹配「咨询发货时间」，再叠加场景标签「大促期间」。

⚠️ 常见错误：配置了多个触发条件后，话术没有按预期触发。
原因：默认触发条件是「所有条件同时满足」，如果你的需求是满足任意一个条件就触发，需要手动调整逻辑运算符。
解决方法：在触发条件配置页顶部，将逻辑关系从「AND」切换为「OR」即可。
预期结果：保存触发条件后，系统会自动弹出“触发条件校验通过”的提示，规则状态显示为“待配置回复内容”。

步骤3：配置自定义回复话术内容

步骤说明：这一步是设置用户触发规则后，HiAgent返回的具体回复内容，支持添加变量、多轮引导、跳转人工入口，跳过这一步规则无法保存上线。
操作：在回复内容编辑框输入话术，示例如下：

您好，本次618大促期间订单将在付款后48小时内发出哦~
如果您买的是预售商品，我们会在【{{预售商品约定发货时间}}】前发出
需要加急可以回复【转人工】联系我们的仓储同学处理~

变量可以从右侧变量库直接插入，无需手动编写。

⚠️ 常见错误：插入变量后话术回复显示为空白或者乱码。
原因：你插入的变量没有在对应业务系统中完成字段映射，HiAgent无法拉取到对应数据。
解决方法：进入「变量管理」页，将你使用的变量和你的电商店铺订单系统、商品系统的对应字段完成映射，测试拉取正常后再保存话术。
预期结果：点击「预览」按钮，输入测试用户query后能看到完整的带变量的话术预览，没有空白字段。

步骤4：设置规则优先级和生效时间

步骤说明：这一步是解决多规则冲突的问题，比如大促期间的发货话术优先级要高于平时的通用发货话术，同时可以设置规则的生效起止时间，避免过期后还要手动下线。
操作：在规则优先级模块设置权重（数值越大优先级越高，建议大促专属规则权重设置为90，通用规则设置为30）→在生效时间模块选择「定时生效」，设置起止时间为对应活动的开始和结束时间。
预期结果：保存后规则列表里能看到你新建的规则，优先级、生效时间字段显示和你设置的一致。

步骤5：灰度发布并上线规则

步骤说明：这一步是为了避免全量上线后出错影响所有用户，建议先给10%的用户放量测试，没有问题再全量上线，跳过灰度直接全量上线可能导致大规模回复错误。
操作：点击「上线」按钮→选择灰度比例为10%→确认发布，观察1小时没有异常后再调整为100%全量上线。
预期结果：规则状态变为「生效中」，灰度比例字段显示你设置的数值。

[5] 实际验证 #

测试用例：输入测试query“我昨天付的预售款什么时候发货？”，预期输出为你配置的带变量的话术，示例：“您好，本次618大促期间订单将在付款后48小时内发出哦_{如果您买的是预售商品，我们会在【6月30日】前发出，需要加急可以回复【转人工】联系我们的仓储同学处理}”。
验证成功标志：调用HiAgent测试接口返回HTTP 200状态码，response中msg字段为“success”，content字段和你设置的话术完全一致，变量已替换为真实值。
验证失败常见原因及排查方法：

1. 触发条件不匹配：排查你设置的触发条件是否包含当前测试query的意图，是否有逻辑运算符设置错误；
2. 变量映射错误：排查变量是否已经和业务系统完成映射，测试拉取是否正常；
3. 规则未生效：排查规则的生效时间是否在当前时间范围内，优先级是否低于其他冲突规则。

[6] 常见问题 FAQ #

Q：我可以只给部分商品配置专属话术吗？
A：可以的，你可以在触发条件里添加「商品ID匹配」的条件，输入你需要配置专属话术的商品ID列表即可，最多支持一次性添加1000个商品ID。

Q：自定义话术和预置话术冲突了怎么办？
A：自定义话术的默认优先级高于所有预置话术，你也可以手动调整自定义话术的优先级权重，权重越高越优先触发。

Q：什么情况下不建议使用自定义话术功能？
A：如果你的业务规则还没有完全稳定，每周调整频次超过5次的话，不建议你配置大量自定义话术，建议先使用人工坐席+快捷回复的方式，等规则稳定后再批量配置，避免频繁修改规则导致冲突。

Q：我可以跳过灰度发布直接全量上线吗？
A：不建议，我们在某服饰电商客户的实践中发现，跳过灰度直接全量上线的规则错误率是先灰度再全量的6.8倍（数据来源：2026年6月火山引擎客户服务内部统计），一旦出错会影响大量用户咨询体验，如果一定要全量上线，建议先在测试环境完成至少20条测试用例的验证。

Q：自定义话术最多可以配置多少条？
A：目前单实例最多支持配置2000条自定义话术，超过这个上限的话系统会提示无法新建，建议你合并重复的规则，或者联系客服申请提升配额。

[7] 相关阅读 #

1. 《HiAgent 3.0电商版变量配置全指南》[/blog/hagent-3-0-variable-config]，教你如何完成话术变量和业务系统的字段映射。
2. 《HiAgent 3.0大促场景配置最佳实践》[/blog/hagent-3-0-promotion-best-practice]，包含大促期间客服话术、路由、坐席调度的全流程配置方案。
3. 《HiAgent 3.0 API调用文档》[/docs/hagent/3.0/api]，如果你需要通过API批量配置话术，可以参考这份文档。

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0电商版官方配置文档，https://www.volcengine.com/docs/6725/1176432，2026-08-20
[2] HiAgent电商版话术配置最佳实践白皮书，https://www.volcengine.com/docs/6725/1234567，2026-07-15
本文基于HiAgent 3.0电商版v2.4.1编写。

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

2026-08-24