Intent คือออบเจ็กต์ข้อความที่อธิบายวิธีดำเนินการบางอย่าง คุณใช้ Intent ได้ 2 วิธี ดังนี้
- มอบการดำเนินการตามเจตนารมณ์ หรือ
- เมื่อขอให้ Google Assistant ตอบสนองความตั้งใจ
ขั้นตอนที่คุณใช้ในการสร้าง Fulfillment สำหรับ Intent จะแตกต่างกันไปสำหรับนักพัฒนาแอปการสร้างด้วย Dialogflow และสำหรับนักพัฒนาซอฟต์แวร์ที่สร้างด้วย Actions SDK อย่างไรก็ตาม ในทั้ง 2 กรณี คุณจะต้องระบุชื่อ Intent และ URL ของเว็บฮุค Fulfillment การดำเนินการนี้จะบอก Actions on Google ว่าคุณรองรับคำค้นหาของผู้ใช้ที่ตรงกับความตั้งใจได้
หากต้องการขอให้ตอบสนอง Intent คุณต้องระบุ Intent ในออบเจ็กต์ possibleIntents เมื่อโต้ตอบกับ Assistant ในคำขอ Fulfillment ของคุณหลังจากนั้น Assistant จะแสดงผลลัพธ์ของ Intent ที่ประมวลผลแล้วให้คุณ สำหรับข้อมูลเพิ่มเติม โปรดอ่านภาพรวมการใช้งานผู้ช่วย
Intent ทั่วไป
ตารางต่อไปนี้อธิบายความตั้งใจที่ Assistant ขอให้คุณดำเนินการ
| ชื่อ Intent | การใช้งาน | เหตุการณ์ Dialogflow |
|---|---|---|
actions.intent.MAIN |
จำเป็น: แพ็กเกจการดำเนินการทุกรายการจะประกาศ Intent 1 รายการและเพียงรายการเดียวที่ทำหน้าที่เป็นจุดแรกเข้าเพื่อให้ผู้ใช้เริ่มการสนทนา | WELCOME หรือ GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
รับการแสดงคำขอของผู้ใช้เป็นข้อความดิบ คุณจะใช้เวลานี้เป็นส่วนใหญ่เมื่อมีส่วนร่วมกับผู้ใช้ | |
actions.intent.CANCEL |
คุณจะได้รับ Intent นี้เมื่อเลือกรับ Intent การยกเลิกในแพ็กเกจการดำเนินการ เมื่อผู้ใช้พูดคำสั่งยกเลิกส่วนกลาง เช่น "ออก" คุณจะได้รับ Intent นี้ในคำขอถัดไปสำหรับ Fulfillment เพื่อให้คุณตอบกลับด้วยข้อความสุดท้ายและทำความสะอาดในตรรกะการดำเนินการตามคำสั่งซื้อได้ | actions_intent_CANCEL |
actions.intent.NO_INPUT |
คุณจะได้รับ Intent นี้เมื่อเลือกรับ Intent ที่ไม่มีอินพุตในแพ็กเกจการดำเนินการ เมื่อผู้ใช้ไม่ตอบกลับข้อความแจ้ง คุณจะได้รับ Intent นี้ในคำขอถัดไปสำหรับ Fulfillment | actions_intent_NO_INPUT |
ผู้ช่วย
ตารางต่อไปนี้อธิบายผู้ช่วยที่รองรับซึ่งคุณสามารถขอให้ Assistant ดําเนินการต่อได้
| ชื่อ Intent | การใช้งาน | เหตุการณ์ Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
ขอชื่อเต็ม ตำแหน่งคร่าวๆ หรือตำแหน่งที่แน่นอนของผู้ใช้ หรือทั้ง 3 ข้อ | actions_intent_PERMISSION |
actions.intent.OPTION |
รับรายการที่เลือกจาก UI ของรายการหรือภาพสไลด์ หรือหากผู้ใช้ไม่ได้เลือกจาก UI ของรายการหรือภาพสไลด์ รับเสียงพูดหรือข้อความที่ตรงกับคีย์ใน UI ของรายการหรือภาพสไลด์ | actions_intent_OPTION |
actions.intent.DATETIME |
รับวันที่และเวลาจากผู้ใช้ | actions_intent_DATETIME |
actions.intent.SIGN_IN |
ส่งคำขอขั้นตอนการลิงก์บัญชีเพื่อลิงก์บัญชีของผู้ใช้ | actions_intent_SIGN_IN |
actions.intent.PLACE |
ขอที่อยู่หรือสถานที่ที่บันทึกไว้จากผู้ใช้ | actions_intent_PLACE |
actions.intent.CONFIRMATION |
รับการยืนยันจากผู้ใช้ (เช่น การตอบคำถามใช่หรือไม่ใช่) | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
ขอสิทธิ์ส่งต่อไปยังแพลตฟอร์มอื่นของ Assistant จากผู้ใช้ | actions_intent_NEW_SURFACE |
Intent ในตัว
Intent ในตัวจะแสดงตัวอย่างวิธีการทั่วไปที่ผู้ใช้แสดงออกถึงงานที่กำลังทำหรือข้อมูลที่ต้องการ เช่น การสั่งอาหาร การจองรถโดยสาร หรือการตรวจสอบเงินคงเหลือ ดูข้อมูลเพิ่มเติมที่ข้อมูลอ้างอิง Intent ในตัว
Intent เพิ่มเติม
การดำเนินการแบบการสนทนาส่วนใหญ่สร้างขึ้นจากทั้ง Intent, ตัวช่วย และการตอบสนองที่มีร่วมกัน อย่างไรก็ตาม การดำเนินการที่มีฟีเจอร์เพิ่มเติม เช่น ธุรกรรมหรือการอัปเดตรายวันจะเข้าถึง Intent ที่เจาะจงสำหรับฟีเจอร์เหล่านั้นได้
ผู้ช่วยธุรกรรม
ตารางต่อไปนี้อธิบายผู้ช่วยที่เกี่ยวข้องกับการจัดการการซื้อที่คุณขอให้ Assistant ดําเนินการต่อได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ Intent เหล่านี้และ Intent อื่นๆ ที่เกี่ยวข้องได้ในเอกสารฟีเจอร์ธุรกรรม
| ชื่อ Intent | การใช้งาน | เหตุการณ์ Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
รับข้อมูลที่อยู่สำหรับจัดส่งจากผู้ใช้ | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
ตรวจสอบว่าเป็นไปตามข้อกำหนดทั้งหมดสำหรับธุรกรรมหรือไม่ | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
ถามผู้ใช้ว่าควรทำธุรกรรมหรือไม่ | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
ตรวจสอบการกำหนดค่าธุรกรรมของผู้ใช้ ใช้เพื่อหลีกเลี่ยงการเสนอสินค้าดิจิทัลแก่ผู้ใช้ที่ทำธุรกรรมไม่สำเร็จ | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
เริ่มส่งคำขอซื้อ จะแสดงผลลัพธ์การซื้อที่อธิบายว่าธุรกรรมนั้นสำเร็จหรือล้มเหลวอย่างไร | actions_intent_COMPLETE_PURCHASE |
ความตั้งใจในการสร้างการมีส่วนร่วมของผู้ใช้
ตารางต่อไปนี้อธิบายความตั้งใจที่เกี่ยวข้องกับฟีเจอร์การมีส่วนร่วมของผู้ใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ความตั้งใจเหล่านี้และความตั้งใจอื่นๆ ที่เกี่ยวข้องได้ในเอกสารฟีเจอร์การมีส่วนร่วมของผู้ใช้
| ชื่อ Intent | ดำเนินการตามคำสั่งซื้อ | ขอให้ดำเนินการตามคำสั่งซื้อ | การใช้งาน | เหตุการณ์ Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | ขอให้ผู้ใช้ลงทะเบียนเพื่อการอัปเดต | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | คุณจะได้รับ Intent นี้เมื่อผู้ใช้พยายามลงทะเบียนสำหรับการอัปเดต (นั่นคือควรส่ง Intent REGISTER_UPDATE) | actions_intent_CONFIGURE_UPDATES |
ความตั้งใจที่กำหนดเอง
คุณสามารถสร้าง Intent ของตัวเองเพื่อกำหนดทางลัดในการสนทนาเพื่อช่วยให้ผู้ใช้ทำสิ่งต่างๆ ให้เสร็จได้อย่างมีประสิทธิภาพมากขึ้น Intent เหล่านี้อยู่ในเนมสเปซของคุณเอง คุณกำหนดวิธีเรียกใช้ Intent ของผู้ใช้ และแพ็กเกจการดำเนินการของคุณเป็นรายการเดียวที่รองรับ Intent ได้
อ่านข้อมูลเพิ่มเติมได้ที่การกำหนด Actions ใน Dialogflow หรือใช้ Actions SDK ดูข้อมูลเพิ่มเติมเกี่ยวกับแพ็กเกจการดำเนินการได้ในเอกสารประกอบข้อมูลอ้างอิงแพ็กเกจการดำเนินการ
Intent ของสมาร์ทโฮม
หากคุณกำลังสร้างการดำเนินการสำหรับสมาร์ทโฮม คุณต้องกำหนดการรองรับ Intent ด้วยวิธีที่ต่างออกไปเล็กน้อย ดูข้อมูลเพิ่มเติมในเอกสารIntent ของสมาร์ทโฮม