多意图使用最佳实践指南

1. 多意图是什么

多意图是指：用户在一条指令中表达多个独立诉求时，AI 助手自动将其识别为多个意图，并按照用户所述顺序依次执行完成。

• 关闭多意图：帮我打开空调，把温度调到26度，再放首歌 → 只执行一个意图，其余诉求丢失或答非所问
• 开启多意图：同上 → 依次完成「开空调」「调温 26 度」「播放音乐」三个动作

对语音交互产品，用户天然习惯「一次说多件事」。多意图能力能把这种自然表达完整接住，提升一句话的完单率，减少反复追问。

2. 使用场景

2.1 适合开启的场景

判断标准：如果产品的话术设计鼓励用户「一次说清多件事」（如设备控制、音乐、信息查询组合），建议开启。

2.2 不建议开启或需谨慎的场景

3. 打开方式

多意图通过服务配置项开启：

1{"multi_intent_enabled": true}

• 开启：在服务配置中将 multi_intent_enable 设为 true 并重启服务生效；
• 默认状态：未配置时默认为关闭（false），不影响原有单意图逻辑；
• 关闭：将配置项改回 false 即可，可随时开关、灰度验证。

生效验证：开启后，用「帮我打开空调然后放首歌」「先查天气再设个闹钟」这类典型话术实测，预期依次完成两个动作。

4. 能力约束（务必了解）

补充说明：包含 FunctionCall 的子意图需要执行完成回执

当拆分出的子意图由 客户端 执行 FunctionCall（如设备控制、点歌等函数调用）时，多意图流程会等待该 FunctionCall 执行完成（含参数补全、语音播报结束）后，才继续执行下一个意图。接入方需保证：

1. 客户端在 FunctionCall 执行完成后，发送执行完成回执（播报结束/执行完成通知），例如:

1[F]:{"session_id":"1754555833139","result":"ok"}

2. 若未收到回执，流程将等待至超时后才继续，表现为后续意图响应变慢，请检查回执是否正常上报。

5. 效果调优建议

1. 从高频话术切入：先用真实用户语料（如「开灯 放歌」）验证拆分效果，再逐步扩大启用范围；
2. 关注识别失败的话术：如果某些话术「本应多意图却没有拆分」，收集后反馈给平台方，按需优化；
3. 上线前用验收话术回归：准备 10~20 条典型话术（含应该拆分与不应该拆分的各一半），作为每次迭代的回归用例。

6. 常见问题

Q：开启后，单条指令的响应变慢了？ 多意图会额外执行一次意图识别，且各意图串行执行。若单意图场景占比高，可评估关闭该能力。

Q：为什么我的多意图指令只执行了一个？ 可能原因：模型判定为单意图；或配置未生效（确认 multi_intent_enable=true 已生效、服务已重启）。可用另一条语料（「先查天气再设闹钟」）对比验证。

Q：希望两个意图同时执行（如同时开灯和空调）？ 当前能力为串行执行，不支持并行。若确需并行，请与我们对齐使用场景 或 与我们联系。