V1应用迁移API V2：followupEvent调用intent功能异常求助

嘿，我懂你在从V1迁移到新版API V2时遇到followupEvent功能的麻烦了——这种意图联动的场景在版本切换时确实容易踩坑，咱们来一步步搞定它！

1. 先修正followupEvent的响应格式（V2和V1的核心差异） #

这是迁移时最容易出错的点！V1里的followupEvent字段在V2里已经改成了followupEventInput，而且参数必须放在parameters对象里，还得加上语言代码才能生效。给你个正确的Webhook响应示例，你可以对照着调整：

{
  "followupEventInput": {
    "name": "unknown_zone",
    "parameters": {
      "zone": "用户输入的未知房间名" // 这里填你从light_on意图里拿到的无效zone值
    },
    "languageCode": "zh-CN" // 替换成你实际使用的语言代码
  }
}

2. 检查unknown_zone意图的参数配置 #

• 首先得确保unknown_zone意图里确实存在名为zone的参数，而且参数的实体类型要和你传递的内容匹配（比如用@sys.any或者你自定义的区域实体）。
• 另外你回复模板里写的#unknown_zone.zone其实可以简化成#zone，因为当前触发的就是unknown_zone意图，直接引用参数名就能正确读取值啦。
• 别忘了给unknown_zone意图加几个带参数的训练短语，比如「我不认识名为#zone的区域」，这样Dialogflow才能更好地关联参数和回复。

3. 处理上下文干扰问题 #

如果你的light_on意图设置了输出上下文，这些上下文可能会影响followupEvent触发的unknown_zone意图，导致参数无法正常传递。这时候你可以在followupEventInput里加上resetContexts: true，清除当前会话的上下文，保证unknown_zone意图能干净地接收参数：

{
  "followupEventInput": {
    "name": "unknown_zone",
    "parameters": {
      "zone": "用户输入的未知房间名"
    },
    "languageCode": "zh-CN",
    "resetContexts": true
  }
}

4. 用控制台诊断排查问题 #

测试的时候一定要去Dialogflow控制台的「历史记录」里查看会话详情：

• 如果参数显示为空，说明Webhook的响应格式有问题，回到第一步检查字段名和结构；
• 如果参数存在但回复里没显示，就检查回复模板的变量引用是不是写错了。

内容的提问来源于stack exchange，提问作者Florent Guillaume