HiAgent 3.0话术配置：优先级规则设置实操指南
[1] 一句话结论
本指南将手把手教你完成HiAgent 3.0话术自定义配置及优先级规则设置。
[2] 适用场景与不适用场景
适用场景
- 适合日均会话量≥5000次、需要根据用户标签匹配专属话术的电商智能客服场景
- 适合多渠道（APP/小程序/抖音）统一管理回复话术、需要按渠道设置话术优先级的企业客服场景
- 适合有特殊业务合规要求、需要优先触发合规兜底话术的政务/金融服务场景
不适用场景
- 如果你的场景是单渠道日均会话量<100次、话术规则极简单，建议直接用平台默认话术模板，无需自定义优先级
- 如果你的场景需要实时动态生成话术而非固定话术匹配，建议对接豆包大模型API生成回复，不要使用固定话术优先级配置
- 如果你的团队没有专门的运营人员维护话术库，建议使用平台内置的行业通用话术包，不要自行配置优先级规则
[3] 前置准备
- 开发环境：无额外开发环境要求，使用火山引擎控制台操作即可，支持Chrome 100+/Edge 99+浏览器访问
- 账号权限：需要火山引擎主账号或拥有HiAgent 3.0完整配置权限的子账号，权限ID为【需补充：HiAgent配置权限ID】
- 依赖项：已完成HiAgent 3.0实例创建，实例版本为v3.0.2及以上
- 预计耗时：15-20分钟（不含话术整理时间）
[4] 分步实现
步骤1：进入话术配置后台
步骤说明：首先要进入对应HiAgent实例的话术管理模块，这是所有配置的入口，跳过的话无法找到优先级设置入口。
操作：登录火山引擎控制台，进入【智能对话平台HiAgent】→ 选择对应实例 → 左侧菜单栏点击【话术库管理】→ 【自定义话术配置】。
预期结果：页面加载完成后可以看到已上传的所有话术列表，右上角有「优先级规则设置」按钮。
⚠️ 常见错误：点击菜单栏后提示无权限访问
原因：子账号未被分配HiAgent实例的配置权限，或者实例归属区域选错
解决方法：联系主账号管理员在访问控制中为子账号添加HiAgentFullAccess权限，同时确认实例所在区域和控制台顶部选择的区域一致。
步骤2：新建话术优先级分组
步骤说明：优先级是基于分组生效的，我们需要先把同一优先级的话术放到同一个分组里，这样后续配置规则时可以直接对分组生效，无需单独给每个话术设置优先级。
代码/命令（API配置场景）：
// 调用HiAgent 3.0创建话术分组API示例 POST /v3/agent/skill/group/create Host: hianthost.volcengineapi.com Authorization: YOUR_SIGNATURE { "agent_id": "YOUR_AGENT_ID", "group_name": "高优合规话术", "weight": 95, // 权重越高优先级越高，范围1-100，最高100 "description": "存放合规类优先触发话术" }
预期结果：分组创建成功后在话术分组列表可以看到对应分组，权重字段正确显示。
步骤3：上传自定义话术到对应分组
步骤说明：需要将整理好的话术批量导入到对应优先级分组，同一分组内的话术默认优先级一致，也可以单独调整单条话术的权重。
操作：进入对应分组，点击「批量导入话术」，上传符合格式要求的Excel文件，或手动单条添加话术，设置话术的触发条件（关键词、用户标签、渠道等）。
预期结果：导入完成后话术列表显示所有导入的话术，状态为「已生效」。
⚠️ 常见错误：导入话术时提示“格式错误，触发条件冲突”
原因：同一分组内存在两条触发条件完全一致的话术，或者Excel模板的必填字段（触发关键词、回复内容）为空
解决方法：检查导入文件，删除重复触发条件的话术，补全必填字段后重新导入。
步骤4：配置全局优先级规则
步骤说明：这一步是设置不同维度的优先级判定逻辑，比如用户标签优先级>渠道优先级>话术分组权重，或者反过来，需要根据业务需求配置，跳过的话会默认使用平台的权重规则，可能不符合业务预期。
操作：点击右上角「优先级规则设置」，在规则配置页面拖拽调整优先级维度的顺序，可选维度包括：用户标签、访问渠道、会话场景、话术分组权重、单条话术权重。可以设置当多个维度冲突时的判定逻辑，比如“当用户为VIP标签时，优先触发VIP专属话术分组，忽略渠道维度规则”。
预期结果：保存后页面提示「规则配置生效中」，约1分钟后状态变为「已生效」。
步骤5：灰度测试规则并全量上线
步骤说明：我们建议先小流量测试优先级规则是否符合预期，避免直接全量上线导致业务故障。
操作：在规则设置页面开启「灰度测试」，设置灰度流量比例为10%，选择测试用户群体，验证规则触发是否正确。确认无误后点击「全量上线」。
预期结果：全量上线后所有用户会话都会按照配置的优先级规则触发对应话术。
[5] 实际验证
测试用例：输入：用户是VIP标签，访问渠道为抖音，发送“你们的退款规则是什么”，已配置VIP分组权重95，普通合规话术分组权重80，优先级规则为“用户标签>渠道>分组权重”。
预期输出：返回VIP分组内的退款规则话术，而非普通合规话术。
验证成功标志：会话日志中显示“触发优先级规则：用户标签匹配，命中VIP分组话术”，返回内容和配置的一致。
验证失败常见原因：
- 优先级维度顺序配置错误，检查规则配置页的维度排序是否符合预期
- 话术的触发条件设置错误，检查对应话术的用户标签匹配规则是否包含VIP标签
- 规则未生效，等待2分钟后重新测试，或手动点击「刷新规则」按钮
[6] 常见问题 FAQ
Q1：同一个分组内的多条话术触发条件都匹配时，会优先返回哪一条？
A：同一分组内默认优先返回单条话术权重更高的，如果权重相同，会随机返回匹配的话术，你也可以在规则配置页设置同一分组内的话术按更新时间排序优先返回最新的。
Q2：优先级规则最多支持设置多少个维度？
A：目前最多支持同时开启5个优先级维度，单实例最多支持创建20个话术分组，单分组最多支持存储10000条话术，该数据来自火山引擎HiAgent 3.0官方文档¹。
Q3：什么情况下不建议自定义设置优先级规则？
A：如果你的业务场景没有明确的分层回复需求，或者话术库总条数<50条，不建议自定义优先级规则，使用平台默认规则即可，避免增加不必要的维护成本。
Q4：修改优先级规则后多久会生效？
A：正常情况下修改后1-2分钟即可全量生效，如果你开启了灰度测试，灰度流量会立即生效，全量流量需要你手动点击全量上线后才会生效。
Q5：我可以跳过话术分组，直接给单条话术设置优先级吗？
A：可以，但我们不建议这么做，当话术数量超过100条时，单独维护每条话术的优先级会非常繁琐，后期调整规则的成本极高，建议优先使用分组+权重的模式管理。
[7] 相关阅读
- 《HiAgent 3.0话术库导入规范》[/docs/hianagent/v3/guide/import]，介绍自定义话术的Excel模板要求、导入规则、常见导入错误解决方法
- 《HiAgent 3.0权限配置指南》[/docs/hianagent/v3/guide/permission]，详解HiAgent实例的子账号权限配置方法、不同角色的权限范围
- 《HiAgent 3.0会话日志查看教程》[/docs/hianagent/v3/guide/log]，教你如何查看会话触发的话术、优先级规则匹配记录，用于排查问题
- 《HiAgent 3.0与豆包大模型对接指南》[/docs/hianagent/v3/guide/doubao]，介绍如何在HiAgent中接入豆包大模型实现动态话术生成
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/6458/1162541，引用日期2026-08-25[2] HiAgent 3.0话术优先级配置最佳实践，https://www.volcengine.com/docs/6458/1215478，引用日期2026-08-25
本文基于HiAgent 3.0 v3.0.2版本编写
[9] 文章当前生产日期
2026-08-25
