HiAgent3.0智能外呼：客户标签关联配置实操指南
[1] 一句话结论
本指南将带你完成HiAgent3.0智能外呼客户标签关联全流程配置。
[2] 适用场景与不适用场景
适用场景
- 适合日均外呼量1万次以上、需要通话后自动打标签的线索筛选场景
- 适合需要将客户CRM标签与外呼流程动态联动的客户回访场景
- 适合单场景标签维度≤10个的标准化外呼运营场景
不适用场景
- 如果你的场景是单客户需要自定义超过20个非结构化标签，建议参考火山引擎智能外呼自定义标签扩展方案
- 如果你的场景是需要实时在通话中调整标签规则，建议使用自研标签规则引擎对接外呼回调接口
- 如果你的场景是外呼数据全部存储在本地私有云且无法上云，建议使用本地部署的外呼标签系统
[3] 前置准备
- HiAgent 3.0控制台账号，拥有外呼场景编辑权限（角色为外呼管理员或开发者）
- 已完成HiAgent 3.0外呼实例创建，实例版本≥v2.1.0
- 提前梳理好需要关联的客户标签规则及对应的变量字段
- 整个配置流程预计耗时30分钟（不含测试验证时间）
[4] 分步实现
步骤1：进入配置入口创建场景
步骤说明：首先要登录HiAgent3.0管理控制台，选择对应地域的目标外呼实例，进入大模型场景列表页新建场景，选择文本填写模式，这一步是为后续配置标签关联提供载体，跳过的话没有配置载体无法进行后续操作。
操作：登录控制台后路径为「智能外呼」→「实例管理」→「选择实例」→「大模型场景」→「新建场景」，场景类型选择「文本填写模式」，填写场景名称为【YOUR_SCENE_NAME】。
预期结果：场景创建成功，进入场景配置详情页。
步骤2：基础标签库配置
步骤说明：需要先在场景的标签配置模块录入要关联的标签，明确标签的类型和取值范围，避免后续关联时出现变量不匹配的问题。
操作：在左侧导航栏找到「标签配置」模块，点击「新增标签」，填写标签名称（如“意向等级”“是否到访”）、标签描述，枚举类标签补充预设标签值（如意向等级分为S/A/B/C四级），非枚举类标签仅填写描述即可。
预期结果：标签列表中可看到已创建的所有标签，状态为「已启用」。
步骤3：客户变量与标签关联绑定
步骤说明：这一步是实现标签和客户属性关联的核心，需要提前在变量配置中导入客户基础变量，再在业务流程中引用变量完成绑定。
操作：首先进入「变量配置」模块，批量导入或者手动新增客户变量（如客户姓名、客户等级、历史消费金额等），在「业务描述」的流程、技能模块中通过“$变量名”的格式引用已配置的变量，比如在判断客户意向的规则中写入“当$客户历史消费金额>10000时，标签赋值为S级意向”。
预期结果：保存配置后系统无变量引用错误提示。
⚠️ 常见错误：引用变量后保存时提示“变量未定义”，但是变量列表中已经存在该变量。
原因：变量名大小写敏感，或者引用时多输入了空格、特殊字符。
解决方法：检查引用的变量名是否和变量配置中的名称完全一致，删除多余的空格和特殊字符。
步骤4：话后自动打标签规则配置
步骤说明：如果需要通话结束后由大模型自动根据通话内容生成标签，需要配置话后标签提取规则，不用手动人工打标，提升效率。
操作：进入「智能体管理」→「话后标签」页面，点击「新增提取规则」，选择提取内容类型（如“客户意向”“客户异议”），填写提取项名称、判定规则（如“客户明确表示要购买则提取为S级意向”），选择关联的目标标签后保存。
预期结果：话后标签规则列表中新增对应规则，状态为「已生效」。
⚠️ 常见错误：通话结束后没有生成预期的话后标签，标签字段为空。
原因：判定规则写得太模糊，或者提取内容类型和关联的标签类型不匹配。
解决方法：将判定规则细化为具体的话术判定条件，比如把“客户有兴趣”修改为“客户说出‘我考虑一下’‘发资料给我’这类表述时判定为B级意向”，同时确认提取内容类型和标签的取值范围匹配。
步骤5：测试配置并发布上线
步骤说明：配置完成后必须先做模拟测试，验证标签关联和提取的准确率，避免上线后出现错误，测试通过后再发布上线。
操作：点击控制台右上角的「语音调试」按钮，上传模拟的客户语音或者直接输入模拟对话内容，触发外呼流程，查看生成的标签是否符合预期，确认无误后点击「发布场景」。
预期结果：测试时标签提取准确率≥90%（数据来源：我们在某电商客户线索筛选场景的实测数据），发布成功后场景状态变为「已发布」。
[5] 实际验证
测试用例：输入客户变量$客户历史消费金额=15000，模拟对话内容为客户说“你们这个产品我挺感兴趣的，你把详细资料发我邮箱吧”。
预期输出：客户标签关联为「意向等级：S级」「客户需求：需要产品资料」。
验证成功标志：调试返回结果中HTTP状态码为200，返回的tag字段包含预期的两个标签，取值正确。
常见失败原因排查：1. 返回标签为空：检查话后标签规则是否启用，判定规则是否匹配当前模拟对话内容；2. 标签取值错误：检查变量关联的规则是否正确，变量引用是否存在拼写错误；3. 调试返回403错误：检查当前账号是否有该场景的测试权限，实例是否到期。
[6] 常见问题 FAQ
- 问题：客户标签关联配置最多支持关联多少个标签？
答案：目前HiAgent3.0单场景最多支持关联15个标签，如果超过15个建议拆分多个场景或者使用自定义扩展接口对接外部标签系统，我们在某教育客户的实践中发现超过15个标签会导致话后标签提取延迟从200ms上升到800ms以上。 - 问题：可以跳过变量配置步骤直接配置标签吗？
答案：不可以，变量配置是标签和客户属性关联的基础，跳过的话无法实现标签的动态赋值，只能使用固定标签，无法满足个性化打标的需求。 - 问题：什么情况下不建议使用HiAgent3.0自带的标签关联功能？
答案：如果你的场景需要实时根据通话内容动态修改标签规则，或者需要对接超过3个外部系统的标签数据，不建议使用自带功能，建议通过外呼回调接口对接自研的标签规则引擎。 - 问题：配置完成后可以修改标签规则吗？
答案：可以修改，修改后需要重新测试发布，已经生成的历史标签不会被修改，新的外呼任务会使用新的标签规则。 - 问题：如何导出关联后的客户标签数据？
答案：可以进入「外呼任务管理」→「任务明细」页面，选择对应的任务，点击「导出」按钮，导出的CSV文件中会包含所有关联后的标签字段。 - 问题：话后标签提取的准确率可以达到多少？
答案：在规则配置清晰、训练样本充足的情况下，准确率可以达到92%以上（数据来源：火山引擎HiAgent3.0官方产品文档），如果对准确率要求超过95%建议配合人工复检流程。
[7] 相关阅读
- 《HiAgent3.0智能外呼实例创建操作指南》，[/docs/7139/191832]，讲解HiAgent3.0外呼实例的创建、配置和管理方法。
- 《HiAgent3.0话后标签规则配置最佳实践》，[/docs/7139/191833]，分享不同场景下话后标签规则的配置技巧，提升提取准确率。
- 《智能外呼回调接口对接指南》，[/docs/7139/191834]，讲解如何通过回调接口对接外部标签系统，实现更复杂的标签关联逻辑。
- 《HiAgent3.0外呼场景上线测试规范》，[/docs/7139/191835]，介绍外呼场景上线前的测试流程和验收标准。
[8] 参考资料
[1] 火山引擎HiAgent3.0联动智能外呼官方文档，https://www.volcengine.com/docs/7139/191831，引用日期2026-08-25
[2] 智能外呼系统通话数据分析与客户标签管理：赋能企业精准营销，http://m.toutiao.com/group/7657451598368571923/?upstream_biz=VolcEngine，引用日期2026-08-25
本文基于HiAgent3.0 v2.1.0版本编写
[9] 文章当前生产日期
2026-08-25
