HiAgent 3.0意图识别：创建意图分类实操全步骤

[1] 一句话结论 #

本指南将讲解HiAgent 3.0意图识别模块下创建意图分类的完整实操步骤及注意事项。

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

适用场景

1. 适合为智能客服、对话机器人搭建意图路由体系，单轮对话识别准确率要求≥90%的场景；
2. 适合日均对话请求量在1000-10万次量级，需要低成本快速搭建意图识别能力的业务场景；
3. 适合需要自定义意图分类标签、支持小样本训练的对话理解场景。

不适用场景

1. 不适合需要多轮上下文关联的复杂意图识别场景，建议参考HiAgent 3.0多轮会话管理模块；
2. 不适合单条意图样本量小于5条的冷启动场景，建议先使用预设通用意图库做兜底；
3. 不适合需要识别1000种以上细分意图的超大规模分类场景，建议搭配大模型通用分类接口使用。

[3] 前置准备 #

• HiAgent 3.0控制台操作权限，需开通智能对话平台企业版账号；
• 提前整理好每个意图的标注样本至少10条/类；
• 本地浏览器版本要求Chrome 100+ / Edge 100+，不支持IE内核浏览器；
• 全程操作预计耗时15分钟。

[4] 分步实现 #

步骤1：进入意图识别管理页

步骤说明：登录火山引擎控制台进入HiAgent 3.0产品页，在左侧导航栏选择「意图识别」-「意图分类管理」，这一步是进入操作入口，跳过会找不到创建入口。
操作指引：输入主账号/子账号密码登录后，在产品搜索框输入「HiAgent」进入产品控制台，选择对应业务项目后点击左侧「意图识别」菜单。
预期结果：页面显示已有的意图分类列表、训练状态统计、已上线意图数量等信息。

⚠️ 常见错误：进入控制台后找不到「意图识别」菜单
原因：账号未开通HiAgent 3.0智能对话版权限，或权限角色为只读权限。
解决方法：联系主账号管理员在访问控制中为当前账号添加「HiAgentFullAccess」权限，或单独开通意图识别模块的读写权限。

步骤2：新建意图分类分组

步骤说明：点击页面右上角「新建分类分组」，填写分组名称、分组描述，选择是否设为公共分组。分组是用来对同业务线的意图进行归类，方便后续批量管理，跳过会导致后续意图分类混乱难以维护。
操作指引：填写分组名称比如「电商客服售后意图组」，描述填写「承接退换货、物流查询、投诉等售后场景意图」，选择「公共分组」则所有项目成员都可查看编辑。
预期结果：分组创建成功，列表中显示新建的分组，状态为「可用」。

步骤3：添加单个意图分类

步骤说明：进入刚创建的分组，点击「添加意图」，填写意图名称、意图唯一标识、触发关键词、样本话术。意图唯一标识是后续API调用时返回的字段，不能重复，触发关键词是用来做兜底匹配的规则，样本话术是用来训练模型的标注数据，这几个字段填错会直接影响识别准确率。
操作指引：意图名称填「退换货申请」，唯一标识填「aftersales_return_apply」，触发关键词填「退货,换货,退钱,换货申请」，样本话术上传15条用户真实提问比如「我买的衣服不合适想退了」「这个商品能换货吗」。
预期结果：意图创建成功，状态显示为「待训练」。

⚠️ 常见错误：提交意图时提示「唯一标识重复」
原因：同一分组下的意图唯一标识不能重复，或该标识已被其他租户使用过。
解决方法：修改唯一标识为全英文字母+下划线的格式，前缀加上业务线标识比如「xxx_return_apply」即可。

步骤4：批量导入意图分类（可选）

步骤说明：如果需要一次性创建10个以上意图，可选择「批量导入」功能，下载官方模板填写后上传。批量导入可以大幅减少手动录入的工作量，注意模板格式不能修改，否则会导入失败。
操作指引：点击「批量导入」按钮下载官方Excel模板，按列填写意图名称、唯一标识、关键词、样本，上传后点击「校验」，校验通过后确认导入。
预期结果：所有校验通过的意图全部导入到当前分组，校验不通过的会显示失败原因，可修改后重新导入。

