เอกสารนี้อธิบายรูปแบบเว็บฮุคสำหรับการสื่อสารระหว่าง Actions on Google และบริการดำเนินการตามคำสั่งซื้อที่กำหนดอินเทอร์เฟซผู้ใช้การสนทนาที่กำหนดเอง
คุณควรทำความเข้าใจวิธีที่ 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 เพื่อหาสูตรอาหารเย็น")
|
|
คำขอสนทนา | การพูดจากผู้ใช้ในเซสชันเดียวกันเมื่อเริ่มการสนทนากับ Fulfillment ของคุณ ในรูปแบบเว็บฮุคการสนทนา นี่คือข้อความตอบกลับที่เป็นข้อมูลดิบจากผู้ใช้ที่เกี่ยวข้องกับ Intent actions.intent.TEXT ที่ Fulfillment ตามคำขอของคุณในการเลี้ยวก่อนหน้า |
|
ผลลัพธ์ของตัวช่วย | คำขอที่ Assistant ส่งไปยัง Fulfillment ของคุณเมื่อเว็บฮุคขอความตั้งใจของผู้ช่วยในขั้นตอนก่อนหน้าของการสนทนาเพื่อจัดการกับบางส่วนของการสนทนา (เช่น actions.intent.OPTION และ actions.intent.PERMISSION ) |
คำขอสนทนาและคำตอบ
ในสถานการณ์การโต้ตอบปกติของ Actions on Google ผู้ใช้จะพูดวลีเพื่อเรียกให้เกิดการดําเนินการ Actions on Google จะค้นหาการตอบสนองที่ตรงกับการดำเนินการของผู้ใช้และส่งคำขอไปยังการดำเนินการดังกล่าวเพื่อให้การตอบสนอง
เมื่อ Actions on Google พบว่า Fulfillment ของคุณตรงกับคำขอของผู้ใช้แล้ว ก็จะเป็นการเริ่มเซสชันการสนทนาโดยส่งคำขอ HTTP ที่มีเพย์โหลด JSON ที่มีข้อมูลคำขอของผู้ใช้ไปยังปลายทาง Fulfillment ของคุณ Fulfillment ของคุณแยกวิเคราะห์คำขอและแสดงผลการตอบกลับที่มีเพย์โหลด JSON จากนั้น Actions on Google จะแปลงเพย์โหลดเป็นเอาต์พุตเสียงพูดและมัลติมีเดียที่แสดงผลให้ผู้ใช้
![](https://developers.google.cn/static/assistant/actions/images/json-conversation.png?authuser=19&hl=th)
ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบเพย์โหลด 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 เข้าใจ
![](https://developers.google.cn/static/assistant/actions/images/json-dialogflow.png?authuser=19&hl=th)
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบของเพย์โหลด JSON เมื่อ Actions on Google เรียกใช้ Fulfillment ของคุณผ่าน Dialogflow โปรดดูรูปแบบเว็บฮุคของ Dialogflow