node.js - 如何使用 Google Home (DialogFlow) 在 NodeJS 中设置 session 变量

Question

我正在为 Google Home 编写我的第一个 NodeJS 应用程序(使用 DialogFlow - 以前称为 API.ai)。

我正在查看此页面上的文档:https://developers.google.com/actions/reference/v1/dialogflow-webhook

但我没有看到任何设置 session 变量的方法。

我当前的测试程序设置的语音如下:

 speechText = "I'm not sure that character exists!";
 callback(null, {"speech": speechText});

在 DialogFlow 中，运行后我的 JSON 看起来像这样，看起来“上下文”可能是 session 状态所在的位置？

{
    "id": "3a66f4d1-830e-48fb-b72d-12711ecb1937",
    "timestamp": "2017-11-24T23:03:20.513Z",
    "lang": "en",
    "result": {
        "source": "agent",
        "resolvedQuery": "test word",
        "action": "MyAction",
        "actionIncomplete": false,
        "parameters": {
            "WordNumber": "400"
        },
        "contexts": [],
        "metadata": {
            "intentId": "a306b829-7c7a-46fb-ae1d-2feb1c309124",
            "webhookUsed": "true",
            "webhookForSlotFillingUsed": "false",
            "webhookResponseTime": 752,
            "intentName": "MyIntentName"
        },
        "fulfillment": {
            "messages": [{
                "type": 0,
                "speech": ""
            }]
        },
        "score": 1
    },
    "status": {
        "code": 200,
        "errorType": "success",
        "webhookTimedOut": false
    },
    "sessionId": "fe0b7d9d-7a55-45db-9be9-75149ff084fe"
}

我刚刚从我购买的聊天机器人类(class)中注意到，您可以像这样设置上下文，但仍然不确定上下文如何设置以及如何在我的程序对请求的一次调用的响应之间来回传递在我的程序的下一次调用中(通过“webhook”定义)。 当我添加上面的上下文时，DialogFlow 将不再识别我的话语，并给我 DefaultFallback 响应。当我删除它们时，我的 AWS Lambda 会被调用。

Answer 1

对于初学者来说，您正在查看的文档页面指的是已弃用的 API 版本。谈论当前版本 api (v2) 的页面是 https://developers.google.com/actions/dialogflow/webhook 。已弃用的版本将仅支持 6 个月左右的时间。

使用Contexts，您走在正确的道路上!如果您使用 Google 的 actions-on-google node.js 库，则会有一些额外的选项 - 但它们都在场景下使用上下文。 (并且由于他们确实在场景下使用上下文 - 您应该确保选择与他们不同的上下文名称。)您还可以使用 sessionId 并跟踪本地数据存储中的内容(例如 DynamoDB)根据该 SessionID 建立索引。但其他选项已经足够了......

上下文由三个元素组成:

1. 一个名字。
2. 生命周期 - 此上下文将被发送回给您多少条来自用户的消息。 (但请参阅下面有关重新发送上下文的内容。)
3. 键值字符串对象。

您将在 JSON 中设置任何上下文，并将其作为名为 contextOut 的附加参数返回。这将是一个上下文数组。因此您的回复可能如下所示:

var speechText = "I'm not sure that character exists!";
var sessionContext = {
  name: "session_variables",
  lifespan: 5,
  parameters: {
    "remember": "one",
    "something": "two"
  }
};
var contextOut = [sessionContext];
var response = {
  speech: speechText,
  contextOut: context
};
callback(null, response);

这将包括一个名为“session_variables”的上下文，它存储两个这样的变量。它将在接下来发送到您的 webhook 的 5 条消息中返回。但是，您可以将其添加到您发送的每条消息中，最新的生命周期和参数将是下次发送回来的内容。

您将在发送给您的 JSON 中的 result.contexts 数组中获取这些上下文。

意图屏幕上的“上下文”字段在 Dialogflow 中除了保留 session 信息之外还有其他用途。这表示当短语尝试与其匹配时(或处理后备意图时)，仅如果指定的上下文存在(生命周期 > 0)，则触发该意图。如果您使用网络钩子(Hook)，并且您自己发回上下文，则“上下文输出”字段将被忽略。

这可以让您执行一些操作，例如提出特定问题并设置上下文(可能带有参数)以指示某些答案应被理解为对您刚刚提出的问题的答复。