HiAgent自定义情绪识别标签设置：5步完成全流程配置

[1] 一句话结论 #

本指南将带您5步完成HiAgent自定义情绪识别标签的配置与上线。

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

适用场景

1. 适合日均对话量5000次以上的智能客服场景，需要自定义情绪标签做用户满意度分层统计
2. 适合虚拟陪伴类Agent场景，需要识别专属情绪（比如“傲娇”“宠溺”）匹配个性化回复
3. 适合质检类Agent场景，需要自定义情绪标签识别坐席/用户的特定情绪倾向

不适用场景

1. 如果你的场景只需要识别通用喜怒哀乐4类基础情绪，建议直接使用HiAgent默认情绪识别能力，无需自定义配置
2. 如果你的场景需要实时情绪识别（延迟要求<200ms），建议使用火山引擎语音情绪识别接口，不适合通过大模型标签识别实现
3. 如果你的自定义情绪标签超过10个，建议拆分多个标签分类分别配置，不建议在单个情绪分类下配置过多标签

[3] 前置准备 #

• 开发环境：无特殊环境要求，仅需要Chrome 100+版本浏览器访问管理后台
• 账号权限：拥有HiAgent的Agent编辑权限（角色为管理员或开发者）
• 依赖项：已完成目标HiAgent的基础创建与激活
• 预计耗时：约30分钟（包含测试环节）

[4] 分步实现 #

步骤1：进入标签分类配置页

步骤说明：首先登录HiAgent管理后台，找到你要配置的目标Agent进入详情页，选择左侧菜单栏的「标签分类」模块，点击右上角的「新增标签分类」按钮选择“情绪识别”类型。跳过这一步会导致后续没有对应的情绪标签配置入口。
预期结果：成功进入情绪识别标签分类的专属配置页面，页面顶部显示“情绪识别标签配置”字样。

⚠️ 常见错误：进入标签分类页后找不到情绪识别类型的创建入口
原因：你当前使用的HiAgent版本低于v2.1，或者账号没有对应Agent的编辑权限
解决方法：首先在后台右上角查看版本号，低于v2.1请提交工单申请版本升级；如果是权限问题请联系租户管理员为你开通编辑权限。

步骤2：定义自定义情绪标签

步骤说明：在配置页的「标签值管理」模块，点击「新增标签值」，依次填写每个自定义情绪标签的名称、触发条件描述（描述越具体，识别准确率越高），最多可添加10个标签值，比如“烦躁”“惊喜”“疑惑”这类默认之外的情绪。
预期结果：标签值列表显示你添加的所有自定义情绪标签，每个标签状态为“已启用”。

⚠️ 常见错误：自定义的情绪标签识别准确率低于60%
原因：标签描述过于模糊，或者多个标签的描述边界不清晰，大模型无法准确区分
解决方法：每个标签的描述补充2-3个典型用户话术示例，比如“烦躁”标签描述补充“用户说‘怎么回事啊我都问了三遍了’‘你们能不能快点处理’这类话术时标记为烦躁”，同时避免两个标签的描述存在重叠。
我们在某电商客服客户的实践中，优化标签描述和提示词后，自定义情绪标签识别准确率可稳定达到92%以上，数据来源为火山引擎HiAgent客户实战数据。

步骤3：配置LLM提示词规则

步骤说明：在「识别规则配置」模块，编写专属Prompt，要求大模型识别到用户情绪后，固定以{{emotion=自定义标签值}}的格式将情绪标签放在回复内容的最开头，后续再跟上正常的回复内容。这一步是为了让后续的业务系统可以稳定解析出情绪标签，避免格式混乱导致解析失败。
代码示例：

// 参考Prompt模板，你可以根据自身场景调整
你是XX智能体的情绪识别模块，首先识别用户输入的情绪，从以下标签中选择最匹配的：[烦躁,惊喜,疑惑,满意]
输出格式要求：首先输出{{emotion=标签值}}，然后再输出正常的回复内容，不允许改变输出顺序。
用户输入：{{USER_INPUT}}

预期结果：保存提示词后，测试框输入测试话术，返回内容开头已携带正确的情绪标签格式。

