《Dialogflow零基础入门教程》5 实践案例2 -- 使用Webhook实现智能回复-CSDN博客

本文链接：https://blog.csdn.net/qq_41611586/article/details/147394085

5.1 Webhook工作原理详解（简单易懂）

什么是Webhook？

Webhook的比喻：
- 想象Dialogflow是一个接待顾客的前台服务员，当顾客提出简单问题（比如询问营业时间），服务员（Dialogflow）自己就能直接回答。
- 当顾客提出复杂问题（比如“今天有什么特价菜”），前台服务员需要跑到厨房（Webhook后端）去问厨师拿菜单，然后再告诉顾客。

Webhook本质就是一种回调机制，Dialogflow通过它向你自己的程序（服务器）发送请求，由你的程序处理逻辑，然后再返回响应。

Dialogflow如何与Webhook交互？

用户提出问题 → Dialogflow识别意图 → 若需要Webhook →
   Dialogflow发出HTTP请求 → 你的后端程序(Webhook)收到请求并处理 →
      返回结果 → Dialogflow再返回给用户

图示说明：

用户: 「给我讲个笑话」
   ↓
Dialogflow: （识别到"讲笑话"意图）
   ↓ 发HTTP请求
Webhook (后端): 收到请求，随机选一个笑话
   ↓ 返回笑话内容
Dialogflow:
   ↓ 回复
用户收到笑话

5.2 编写Webhook后端程序（零基础示例）

常用编程语言简单介绍：

Node.js：适合零基础，容易上手，语法简洁，社区活跃。
Python：语法直观，库丰富，适合初学者，常用于AI、数据分析。

本节以 Python 为例，演示如何编写一个简单的随机笑话API。

示例：随机笑话Webhook（Python Flask版）

步骤一：安装基础环境

pip install flask

步骤二：编写Webhook程序

创建文件 app.py：

from flask import Flask, request, jsonify
import random

app = Flask(__name__)

# 笑话列表
jokes = [
    "为什么蚂蚁不会生病？因为它有抗体。",
    "小明把作业交了上去，老师发现是空白的，小明解释说：“这是无字天书。”",
    "一只鸡走进了KFC，问服务员：“你们这里招人吗？”",
]

@app.route('/webhook', methods=['POST'])
def webhook():
    req = request.get_json(force=True)

    # 从Dialogflow请求中获取意图名
    intent = req.get('queryResult').get('intent').get('displayName')

    if intent == "tell_joke":
        joke = random.choice(jokes)
        return jsonify({
            "fulfillmentText": joke
        })
    else:
        return jsonify({
            "fulfillmentText": "抱歉，我不太明白你的意思。"
        })

if __name__ == '__main__':
    app.run(port=5000)

程序说明：

Flask建立了一个简单服务器，监听Dialogflow的POST请求。
Dialogflow发送用户意图，程序接收后返回随机一个笑话。

5.3 部署Webhook并连接Dialogflow

Webhook程序通常部署在云端，本教程使用免费、简单的 Google Cloud Functions 作为示例。

步骤一：部署到Google Cloud Functions

登录 Google Cloud控制台
新建函数：
- 名称：dialogflowWebhook
- 触发器类型：HTTP
- 身份验证：允许未验证调用（初学简单，实际生产时需验证）
- 运行时环境选择：Python 3.x
在编辑器里复制以下代码：

import random

def dialogflowWebhook(request):
    req = request.get_json(silent=True)

    jokes = [
        "为什么蚂蚁不会生病？因为它有抗体。",
        "小明把作业交了上去，老师发现是空白的，小明解释说：“这是无字天书。”",
        "一只鸡走进了KFC，问服务员：“你们这里招人吗？”",
    ]

    intent = req.get('queryResult').get('intent').get('displayName')

    if intent == "tell_joke":
        joke = random.choice(jokes)
        return {
            "fulfillmentText": joke
        }
    else:
        return {
            "fulfillmentText": "抱歉，我没理解您的意思。"
        }

点击“部署”按钮，即可完成部署。

步骤二：连接Dialogflow

在Dialogflow控制台里打开你的项目。
在左侧菜单选择Fulfillment（履行）。
启用Webhook功能。
将Cloud Functions部署后生成的HTTP网址填写到Webhook URL处。
保存设置。

5.4 测试与调试

使用Dialogflow内置模拟器测试

在Dialogflow右侧模拟器输入测试内容：
```
给我讲个笑话
```
如果正常，会得到随机的笑话回复。

常见问题及解决技巧：

问题：Dialogflow提示Webhook调用失败。
- 检查Webhook URL是否正确。
- 确认云函数是否部署成功（访问云函数页面测试）。
问题：云函数无法启动或出现错误。
- 查看Google Cloud Functions的日志信息（Logging日志页面）。
- 检查代码是否完整复制，尤其注意格式与缩进。