HiAgent情绪识别配置：3步完成后台部署上线

[1] 一句话结论 #

本指南将带你完成HiAgent情绪识别功能的后台全流程配置

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

适用场景

1. 适合日均对话量≥5000次的在线智能客服场景，需要自动识别用户负面情绪触发人工转接的业务；
2. 适合电商售后场景，需要实时统计用户投诉、不满情绪占比做运营分析的需求；
3. 适合教育陪练类AI对话产品，需要识别用户沮丧情绪调整回答策略的场景。

不适用场景

1. 单条对话长度≤5字的极简指令类交互场景（比如智能硬件控制），识别准确率不足60%，建议使用规则关键词匹配替代；
2. 要求毫秒级响应的实时互动场景（比如直播弹幕实时情绪过滤），本功能当前平均延迟280ms（数据来源：《HiAgent V2.1功能性能基准测试报告》），建议使用火山引擎内容安全的实时情绪检测接口；
3. 无用户授权的第三方对话数据情绪分析场景，违反平台合规要求，建议先获取用户明确授权后再使用。

[3] 前置准备 #

• 开发环境：无本地开发环境要求，仅需Chrome 100+ / Edge 95+版本浏览器访问HiAgent后台
• 账号权限：拥有HiAgent企业版账号，且具备【应用配置-功能开关】的管理员权限
• 依赖项：已完成至少1个HiAgent对话应用的创建与基础话术配置
• 预计耗时：20分钟（不含测试验证时间）

[4] 分步实现 #

步骤1：开启情绪识别功能开关

步骤说明：首先要在应用配置页打开情绪识别的全局开关，这是功能生效的前提，跳过的话后续所有情绪相关配置都不会生效。
操作路径：登录HiAgent后台→进入目标应用的【功能配置】页→找到【智能分析能力】模块→勾选【开启情绪识别】选项→点击【保存配置】。
预期结果：页面右上角弹出“配置保存成功”提示，开关状态显示为已开启。

⚠️ 常见错误：勾选开关保存后刷新页面又变回关闭状态
原因：当前登录账号没有该应用的配置修改权限，仅拥有查看权限
解决方法：联系企业HiAgent管理员开通【应用配置编辑】权限，或使用管理员账号操作。

步骤2：配置情绪触发规则

步骤说明：根据业务需求配置不同情绪的触发动作，比如负面情绪触发人工转接、情绪标签打标等，这一步是让功能贴合业务需求的核心，默认规则可能不符合你的业务场景。
操作路径：点击情绪识别开关下方的【规则配置】按钮→进入规则配置页→新增规则：① 触发条件：用户情绪为“愤怒/不满”，触发动作：转接人工客服队列A；② 触发条件：用户情绪为“疑问/困惑”，触发动作：自动匹配高频QA库返回结果→配置完成后点击【发布规则】。
预期结果：规则列表显示已配置的2条规则，状态为“已发布”。

⚠️ 常见错误：配置的情绪触发规则没有生效
原因：规则配置后仅点击了保存没有点击【发布规则】，未发布的规则不会在对话中生效
解决方法：进入规则配置页，选中未发布的规则，点击右上角【发布规则】按钮，等待1~2分钟规则生效即可。

步骤3：配置情绪数据存储与导出

步骤说明：如果需要后续分析用户情绪数据，需要开启情绪数据的存储功能，默认存储时长为30天，可根据需求调整。
操作路径：进入【数据管理】→【存储配置】页→找到【情绪标签数据】选项→开启存储，选择存储时长（可选30天/90天/180天/永久）→配置完成后保存。
预期结果：存储配置页显示情绪标签数据存储状态为“已开启”，存储时长为你选择的数值。

步骤4：灰度发布配置

步骤说明：为了避免全量上线出现问题，建议先进行灰度放量，给小比例用户开启情绪识别功能验证效果。
操作路径：进入【灰度发布】页→新建灰度规则→选择功能为“情绪识别”，放量比例设置为10%，生效范围选择全量用户→保存灰度规则。
预期结果：灰度规则列表显示该规则状态为“运行中”，10%的用户对话会触发情绪识别能力。

[5] 实际验证 #

测试用例：进入对话调试页面，模拟用户发送带有负面情绪的对话：“你们的产品怎么这么难用，我要投诉”，预期输出：对话标签中会出现“负面情绪-愤怒”的标签，同时触发你配置的转人工动作。
验证成功标志：① 对话详情页能看到情绪标签的展示；② 配置的触发动作正常执行（比如转人工的话会话会进入指定的人工客服队列）；③ 数据报表中能看到该条对话的情绪分类统计。
验证失败常见原因：1. 情绪标签没有显示：检查功能开关是否开启、规则是否已发布；2. 触发动作没有执行：检查规则的触发条件和动作是否配置正确，是否有更高优先级的规则覆盖了当前规则；3. 数据没有存储：检查存储配置是否开启，存储时长是否设置正确。

[6] 常见问题 FAQ #

Q1：情绪识别支持多少种情绪分类？
A：目前支持3大类9小类情绪分类，正面情绪包含满意、惊喜等3类，中性情绪包含平淡、疑问等2类，负面情绪包含愤怒、不满、沮丧等4类，具体分类可参考官方文档。

Q2：情绪识别的准确率是多少？
A：在中文客服对话场景下准确率为92.7%，数据来源是2026年6月火山引擎AI实验室基准测试报告，特定行业场景下可以通过上传行业标注数据定制模型提升准确率。

Q3：什么情况下不建议使用HiAgent自带的情绪识别功能？
A：如果你的场景是单条对话超短、要求延迟低于100ms的实时场景，或者需要多语种情绪识别（当前仅支持中文），不建议使用本功能，建议选择火山引擎内容安全的多语种实时情绪检测接口。

Q4：我可以跳过灰度发布步骤直接全量上线吗？
A：不建议跳过，我们在某电商客户的实践中发现，直接全量上线如果规则配置错误，可能导致大量用户被误转人工，造成客服队列堵塞，建议先按10%、30%、100%的节奏逐步放量。

Q5：情绪识别功能怎么收费？
A：按调用次数收费，标准价格是0.001元/次，日均调用量超过100万次可联系商务申请折扣，调用次数统计以实际触发情绪识别的对话数为准。

[7] 相关阅读 #

1. 《HiAgent功能配置总览》[/docs/hiagent/guide/function-config]，快速了解HiAgent所有后台配置项的作用
2. 《HiAgent情绪识别API调用指南》[/docs/hiagent/api/emotion-recognition]，如果你需要通过API直接调用情绪识别能力可以参考
3. 《智能客服情绪运营分析最佳实践》[/blog/hiagent-emotion-operation]，教你怎么用情绪识别数据优化客服运营效率
4. 《HiAgent灰度发布功能使用教程》[/docs/hiagent/guide/gray-release]，详细讲解灰度发布的配置规则和最佳实践

[8] 参考资料 #

[1] 《HiAgent V2.1 后台配置官方文档》，https://www.volcengine.com/docs/hiagent/2.1/guide/emotion-config，2026-08-01
[2] 《HiAgent V2.1功能性能基准测试报告》，https://www.volcengine.com/docs/hiagent/2.1/report/performance，2026-07-15
本文基于HiAgent V2.1版本编写。

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

2026-08-24