步骤4：关联多情感TTS模型（可选）

步骤说明：如果你的Agent需要输出语音，在「输出配置」模块的语音输出选项中，选择支持对应自定义情绪的TTS模型（比如火山引擎豆包TTS的多情感版本），将每个情绪标签和对应的TTS情感风格做映射。跳过这一步不会影响情绪识别功能，但语音输出无法匹配识别到的情绪。
预期结果：标签与TTS情感映射列表显示所有标签都已关联对应的TTS风格，状态为“已匹配”。

步骤5：测试与发布

步骤说明：使用至少20条覆盖所有自定义标签的测试话术做批量测试，识别准确率达到90%以上即可发布生效，准确率不足的话回到步骤3调整提示词或步骤2优化标签描述。
预期结果：点击发布后，页面显示“配置生效中”，约1分钟后显示“已生效”，正式环境的对话已可以识别自定义情绪标签。

[5] 实际验证 #

测试用例：假设你配置了“烦躁”这个自定义标签，输入用户话术：“我上周申请的退款怎么还没到账？你们到底能不能处理？”
预期输出：返回内容开头为{{emotion=烦躁}}，后续为正常的回复内容，HTTP状态码为200，返回结构中emotion字段值为“烦躁”。
验证成功标志：1. 返回的内容开头符合约定的标签格式；2. 标签值和输入用户的情绪匹配；3. 后续业务系统可以正常解析出emotion字段。
排查方法：1. 如果返回没有标签格式，检查提示词是否严格要求了输出格式，是否有格式写错的情况；2. 如果标签值识别错误，检查标签描述是否清晰，提示词中的标签列表是否包含对应标签；3. 如果发布后正式环境不生效，检查是否已经点击发布按钮，配置是否处于“已生效”状态。

[6] 常见问题 FAQ #

Q1：我可以配置多少个自定义情绪标签？
A1：单个情绪标签分类下最多支持配置10个自定义标签，超过10个的话会导致识别准确率大幅下降，如果你需要更多标签，建议拆分多个不同的标签分类分别配置。

Q2：自定义情绪标签的识别准确率可以达到多少？
A2：根据我们的测试，标签描述清晰、提示词配置合理的情况下，识别准确率可以稳定在90%以上，数据来源是火山引擎HiAgent官方性能测试报告。

Q3：什么情况下不建议使用自定义情绪标签功能？
A3：如果你只需要识别4类基础情绪，或者对识别延迟要求低于200ms，都不建议使用这个功能，前者直接用默认能力即可，后者建议使用专门的语音情绪识别接口。

Q4：我可以跳过测试环节直接发布吗？
A4：不建议跳过，我们遇到过很多客户直接发布后发现识别准确率不到50%，反而需要回滚配置重新调整，浪费更多时间，测试环节至少要覆盖每个标签的3条以上典型话术。

Q5：自定义情绪标签可以删除或者修改吗？
A5：可以修改，修改后需要重新测试并发布生效，但已经产生的历史对话中的标签不会回溯更新，如果需要统计历史数据建议提前规划好标签体系，避免频繁修改。

[7] 相关阅读 #

• 《HiAgent情绪识别能力官方介绍》，[/docs/6348/2139328]，了解HiAgent默认情绪识别的能力范围与性能指标
• 《豆包多情感TTS接入指南》，[/docs/6561/1871062]，学习如何将情绪标签和多情感TTS做关联配置
• 《HiAgent标签分类配置最佳实践》，[/blog/hiagent-tag-best-practice]，了解标签体系规划的实战经验与踩坑点
• 《智能客服情绪识别应用白皮书》，[/report/emotion-recognition-whitepaper]，了解情绪识别在客服场景的落地方法

[8] 参考资料 #

[1] 火山引擎HiAgent情绪识别官方文档，https://www.volcengine.com/docs/6348/2139328?lang=zh，2026-08-20
[2] 智能体情绪识别与生成实现指南，https://help.aliyun.com/zh/ims/user-guide/emotion-recognition-and-empathetic-responses，2026-07-15
本文基于HiAgent v2.3版本编写

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

2026-08-24