方舟Agent Plan自定义意图分类添加：4步配置即可上线

[1] 一句话结论 #

本指南将带你完成方舟Agent Plan自定义意图分类的全流程配置。

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

适用场景

1. 适合企业客服Agent需新增特定业务意图（如发票申请、账号解绑）的场景，单意图日均调用量≥100次
2. 适合内部办公智能体需自定义内部流程类意图的场景，意图分类精度要求≥95%
3. 适合垂类行业Agent需新增行业专属意图（如医疗挂号、政务办理）的场景

不适用场景

1. 如果你的场景仅需通用意图识别，无需业务定制，建议直接使用方舟Agent Plan内置通用意图库，无需自定义
2. 如果你的场景意图分类数量超过2000个，建议使用火山引擎智能对话平台的自定义NLP模型方案，而非Agent Plan内置意图配置
3. 如果你的场景需要实时动态新增意图（每秒更新≥10个），建议对接火山方舟大模型推理接口自行实现意图识别逻辑

[3] 前置准备 #

• 开发环境：Chrome 100+版本浏览器，可正常访问火山引擎控制台
• 账号与权限：已开通方舟Agent Plan服务的火山引擎主账号/子账号，子账号需具备Agent Plan编辑权限
• 依赖项：无需额外安装SDK，所有操作均在控制台可视化完成
• 预计耗时：单意图配置约15分钟，含测试验证

[4] 分步实现 #

步骤1：进入自定义技能编辑页

步骤说明：所有意图都归属在特定技能下，没有关联技能的意图无法被Agent调用，跳过这一步会找不到意图配置入口。
操作：登录火山引擎控制台，进入方舟Agent Plan产品页，左侧导航栏选择「技能管理」，点击「新建自定义技能」，输入技能名称（如“内部办公服务”）和描述，点击确认进入编辑界面。
预期结果：成功进入可视化技能编辑界面，左侧可见「意图配置」「槽位管理」等菜单。

⚠️ 常见错误：新建技能时选择了“公共技能”而非“自定义私有技能”
原因：公共技能是平台预置的，不支持用户添加自定义意图，仅可使用官方提供的能力
解决方法：删除已创建的公共技能，重新选择“自定义私有技能”类型完成创建

步骤2：新增自定义意图

步骤说明：在技能下创建新的意图分类，相当于定义你要识别的用户需求类别，这一步是意图识别的核心基础，命名不规范会导致后续识别准确率下降。
操作：点击左侧「意图配置」菜单，点击「添加意图」，输入意图名称（如“员工发票申请”），填写意图描述（“识别用户想要申请报销发票的需求”）。
预期结果：意图列表中出现刚刚创建的意图，状态为“草稿”。

步骤3：完善意图配套配置

步骤说明：需要给意图添加训练语料和槽位，大模型需要足够的示例才能准确识别对应的用户输入，槽位用于提取意图中的关键参数，缺少这些配置会导致意图识别准确率低于80%（数据来源：火山引擎方舟Agent Plan官方性能测试报告2026版）。
操作：

1. 在意图详情页的「用户表达示例」板块，添加至少20条用户可能的提问方式，比如“我要报销发票”“怎么申请发票报销”“上个月的出差发票怎么走流程”等
2. 在「槽位管理」板块，添加需要提取的参数，比如“发票金额”“报销类型”“消费日期”，设置是否必填，以及未填时的追问话术
3. 在「回复规则」板块，配置意图识别成功后的响应逻辑，可以选择调用工具、跳转流程或返回固定回复
   预期结果：意图配置页所有配置项均已填写完成，无红色必填项提示。

⚠️ 常见错误：用户表达示例仅添加了2-3条就上线，导致意图识别准确率极低
原因：大模型需要足够的样本来学习意图的边界，样本过少会导致误识别率超过30%
解决方法：每个意图至少添加15条以上不同表述的示例，覆盖不同的用户提问习惯

步骤4：发布并挂载技能到Agent

步骤说明：配置完成的技能需要发布后才能生效，并且需要挂载到目标Agent上，Agent才会加载该技能下的自定义意图，跳过发布步骤会导致配置不生效。
操作：点击技能编辑页右上角的「发布」按钮，选择发布环境（测试/生产），发布完成后进入目标Agent的「技能挂载」页面，选择刚刚发布的自定义技能，点击「确认挂载」。
预期结果：技能状态变为“已发布”，Agent的技能列表中可以看到该自定义技能，状态为“已启用”。

[5] 实际验证 #

我们以刚才配置的“员工发票申请”意图为例，测试用例输入：“我要报销上个月出差的2000元酒店发票”，预期输出：意图识别结果为“员工发票申请”，提取到槽位：报销类型=出差，发票金额=2000元，消费日期=上个月。
验证成功标志：在Agent的测试窗口发送测试输入后，控制台返回的意图识别字段匹配预期，槽位提取完整，触发对应的回复规则。
验证失败常见原因及排查：

1. 意图识别结果错误：检查用户表达示例是否足够，是否有和其他意图重叠的示例，调整示例后重新发布即可
2. 槽位未提取到：检查槽位的正则规则或识别示例是否正确，补充槽位的训练示例
3. 完全没有触发自定义意图：检查技能是否已经发布到对应环境，是否已经挂载到当前测试的Agent上

[6] 常见问题 FAQ #

Q1：自定义意图最多可以添加多少个？
A1：单个自定义技能下最多支持添加200个自定义意图，单Agent最多可以挂载10个自定义技能，也就是最多支持2000个自定义意图，如果超过这个数量建议使用独立的NLP意图识别服务。

Q2：什么情况下不建议使用Agent Plan的自定义意图功能？
A2：如果你的场景需要意图数量超过2000个，或者需要毫秒级的意图识别延迟（要求≤10ms），就不建议使用这个功能，建议对接火山引擎自然语言处理平台的自定义分类模型。

Q3：我可以跳过添加用户表达示例，直接用大模型零样本识别吗？
A3：不可以，零样本识别的准确率仅为60%左右，完全无法满足生产环境要求，必须添加至少15条以上的示例才能达到90%以上的识别准确率。

Q4：自定义意图的识别准确率可以达到多少？
A4：根据我们的测试，当单个意图的用户表达示例≥20条，且意图之间边界清晰时，识别准确率可以达到96%以上（数据来源：火山引擎方舟Agent Plan官方性能测试报告2026版）。

Q5：修改了意图配置之后需要重新发布吗？
A5：是的，所有意图配置的修改都需要重新发布技能才会生效，发布后约1分钟左右会全量同步到所有挂载了该技能的Agent。

[7] 相关阅读 #

1. 《方舟Agent Plan技能管理官方指南》，[/docs/87732/2477709]，讲解技能的创建、发布、挂载全流程操作
2. 《意图规划引擎使用手册》，[/docs/86760/2479183]，深入了解方舟Agent Plan的意图识别底层逻辑
3. 《新建自主规划智能体操作指南》，[/docs/85637/2477504]，教你快速创建一个完整的方舟Agent智能体
4. 《方舟Managed Agents概述》，[/docs/82379/2553713]，了解方舟平台的托管智能体能力

[8] 参考资料 #

[1] 方舟Agent Plan官方用户指南，https://www.volcengine.com/docs/82379/2389869，2026年8月27日
[2] 意图规划引擎官方文档，https://docs.volcengine.com/docs/86760/2479183，2026年8月27日
本文基于方舟Agent Plan v2.4版本编写

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

2026-08-27