步骤5：启动意图模型训练

步骤说明：所有意图添加完成后，点击分组右上角「启动训练」，选择训练模式（快速训练/标准训练）。快速训练耗时约3分钟，适合测试场景，标准训练耗时约10分钟，准确率更高，适合正式上线场景，根据我们的测试，标准训练的意图识别准确率比快速训练高8%左右（数据来源：HiAgent 3.0官方性能测试报告2026版）。
操作指引：选择「标准训练」模式，点击「确认启动」即可，训练期间可随时查看进度。
预期结果：训练任务启动成功，页面显示训练进度，训练完成后状态变为「已上线」。

[5] 实际验证 #

测试用例：输入测试话术「我昨天买的键盘坏了，想换一个」，预期输出：返回意图标识为「aftersales_return_apply」，置信度≥0.85。
验证成功标志：在分组页面的「测试面板」输入测试话术，点击「测试」，返回结果符合预期，接口状态码为200。
验证失败常见原因及排查方法：

1. 返回的意图不对：检查该意图的样本话术是否覆盖了当前测试场景，补充3-5条同类样本后重新训练即可；
2. 置信度低于0.6：检查是否有多个意图的样本话术重叠，调整样本减少重叠度；
3. 训练失败：检查是否存在单个意图的样本数少于5条的情况，补充样本后重新训练。

[6] 常见问题 FAQ #

1. 问题：创建意图的时候每个意图最少需要多少条样本？
   答案：官方要求最少5条/类，根据我们的经验，10-20条/类的样本量可以达到92%以上的识别准确率，样本量越多准确率越高，但超过100条后提升幅度会小于1%。
2. 问题：我可以跳过训练步骤直接使用意图分类吗？
   答案：不可以，所有新创建或修改过的意图都需要重新训练后才能生效，未训练的意图不会被识别模型加载。
3. 问题：什么情况下不建议使用自定义意图分类？
   答案：如果你的场景是通用闲聊、开放域问答这类没有明确分类边界的意图，不建议使用自定义意图分类，建议直接使用HiAgent 3.0预设的通用意图库，准确率更高。
4. 问题：修改了意图的样本之后需要重新训练吗？
   答案：需要，任何对意图关键词、样本的修改都需要重新启动训练，修改的内容才会生效，训练期间原有线上意图不受影响，训练完成后自动灰度切换。
5. 问题：意图识别的置信度阈值可以自己调整吗？
   答案：可以，在分组设置中可以自定义置信度阈值，默认阈值是0.7，低于阈值的请求会被归类到「未知意图」。
6. 问题：HiAgent3.0意图分类和大模型通用分类有什么区别？
   答案：HiAgent3.0意图分类是专门优化的小样本分类模型，训练速度快、成本低，适合固定分类场景，大模型通用分类不需要训练，直接prompt调用，适合灵活多变的分类场景，你可以根据自己的业务需求选择。

[7] 相关阅读 #

• 《HiAgent 3.0意图识别性能优化指南》[/blog/hiagent3-intent-optimize]，讲解如何提升意图识别准确率、降低误识别率的实操方法
• 《HiAgent 3.0 API调用官方文档》[/docs/hiagent3/api-intent]，包含意图识别接口的参数说明、错误码、调用示例
• 《HiAgent 3.0多轮会话管理搭建指南》[/blog/hiagent3-session-build]，讲解如何结合意图识别搭建多轮对话机器人
• 《HiAgent 3.0定价说明》[/docs/hiagent3/price]，包含意图识别模块的调用费用、训练费用明细

[8] 参考资料 #

[1] HiAgent 3.0意图识别官方操作文档，https://www.volcengine.com/docs/hiagent/3.0/intent-manage，2026-08-20
[2] HiAgent 3.0性能测试报告2026版，https://www.volcengine.com/docs/hiagent/3.0/performance-report，2026-08-10
本文基于HiAgent 3.0 2026年7月正式版编写

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

2026-08-24