การออกจากการสนทนา (Dialogflow)

ลองใช้ข้อมูลโค้ด: นำเข้า ทำให้ใช้งานได้ และสำรวจข้อมูลโค้ดในบริบทโดยใช้ Agent ใหม่ของ Dialogflow

สำรวจใน Dialogflow

สำรวจใน Dialogflow

คลิกต่อไปเพื่อนำเข้าตัวอย่างการออกจากการสนทนาใน Dialogflow จากนั้นทำตามขั้นตอนด้านล่างเพื่อทำให้ใช้งานได้และทดสอบตัวอย่าง

1. ป้อนชื่อตัวแทนและสร้าง Agent ใหม่ใน Dialogflow สำหรับตัวอย่าง
2. หลังจากนำเข้า Agent เสร็จแล้ว ให้คลิกไปที่ Agent
3. จากเมนูการนำทางหลัก ให้ไปที่การดำเนินการคำสั่งซื้อ
4. เปิดใช้ตัวแก้ไขในบรรทัด แล้วคลิกทำให้ใช้งานได้ ซึ่งตัวแก้ไขจะมีโค้ดตัวอย่าง
5. จากเมนูการนําทางหลัก ให้ไปที่ Integrations แล้วคลิก Google Assistant
6. ในหน้าต่างโมดัลที่ปรากฏ ให้เปิดใช้แสดงตัวอย่างการเปลี่ยนแปลงอัตโนมัติ และคลิกทดสอบเพื่อเปิดเครื่องจำลองการดำเนินการ
7. ในเครื่องจำลอง ให้ป้อน Talk to my test app เพื่อทดสอบตัวอย่าง

ดำเนินการต่อ ยกเลิก

เมื่อใดก็ตามที่ผู้ใช้ต้องการออกจากการสนทนากลางการสนทนา ผู้ใช้สามารถพูดข้อความดังนี้

• "exit"
• "ยกเลิก"
• "stop"
• "ไม่เป็นไร"
• "ลาก่อน"

โดยค่าเริ่มต้น Assistant จะออกจากการสนทนาและเปิดเอียร์คอน หากต้องการลบล้างพฤติกรรมนี้ คุณสามารถเลือกรับคำขอสุดท้าย 1 รายการที่คุณใช้ล้างตรรกะ Fulfillment และตอบกลับผู้ใช้เป็นครั้งสุดท้ายได้ คำตอบสุดท้ายของคุณจะต้องเป็นคำตอบแบบง่ายเพียงคำตอบเดียว ซึ่งมีความยาวได้ไม่เกิน 60 อักขระสำหรับค่า textToSpeech และ displayText

เวลาดำเนินการสูงสุดที่อนุญาตสำหรับคำขอออกจากการสนทนาคือ 2 วินาที ถ้าไม่ได้รับการตอบกลับ การสนทนาจะสิ้นสุดโดยใช้ earcon การออกเริ่มต้น ถ้าการตอบกลับการยกเลิกแบบกำหนดเองล้มเหลว (เนื่องจากมีจำนวนอักขระเกินขีดจำกัด ประเภทการตอบสนองที่ไม่เหมาะสม ฯลฯ) การสนทนาจะยุติลงด้วย Exit earcon ที่เป็นค่าเริ่มต้น

Dialogflow

วิธีรับเหตุการณ์การออกจากการสนทนา

1. ในการนำทางด้านซ้าย ให้คลิกไอคอน + ข้างรายการในเมนูความตั้งใจ
2. ตั้งชื่อให้ Intent (เช่น Exit Conversation) แล้วคลิกส่วนเหตุการณ์
3. ป้อน actions_intent_CANCEL ในช่องเพิ่มเหตุการณ์
4. ระบุการตอบกลับในส่วนการตอบกลับหรือกำหนดคำตอบของคุณเองสำหรับ Intent นี้ในโค้ดเว็บฮุค
5. เปิดใช้ตั้งค่าความตั้งใจนี้เป็นสิ้นสุดการสนทนา
6. คลิกบันทึก
7. คลิกการผสานที่การนำทางด้านซ้าย
8. เลือก Google Assistant แล้วคลิกอัปเดตฉบับร่าง จากนั้นทดสอบเพื่อให้แน่ใจว่าการเปลี่ยนแปลงนั้นแสดงในโปรเจ็กต์

