如何在Watson Assistant的action skills中调用webhook对接endpoint存储数据

1. 先完成Webhook基础配置 #

• 打开当前开发的Watson Assistant实例，进入目标Action Skills的编辑界面
• 点击左侧边栏「设置」选项，找到Webhook分类进入配置页
• 在「请求URL」输入框填写你开发好的数据库插入endpoint的完整访问地址
• 如果你的endpoint有身份校验要求，在「认证」模块选择对应鉴权方式，填写密钥、访问Token等必要信息，完成后保存配置

2. 在对话节点中设置Webhook触发逻辑 #

• 找到需要触发数据入库的对话节点（通常是所有需存储的信息收集完成后的下一个节点）
• 进入节点编辑页，找到自定义操作模块，选择「调用webhook」
• 按你endpoint的传参要求配置请求参数，将需要存入数据库的上下文变量、用户输入内容映射为请求参数。比如你的接口接收JSON格式POST请求，可配置如下格式的请求体：

{
  "user_name": "$session.user_name",
  "consult_content": "$latest_input.text",
  "submit_time": "$system_time"
}

• 配置调用后的分支处理规则：
  • 调用成功场景：设置后续跳转的对话分支，配置对应提示话术即可
  • 调用失败场景：设置重试次数，或者跳转至报错分支给用户返回友好提示，避免对话卡死

3. 调试验证流程 #

• 用Watson Assistant自带的预览调试工具走完完整对话流程，触发webhook调用
• 查看你的endpoint服务的请求日志，确认传参是否符合预期，数据库是否成功写入对应数据
• 如果出现调用异常，可在Watson Assistant调试面板查看webhook的返回状态码和返回内容，定位是传参错误、鉴权错误还是endpoint本身的服务问题

注意事项 #

• 若你的endpoint部署在内网环境，需要先开通公网可访问的地址，或者配置Watson Assistant的私有网络访问规则，确保IBM云服务能正常请求到你的接口
• 涉及用户隐私的敏感数据，建议先在上下文变量中做脱敏处理再传给endpoint，降低数据泄露风险

内容的提问来源于stack exchange，提问作者Elie Long