รูปแบบเว็บฮุคของ Actions on Google (Dialogflow)

เอกสารนี้อธิบายรูปแบบเว็บฮุคสำหรับการสื่อสารระหว่าง Actions on Google และบริการดำเนินการตามคำสั่งซื้อที่กำหนดอินเทอร์เฟซผู้ใช้การสนทนาที่กำหนดเอง

หมายเหตุ: หากคุณมีเซิร์ฟเวอร์แบ็กเอนด์ของ Node.js เราขอแนะนำเป็นอย่างยิ่งให้ใช้ไลบรารีไคลเอ็นต์ของ Actions on Google Node.js เพื่อช่วยให้สร้างเว็บฮุคได้ง่ายขึ้น ไลบรารีของไคลเอ็นต์จะมี Wrapper สำหรับรูปแบบเว็บฮุค หากคุณต้องการผสานรวมการใช้งานแบ็กเอนด์ของคุณเองโดยไม่ใช้ไลบรารีของไคลเอ็นต์ แบ็กเอนด์ของคุณจะเป็นผู้รับผิดชอบในการใช้และประมวลผลข้อความ JSON ที่ส่งโดย Actions on Google ผ่าน HTTP POST

คุณควรทำความเข้าใจวิธีที่ Actions on Google และการดำเนินการตามคำสั่งซื้อสื่อสารผ่านรูปแบบเว็บฮุคของ Actions on Google ดังนี้

หากต้องการเข้าร่วมการสนทนากับ Actions on Google Fulfillment ของคุณจะใช้เว็บฮุคที่ตอบกลับคำขอ HTTP จาก Actions on Google ได้
เมื่อผู้ใช้เรียกใช้การดำเนินการของคุณ Fulfillment ของคุณจะได้รับ HTTP POST ที่มีเพย์โหลด JSON ที่อธิบายคำขอของผู้ใช้
ดังนั้น Fulfillment ของคุณจะมีหน้าที่ในการอ่านพารามิเตอร์จากเพย์โหลดคำขอ สร้างการตอบกลับในรูปแบบ JSON ที่เหมาะสม และส่งไปยัง Assistant ด้วยการตอบกลับนี้

ประเภทคำขอ

ตารางนี้สรุปประเภทคำขอที่เว็บฮุคอาจได้รับจาก Assistant

Type	คำอธิบาย	ตัวอย่าง JSON
คำขอการเรียกใช้	การพูดของผู้ใช้ที่เริ่มต้นการสนทนากับ Fulfillment หรือทริกเกอร์การดำเนินการที่ทำ Deep Link (เช่น "พูดกับ Personal Chef เพื่อหาสูตรอาหารเย็น") หากใช้ Dialogflow คำขอเหล่านี้จะสอดคล้องกับ Intent ที่กำหนดไว้ในส่วน Discovery ของการตั้งค่าการผสานรวม Google Assistant หากใช้ Actions SDK คำขอเหล่านี้จะสอดคล้องกับ Intent ที่กำหนดไว้ในแพ็กเกจ Action	เว็บฮุคของ Dialogflow เว็บฮุคของการสนทนา
คำขอสนทนา	การพูดจากผู้ใช้ในเซสชันเดียวกันเมื่อเริ่มการสนทนากับ Fulfillment ของคุณ ในรูปแบบเว็บฮุคการสนทนา นี่คือข้อความตอบกลับที่เป็นข้อมูลดิบจากผู้ใช้ที่เกี่ยวข้องกับ Intent `actions.intent.TEXT` ที่ Fulfillment ตามคำขอของคุณในการเลี้ยวก่อนหน้า	เว็บฮุคของ Dialogflow เว็บฮุคของการสนทนา
ผลลัพธ์ของตัวช่วย	คำขอที่ Assistant ส่งไปยัง Fulfillment ของคุณเมื่อเว็บฮุคขอความตั้งใจของผู้ช่วยในขั้นตอนก่อนหน้าของการสนทนาเพื่อจัดการกับบางส่วนของการสนทนา (เช่น `actions.intent.OPTION` และ `actions.intent.PERMISSION`)	เว็บฮุคของ Dialogflow เว็บฮุคของการสนทนา

คำขอสนทนาและคำตอบ

ในสถานการณ์การโต้ตอบปกติของ Actions on Google ผู้ใช้จะพูดวลีเพื่อเรียกให้เกิดการดําเนินการ Actions on Google จะค้นหาการตอบสนองที่ตรงกับการดำเนินการของผู้ใช้และส่งคำขอไปยังการดำเนินการดังกล่าวเพื่อให้การตอบสนอง

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

**รูปที่ 1** Actions on Google ที่เรียกใช้ Fulfillment ผ่าน Actions SDK

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบเพย์โหลด JSON เมื่อ Actions on Google เรียกใช้ Fulfillment ผ่าน Actions SDK ได้ที่รูปแบบเว็บฮุคของการสนทนา

คำขอและการตอบกลับของ Dialogflow

เมื่อสร้างการดำเนินการ คุณสามารถเลือกใช้ Dialogflow เพื่อทำให้การสร้างอินเทอร์เฟซการสนทนาง่ายขึ้นได้ ในสถานการณ์นี้ Dialogflow จะทำหน้าที่เป็น พร็อกซีระหว่าง Actions on Google กับ Fulfillment ของคุณ Actions on Google จะส่ง URL นั้นไปยัง Dialogflow แทนการส่งคำขอ HTTP/JSON ไปยังปลายทาง Fulfillment ของคุณโดยตรง

Dialogflow จะรวมเพย์โหลด JSON ที่อยู่ในคำขอเดิมลงในรูปแบบเว็บฮุค Dialogflow และส่งต่อคำขอที่ได้ไปยัง Fulfillment ของ Dialogflow

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

**รูปที่ 2** Actions on Google ที่เรียกใช้ Fulfillment ของคุณผ่าน Dialogflow

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบของเพย์โหลด JSON เมื่อ Actions on Google เรียกใช้ Fulfillment ของคุณผ่าน Dialogflow โปรดดูรูปแบบเว็บฮุคของ Dialogflow