Google 操作 API Heroku nodejs 上的 webhook 响应
Google Actions API webhook response on Heroku nodejs
问题：
Google 操作是否总是通过在每个用户输入上触发 webhook post 来工作，我只需要处理逻辑以便每次解析 json 并且仅当我感兴趣的参数是成立？或者是否有一种方法可以控制由 Google Actions API 生成的 webhook post，以便仅在通过包含感兴趣参数的值完全填充操作时才生成它？
#
详情：
我已经在 Heroku 上部署了这个 nodejs 应用程序：
https://github.com/quique123/myjsonparser/blob/master/app.js
我将其用作 Google 操作 API（数字精灵）示例的 Webhook。在 Number Genie 中，用户使用 "Talk to number genie" 开始游戏。精灵回答说我在想一个数字……猜猜看。用户响应一个数字，然后（并且只有那时）逻辑是 运行 将猜测与答案进行比较。
但是我收到来自 google 家的每个 post 请求的 api 呼叫。换句话说，每当用户与对话 api 进行交互时，都会创建 webhook post。可以在此处看到主体不包含用户输入参数并且 Heroku 响应 "talk to number genie":
2017-04-30T18:59:19.480900+00:00 heroku[router]: at=info method=POST path="/API/switches/sw1?password=123456" host=myjsonparser.herokuapp.com request_id=64d51b1c-3253-4a64-b7f5-a29a7750945b fwd="54.224.155.160" dyno=web.1 connect=1ms service=35ms status=200 bytes=254 protocol=https
2017-04-30T18:59:19.473973+00:00 app[web.1]: headers: {"host":"myjsonparser.herokuapp.com","connection":"close","accept":"*/*","content-type":"application/json; charset=UTF-8","cache-control":"no-cache","pragma":"no-cache","user-agent":"Java/1.8.0_112","x-request-id":"64d51b1c-3253-4a64-b7f5-a29a7750945b","x-forwarded-for":"54.224.155.160","x-forwarded-proto":"https","x-forwarded-port":"443","via":"1.1 vegur","connect-time":"1","x-request-start":"1493578759443","total-route-time":"0","content-length":"575"}
2017-04-30T18:59:19.474002+00:00 app[web.1]: body: {"id":"14797289-b0b8-492a-b030-bf9f05c7ea17","timestamp":"2017-04-30T18:59:19.413Z","lang":"en","result":{"source":"agent","resolvedQuery":"talk to number genie","speech":"","action":"generate_answer","actionIncomplete":false,"parameters":{},"contexts":[],"metadata":{"intentId":"688b0da5-547e-4c7a-8adc-189844834bcc","webhookUsed":"true","webhookForSlotFillingUsed":"false","intentName":"start_game"},"fulfillment":{"speech":"","messages":[{"type":0,"speech":""}]},"score":0.61},"status":{"code":200,"errorType":"success"},"sessionId":"ff2e0c97-552b-40d3-8f06-32e612476897"}
2017-04-30T18:59:19.477116+00:00 app[web.1]: postSwitch {"id":"sw1","state":"off","name":"Koko's Lamp"}
当我在 Google 操作 API 上使用数字测试它时，您可以在 Heroku 对“44”的响应中看到包含 check_guess：
2017-04-30T19:00:31.901297+00:00 app[web.1]: headers: {"host":"myjsonparser.herokuapp.com","connection":"close","accept":"*/*","content-type":"application/json; charset=UTF-8","cache-control":"no-cache","pragma":"no-cache","user-agent":"Java/1.8.0_112","x-request-id":"5a7a2c31-9ce5-4b02-9bac-bcef55ad6818","x-forwarded-for":"54.224.155.160","x-forwarded-proto":"https","x-forwarded-port":"443","via":"1.1 vegur","connect-time":"1","x-request-start":"1493578831899","total-route-time":"0","content-length":"573"}
2017-04-30T19:00:31.901347+00:00 app[web.1]: body: {"id":"5478dfb5-54f3-451d-b975-4f984d1ce3cb","timestamp":"2017-04-30T19:00:31.858Z","lang":"en","result":{"source":"agent","resolvedQuery":"44","speech":"","action":"check_guess","actionIncomplete":false,"parameters":{"check_guess":"44"},"contexts":[],"metadata":{"intentId":"c863e1e2-c850-45d8-9b96-b57e0b1ee77e","webhookUsed":"true","webhookForSlotFillingUsed":"false","intentName":"provide_guess"},"fulfillment":{"speech":"","messages":[{"type":0,"speech":""}]},"score":1},"status":{"code":200,"errorType":"success"},"sessionId":"ff2e0c97-552b-40d3-8f06-32e612476897"}
2017-04-30T19:00:31.903553+00:00 app[web.1]: postSwitch {"id":"sw1","state":"on","name":"Koko's Lamp"}
2017-04-30T19:00:31.907017+00:00 heroku[router]: at=info method=POST path="/API/switches/sw1?password=123456" host=myjsonparser.herokuapp.com request_id=5a7a2c31-9ce5-4b02-9bac-bcef55ad6818 fwd="54.224.155.160" dyno=web.1 connect=1ms service=5ms status=200 bytes=253 protocol=https
问题是 postSwitch{} 在这两种情况下都会发生。
这是 Google 操作始终有效的方式吗，我只需要处理逻辑以便每次都解析 json 并仅在找到 check_guess 时做出反应？或者有没有一种方法可以控制 Google 动作 API 制作的 webhook post，以便仅在通过包含参数 [=31] 的值完全填充动作时制作它=]?
您只能设置一个 webhook（一个静态 URL），它将为使用 API.AI 触发的所有操作调用。虽然您需要解析 JSON（您使用的是 node.js，JSON.parse() 并不难），但您应该使用 result.action 字段而不是试图找出设置了哪些参数。这将对应于您在 API.AI 中设置的操作字段。
当然，这假定您已为您的操作选中了 webhook 框。否则，您根本不会收到 webhook 调用。
因此，例如，初始意图配置如下：
它会将此 JSON 发送到您的 webhook。
{
"originalRequest": {
"source": "google",
"data": {
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"inputs": [
{
"arguments": [],
"intent": "assistant.intent.action.MAIN",
"raw_inputs": [
{
"query": "talk to number genie",
"input_type": 2,
"annotation_sets": []
}
]
}
],
"user": {
"user_id": "kQmX8nX9ovcS9jfb3WKmwLk9YFlHGZH05YGbc8muNI8=",
"permissions": []
},
"device": {
"locale": "en-US"
},
"is_in_sandbox": true,
"conversation": {
"conversation_id": "1493637016599",
"type": 1
}
}
},
"id": "9444bfe4-3c23-487a-84e7-fcbf1708d9e3",
"timestamp": "2017-05-01T11:10:16.694Z",
"lang": "en",
"result": {
"source": "agent",
"resolvedQuery": "GOOGLE_ASSISTANT_WELCOME",
"speech": "",
"action": "generate_answer",
"actionIncomplete": false,
"parameters": {},
"contexts": [
{
"name": "game",
"parameters": {},
"lifespan": 5
},
{
"name": "google_assistant_welcome",
"parameters": {},
"lifespan": 0
},
{
"name": "actions_capability_audio_output",
"parameters": {},
"lifespan": 0
}
],
"metadata": {
"intentId": "56da4637-0419-46b2-b851-d7bf726b1b1b",
"webhookUsed": "true",
"webhookForSlotFillingUsed": "false",
"intentName": "start_game"
},
"fulfillment": {
"speech": "",
"messages": [
{
"type": 0,
"speech": ""
}
]
},
"score": 1
},
"status": {
"code": 200,
"errorType": "success"
},
"sessionId": "1493637016599"
}
虽然 provide_guess 意图可能是这样配置的
并将此 JSON 提供给 webhook：
{
"originalRequest": {
"source": "google",
"data": {
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"inputs": [
{
"arguments": [
{
"raw_text": "42",
"text_value": "42",
"name": "text"
}
],
"intent": "assistant.intent.action.TEXT",
"raw_inputs": [
{
"query": "42",
"input_type": 2,
"annotation_sets": []
}
]
}
],
"user": {
"user_id": "kQmX8nX9ovcS9jfb3WKmwLk9YFlHGZH05YGbc8muNI8=",
"permissions": []
},
"device": {
"locale": "en-US"
},
"is_in_sandbox": true,
"conversation": {
"conversation_token": "[\"_actions_on_google_\",\"game\"]",
"conversation_id": "1493637749915",
"type": 2
}
}
},
"id": "09997ef5-5c0f-4c60-a69f-af06d6e4e3f5",
"timestamp": "2017-05-01T11:22:34.377Z",
"lang": "en",
"result": {
"source": "agent",
"resolvedQuery": "42",
"speech": "",
"action": "check_guess",
"actionIncomplete": false,
"parameters": {
"guess": "42"
},
"contexts": [
{
"name": "game",
"parameters": {
"guess.original": "42",
"guess": "42"
},
"lifespan": 5
},
{
"name": "_actions_on_google_",
"parameters": {
"guessCount": 0,
"printed": "Welcome back to Number Genie. I'm thinking of a number from %s to %s. What's your first guess?",
"guess.original": "42",
"answer": 74,
"guess": "42",
"lastPrompt": "Welcome back to Number Genie. I'm thinking of a number from %s to %s. What's your first guess?",
"steamSoundCount": 0,
"fallbackCount": 0
},
"lifespan": 99
},
{
"name": "actions_capability_audio_output",
"parameters": {
"guess.original": "42",
"guess": "42"
},
"lifespan": 0
}
],
"metadata": {
"intentId": "1e46ffc2-651f-4ac0-a54e-9698feb88880",
"webhookUsed": "true",
"webhookForSlotFillingUsed": "false",
"intentName": "provide_guess"
},
"fulfillment": {
"speech": "",
"messages": [
{
"type": 0,
"speech": ""
}
]
},
"score": 1
},
"status": {
"code": 200,
"errorType": "success"
},
"sessionId": "1493637749915"
}
在您的代码中，您将在 postSwitch() 方法中检查 result.action 的值，然后可以 select 根据此操作（generateAnswer() 或 checkGuess() 根据您注释掉的代码）。
问题： Google 操作是否总是通过在每个用户输入上触发 webhook post 来工作，我只需要处理逻辑以便每次解析 json 并且仅当我感兴趣的参数是成立？或者是否有一种方法可以控制由 Google Actions API 生成的 webhook post，以便仅在通过包含感兴趣参数的值完全填充操作时才生成它？
#详情： 我已经在 Heroku 上部署了这个 nodejs 应用程序： https://github.com/quique123/myjsonparser/blob/master/app.js
我将其用作 Google 操作 API（数字精灵）示例的 Webhook。在 Number Genie 中，用户使用 "Talk to number genie" 开始游戏。精灵回答说我在想一个数字……猜猜看。用户响应一个数字，然后（并且只有那时）逻辑是 运行 将猜测与答案进行比较。
但是我收到来自 google 家的每个 post 请求的 api 呼叫。换句话说，每当用户与对话 api 进行交互时，都会创建 webhook post。可以在此处看到主体不包含用户输入参数并且 Heroku 响应 "talk to number genie":
2017-04-30T18:59:19.480900+00:00 heroku[router]: at=info method=POST path="/API/switches/sw1?password=123456" host=myjsonparser.herokuapp.com request_id=64d51b1c-3253-4a64-b7f5-a29a7750945b fwd="54.224.155.160" dyno=web.1 connect=1ms service=35ms status=200 bytes=254 protocol=https
2017-04-30T18:59:19.473973+00:00 app[web.1]: headers: {"host":"myjsonparser.herokuapp.com","connection":"close","accept":"*/*","content-type":"application/json; charset=UTF-8","cache-control":"no-cache","pragma":"no-cache","user-agent":"Java/1.8.0_112","x-request-id":"64d51b1c-3253-4a64-b7f5-a29a7750945b","x-forwarded-for":"54.224.155.160","x-forwarded-proto":"https","x-forwarded-port":"443","via":"1.1 vegur","connect-time":"1","x-request-start":"1493578759443","total-route-time":"0","content-length":"575"}
2017-04-30T18:59:19.474002+00:00 app[web.1]: body: {"id":"14797289-b0b8-492a-b030-bf9f05c7ea17","timestamp":"2017-04-30T18:59:19.413Z","lang":"en","result":{"source":"agent","resolvedQuery":"talk to number genie","speech":"","action":"generate_answer","actionIncomplete":false,"parameters":{},"contexts":[],"metadata":{"intentId":"688b0da5-547e-4c7a-8adc-189844834bcc","webhookUsed":"true","webhookForSlotFillingUsed":"false","intentName":"start_game"},"fulfillment":{"speech":"","messages":[{"type":0,"speech":""}]},"score":0.61},"status":{"code":200,"errorType":"success"},"sessionId":"ff2e0c97-552b-40d3-8f06-32e612476897"}
2017-04-30T18:59:19.477116+00:00 app[web.1]: postSwitch {"id":"sw1","state":"off","name":"Koko's Lamp"}
当我在 Google 操作 API 上使用数字测试它时，您可以在 Heroku 对“44”的响应中看到包含 check_guess：
2017-04-30T19:00:31.901297+00:00 app[web.1]: headers: {"host":"myjsonparser.herokuapp.com","connection":"close","accept":"*/*","content-type":"application/json; charset=UTF-8","cache-control":"no-cache","pragma":"no-cache","user-agent":"Java/1.8.0_112","x-request-id":"5a7a2c31-9ce5-4b02-9bac-bcef55ad6818","x-forwarded-for":"54.224.155.160","x-forwarded-proto":"https","x-forwarded-port":"443","via":"1.1 vegur","connect-time":"1","x-request-start":"1493578831899","total-route-time":"0","content-length":"573"}
2017-04-30T19:00:31.901347+00:00 app[web.1]: body: {"id":"5478dfb5-54f3-451d-b975-4f984d1ce3cb","timestamp":"2017-04-30T19:00:31.858Z","lang":"en","result":{"source":"agent","resolvedQuery":"44","speech":"","action":"check_guess","actionIncomplete":false,"parameters":{"check_guess":"44"},"contexts":[],"metadata":{"intentId":"c863e1e2-c850-45d8-9b96-b57e0b1ee77e","webhookUsed":"true","webhookForSlotFillingUsed":"false","intentName":"provide_guess"},"fulfillment":{"speech":"","messages":[{"type":0,"speech":""}]},"score":1},"status":{"code":200,"errorType":"success"},"sessionId":"ff2e0c97-552b-40d3-8f06-32e612476897"}
2017-04-30T19:00:31.903553+00:00 app[web.1]: postSwitch {"id":"sw1","state":"on","name":"Koko's Lamp"}
2017-04-30T19:00:31.907017+00:00 heroku[router]: at=info method=POST path="/API/switches/sw1?password=123456" host=myjsonparser.herokuapp.com request_id=5a7a2c31-9ce5-4b02-9bac-bcef55ad6818 fwd="54.224.155.160" dyno=web.1 connect=1ms service=5ms status=200 bytes=253 protocol=https
问题是 postSwitch{} 在这两种情况下都会发生。
这是 Google 操作始终有效的方式吗，我只需要处理逻辑以便每次都解析 json 并仅在找到 check_guess 时做出反应？或者有没有一种方法可以控制 Google 动作 API 制作的 webhook post，以便仅在通过包含参数 [=31] 的值完全填充动作时制作它=]?
您只能设置一个 webhook（一个静态 URL），它将为使用 API.AI 触发的所有操作调用。虽然您需要解析 JSON（您使用的是 node.js，JSON.parse() 并不难），但您应该使用 result.action 字段而不是试图找出设置了哪些参数。这将对应于您在 API.AI 中设置的操作字段。
当然，这假定您已为您的操作选中了 webhook 框。否则，您根本不会收到 webhook 调用。
因此，例如，初始意图配置如下：
它会将此 JSON 发送到您的 webhook。
{
"originalRequest": {
"source": "google",
"data": {
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"inputs": [
{
"arguments": [],
"intent": "assistant.intent.action.MAIN",
"raw_inputs": [
{
"query": "talk to number genie",
"input_type": 2,
"annotation_sets": []
}
]
}
],
"user": {
"user_id": "kQmX8nX9ovcS9jfb3WKmwLk9YFlHGZH05YGbc8muNI8=",
"permissions": []
},
"device": {
"locale": "en-US"
},
"is_in_sandbox": true,
"conversation": {
"conversation_id": "1493637016599",
"type": 1
}
}
},
"id": "9444bfe4-3c23-487a-84e7-fcbf1708d9e3",
"timestamp": "2017-05-01T11:10:16.694Z",
"lang": "en",
"result": {
"source": "agent",
"resolvedQuery": "GOOGLE_ASSISTANT_WELCOME",
"speech": "",
"action": "generate_answer",
"actionIncomplete": false,
"parameters": {},
"contexts": [
{
"name": "game",
"parameters": {},
"lifespan": 5
},
{
"name": "google_assistant_welcome",
"parameters": {},
"lifespan": 0
},
{
"name": "actions_capability_audio_output",
"parameters": {},
"lifespan": 0
}
],
"metadata": {
"intentId": "56da4637-0419-46b2-b851-d7bf726b1b1b",
"webhookUsed": "true",
"webhookForSlotFillingUsed": "false",
"intentName": "start_game"
},
"fulfillment": {
"speech": "",
"messages": [
{
"type": 0,
"speech": ""
}
]
},
"score": 1
},
"status": {
"code": 200,
"errorType": "success"
},
"sessionId": "1493637016599"
}
虽然 provide_guess 意图可能是这样配置的
并将此 JSON 提供给 webhook：
{
"originalRequest": {
"source": "google",
"data": {
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"inputs": [
{
"arguments": [
{
"raw_text": "42",
"text_value": "42",
"name": "text"
}
],
"intent": "assistant.intent.action.TEXT",
"raw_inputs": [
{
"query": "42",
"input_type": 2,
"annotation_sets": []
}
]
}
],
"user": {
"user_id": "kQmX8nX9ovcS9jfb3WKmwLk9YFlHGZH05YGbc8muNI8=",
"permissions": []
},
"device": {
"locale": "en-US"
},
"is_in_sandbox": true,
"conversation": {
"conversation_token": "[\"_actions_on_google_\",\"game\"]",
"conversation_id": "1493637749915",
"type": 2
}
}
},
"id": "09997ef5-5c0f-4c60-a69f-af06d6e4e3f5",
"timestamp": "2017-05-01T11:22:34.377Z",
"lang": "en",
"result": {
"source": "agent",
"resolvedQuery": "42",
"speech": "",
"action": "check_guess",
"actionIncomplete": false,
"parameters": {
"guess": "42"
},
"contexts": [
{
"name": "game",
"parameters": {
"guess.original": "42",
"guess": "42"
},
"lifespan": 5
},
{
"name": "_actions_on_google_",
"parameters": {
"guessCount": 0,
"printed": "Welcome back to Number Genie. I'm thinking of a number from %s to %s. What's your first guess?",
"guess.original": "42",
"answer": 74,
"guess": "42",
"lastPrompt": "Welcome back to Number Genie. I'm thinking of a number from %s to %s. What's your first guess?",
"steamSoundCount": 0,
"fallbackCount": 0
},
"lifespan": 99
},
{
"name": "actions_capability_audio_output",
"parameters": {
"guess.original": "42",
"guess": "42"
},
"lifespan": 0
}
],
"metadata": {
"intentId": "1e46ffc2-651f-4ac0-a54e-9698feb88880",
"webhookUsed": "true",
"webhookForSlotFillingUsed": "false",
"intentName": "provide_guess"
},
"fulfillment": {
"speech": "",
"messages": [
{
"type": 0,
"speech": ""
}
]
},
"score": 1
},
"status": {
"code": 200,
"errorType": "success"
},
"sessionId": "1493637749915"
}
在您的代码中，您将在 postSwitch() 方法中检查 result.action 的值，然后可以 select 根据此操作（generateAnswer() 或 checkGuess() 根据您注释掉的代码）。