เมื่อผู้ใช้ขอออกจากการสนทนา ระบบจะทริกเกอร์ Intent ที่คุณสร้างและระบบจะส่งการตอบกลับไปยังผู้ใช้ ตัวอย่างเช่น ต่อไปนี้คือโค้ดการดำเนินการตามคำสั่งซื้อที่ใช้ไลบรารีของไคลเอ็นต์เพื่อจัดการความตั้งใจในการยกเลิกและแสดงผลการตอบกลับ

Node.js

const {dialogflow} = require('actions-on-google');
const functions = require('firebase-functions');

const app = dialogflow({debug: true});

app.intent('Exit Conversation', (conv) => {
  conv.close(`Okay, talk to you next time!`);
});

exports.dialogflowFirebaseFulfillment = functions.https.onRequest(app);
index.js

Java

package com.example;

import com.google.actions.api.ActionRequest;
import com.google.actions.api.ActionResponse;
import com.google.actions.api.DialogflowApp;
import com.google.actions.api.ForIntent;
import com.google.actions.api.response.ResponseBuilder;

public class MyActionsApp extends DialogflowApp {

  @ForIntent("Exit Conversation")
  public ActionResponse exit(ActionRequest request) {
    ResponseBuilder responseBuilder = getResponseBuilder(request);
    responseBuilder.add("Okay, talk to you next time!");
    responseBuilder.endConversation();
    return responseBuilder.build();
  }
}
MyActionsApp.java

ขอ JSON

โปรดทราบว่า JSON ด้านล่างอธิบายคำขอเว็บฮุค

{
  "responseId": "e0c9d47f-aa99-4d03-bd48-a64c79e9c2a2-712767ed",
  "queryResult": {
    "queryText": "actions_intent_CANCEL",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "Webhook failed for intent: Exit Conversation",
    "fulfillmentMessages": [
      {
        "text": {
          "text": [
            "Webhook failed for intent: Exit Conversation"
          ]
        }
      }
    ],
    "outputContexts": [
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_audio_output"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_media_response_audio"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_account_linking"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_screen_output"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_web_browser"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/google_assistant_input_type_keyboard"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_intent_cancel"
      }
    ],
    "intent": {
      "name": "projects/df-exits-kohler/agent/intents/b506991f-ad7a-4c4b-8adc-5e6c62727381",
      "displayName": "Exit Conversation"
    },
    "intentDetectionConfidence": 1,
    "languageCode": "en"
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "user": {
        "locale": "en-US",
        "userVerificationStatus": "VERIFIED"
      },
      "conversation": {
        "conversationId": "ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0",
        "type": "ACTIVE",
        "conversationToken": "[]"
      },
      "inputs": [
        {
          "intent": "actions.intent.CANCEL",
          "rawInputs": [
            {
              "inputType": "KEYBOARD",
              "query": "cancel"
            }
          ]
        }
      ],
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.ACCOUNT_LINKING"
          },
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          }
        ]
      },
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            },
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            }
          ]
        }
      ]
    }
  },
  "session": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0"
}

JSON ของการตอบกลับ

โปรดทราบว่า JSON ด้านล่างอธิบายการตอบสนองของเว็บฮุค

{
  "payload": {
    "google": {
      "expectUserResponse": false,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Okay, talk to you next time!"
            }
          }
        ]
      }
    }
  }
}

Actions SDK

วิธีรับ Intent ในการออกจากการสนทนา

1. ในออบเจ็กต์ conversations ภายในแพ็กเกจการดำเนินการ ให้ประกาศว่าคุณต้องการรับ Intent actions.intent.CANCEL ทุกครั้งที่ผู้ใช้ต้องการออกจากในระหว่างการสนทนา

   
   {
     "actions": [
       {
         "description": "Default Welcome Intent",
         "name": "MAIN",
         "fulfillment": {
           "conversationName": "conversation_1"
         },
         "intent": {
           "name": "actions.intent.MAIN"
         }
       }
     ],
     "conversations": {
       "conversation_1": {
         "name": "conversation_1",
         "url": "YOUR_ENDPOINT_URL",
         "inDialogIntents": [
           {
             "name": "actions.intent.CANCEL"
           }
         ]
       }
     }
   }
   action.json
   

