无法在Watson Assistant自定义扩展中查看响应元素

DevOps 小满

2026-7-22

解决Watson Assistant自定义扩展无法访问JSON响应内容的问题

完善Swagger响应Schema的具体结构
当前Swagger里的响应Schema仅声明了type: object，过于宽泛，Watson Assistant无法识别具体字段，需要将实际返回的JSON结构完整定义在properties中。比如你的接口返回结构为{"user_id": "123", "user_info": {"name": "test", "email": "test@example.com"}}，修改后的Swagger响应部分如下：

"responses": {
  "200": {
    "description": "OK",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "user_id": {"type": "string"},
            "user_info": {
              "type": "object",
              "properties": {
                "name": {"type": "string"},
                "email": {"type": "string"}
              }
            }
          }
        }
      }
    }
  }
}

注意要和接口实际返回的JSON字段、类型完全匹配，包括嵌套层级。

验证Swagger文件的语法正确性
使用Swagger编辑器检查文件是否存在语法错误，比如括号不闭合、字段拼写错误、类型定义不规范等，语法问题会导致Watson Assistant无法正确解析Schema。
重新导入扩展并配置变量映射
修改Swagger后，重新将其导入到Watson Assistant的扩展中。在技能的对话流程里添加扩展调用步骤时，手动将响应字段映射到对话变量（比如把response.user_info.name映射到$user_name），这样才能在后续对话逻辑中访问这些字段值。
检查扩展执行日志
在Watson Assistant控制台查看扩展的执行日志，确认接口实际返回的JSON结构和Swagger中定义的是否一致。如果实际返回字段和Schema定义不匹配，Watson Assistant依然无法识别对应字段。
临时使用原始响应变量
如果暂时无法完善Schema，可以尝试使用Watson Assistant提供的原始响应变量直接获取完整JSON，再通过JSON路径表达式提取所需字段（比如$extension_response.raw.user_info.name，具体变量名以Watson Assistant实际提供为准）。