2. เมื่อได้รับคําขอที่มี Intent actions.intent.CANCEL ให้ล้างตรรกะการดำเนินการที่คุณต้องการและส่งวลีสำหรับออกที่เหมาะสมให้กับผู้ใช้ ลองดูตัวอย่างรหัสการดำเนินการตามคำสั่งซื้อที่ใช้ไลบรารีของไคลเอ็นต์เพื่อจัดการ Intent การยกเลิก

   Node.js

   const {actionssdk} = require('actions-on-google');
   const functions = require('firebase-functions');
   
   const app = actionssdk({debug: true});
   
   app.intent('actions.intent.MAIN', (conv) => {
     conv.ask(`Hi! Try saying 'exit' or 'cancel'`);
   });
   
   app.intent('actions.intent.TEXT', (conv, input) => {
     conv.ask(`You said ${input}`);
     conv.ask(`Try saying 'exit' or 'cancel'`);
   });
   
   app.intent('actions.intent.CANCEL', (conv) => {
     conv.close(`Okay, talk to you next time!`);
   });
   
   exports.dialogflowFirebaseFulfillment = functions.https.onRequest(app);
   index.js

   Java

   package com.example;
   
   import com.google.actions.api.ActionRequest;
   import com.google.actions.api.ActionResponse;
   import com.google.actions.api.ActionsSdkApp;
   import com.google.actions.api.ConstantsKt;
   import com.google.actions.api.ForIntent;
   import com.google.actions.api.response.ResponseBuilder;
   import com.google.actions.api.response.helperintent.Confirmation;
   import com.google.actions.api.response.helperintent.DateTimePrompt;
   import com.google.actions.api.response.helperintent.Permission;
   import com.google.actions.api.response.helperintent.Place;
   import com.google.api.services.actions_fulfillment.v2.model.DateTime;
   import com.google.api.services.actions_fulfillment.v2.model.Location;
   
   public class MyActionsApp extends ActionsSdkApp {
   
     @ForIntent("actions.intent.MAIN")
     public ActionResponse welcome(ActionRequest request) {
       ResponseBuilder responseBuilder = getResponseBuilder(request);
       responseBuilder.add("Hi! Try saying 'exit' or 'cancel'");
       return responseBuilder.build();
     }
   
     @ForIntent("actions.intent.TEXT")
     public ActionResponse fallback(ActionRequest request) {
       ResponseBuilder responseBuilder = getResponseBuilder(request);
       responseBuilder.add("You said " + request.getRawInput().getQuery());
       responseBuilder.add("Try saying 'exit' or 'cancel'");
       return responseBuilder.build();
     }
   
     @ForIntent("actions.intent.CANCEL")
     public ActionResponse exit(ActionRequest request) {
       ResponseBuilder responseBuilder = getResponseBuilder(request);
       responseBuilder.add("Okay, talk to you next time!");
       responseBuilder.endConversation();
       return responseBuilder.build();
     }
   
   }
   MyActionsApp.java

   ขอ JSON

   โปรดทราบว่า JSON ด้านล่างอธิบายคำขอเว็บฮุค

   {
     "user": {
       "locale": "en-US",
       "userVerificationStatus": "VERIFIED"
     },
     "conversation": {
       "conversationId": "ABwppHEtH6XptryyLGWDBOVnLgy8EkOclTPETd4lcLh_f6ghQAzzg0seUuq3YocyFT8B17N6AGD6YPPjQw5CXBM",
       "type": "NEW"
     },
     "inputs": [
       {
         "intent": "actions.intent.CANCEL",
         "rawInputs": [
           {
             "inputType": "KEYBOARD",
             "query": "exit"
           }
         ]
       }
     ],
     "surface": {
       "capabilities": [
         {
           "name": "actions.capability.SCREEN_OUTPUT"
         },
         {
           "name": "actions.capability.ACCOUNT_LINKING"
         },
         {
           "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
         },
         {
           "name": "actions.capability.AUDIO_OUTPUT"
         },
         {
           "name": "actions.capability.WEB_BROWSER"
         }
       ]
     },
     "availableSurfaces": [
       {
         "capabilities": [
           {
             "name": "actions.capability.AUDIO_OUTPUT"
           },
           {
             "name": "actions.capability.SCREEN_OUTPUT"
           },
           {
             "name": "actions.capability.WEB_BROWSER"
           }
         ]
       }
     ]
   }

   JSON ของการตอบกลับ

   โปรดทราบว่า JSON ด้านล่างอธิบายการตอบสนองของเว็บฮุค

   {
     "expectUserResponse": false,
     "finalResponse": {
       "richResponse": {
         "items": [
           {
             "simpleResponse": {
               "textToSpeech": "Okay, talk to you next time!"
             }
           }
         ]
       }
     }
   }