สร้างโมเดลการเรียกใช้

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

  • การเรียกใช้หลัก - นี่คือการเรียกใช้เดียวที่จำเป็นสำหรับโปรเจ็กต์ Actions ของคุณ ผู้ใช้จะพูดวลีที่คล้ายกับ "Ok Google พูดกับ <ชื่อที่แสดง>" เพื่อให้ตรงกับความตั้งใจนี้ ซึ่งคุณมักจะจัดการด้วยการทักทายผู้ใช้ด้วยข้อความต้อนรับ

  • การเรียกใช้ Deep Link - เป็นการเรียกใช้แบบไม่บังคับที่ให้คุณกำหนดวลีการฝึกใน Intent ที่กำหนดเอง เพื่อให้ผู้ใช้ Deep Link ไปถึงส่วนใดส่วนหนึ่งของการสนทนาได้ ผู้ใช้สามารถพูดวลีที่คล้ายกับ "Ok Google พูดกับ <ชื่อดิสเพลย์> กับ <วลีลิงก์ในรายละเอียด>" เพื่อให้ตรงกับความตั้งใจประเภทเหล่านี้ (เช่น "Ok Google คุยกับข้อเท็จจริงเกี่ยวกับ Google เพื่อรับข้อเท็จจริงของบริษัท")

  • Intent ในตัว - เป็นการเรียกใช้ที่ไม่บังคับซึ่งทำให้คุณใช้ประโยชน์จากโมเดลการเรียกใช้ที่ระบบกำหนดได้ การประกาศการรองรับ Intent ในตัวช่วยให้ผู้ใช้ค้นพบและเรียกใช้โปรเจ็กต์ Actions ได้โดยไม่ต้องระบุชื่อที่แสดง ตัวอย่างเช่น ผู้ใช้พูดว่า "Ok Google เล่นเกม" แล้ว Google Assistant ก็สามารถนำเสนอการดำเนินการของคุณเป็นตัวเลือกสำหรับการเรียกใช้ได้

รูปที่ 1 โมเดลคำขอประกอบด้วย Intent ทั้งหมดที่มีสิทธิ์เริ่มการสนทนากับการดำเนินการของคุณ

สร้างคำขอหลัก

โปรเจ็กต์ Actions ทุกรายการมีการเรียกใช้หลักตามค่าเริ่มต้นซึ่งทําหน้าที่เป็นจุดเข้าถึงเริ่มต้นในโปรเจ็กต์ Actions โมเดลภาษาสําหรับการเรียกใช้นี้จะเชื่อมโยงกับชื่อที่แสดงของโปรเจ็กต์ ดังนั้นผู้ใช้เพียงแค่พูดวลีที่คล้ายกับ "Ok Google คุยกับ <display name>" เพื่อใช้การเรียกใช้นี้ เมื่อผู้ใช้เรียกใช้การดำเนินการในลักษณะนี้ รันไทม์ของ Assistant จะตรงกับ Intent ของระบบ actions.intent.MAIN

วิธีสร้างคำขอหลัก

หากต้องการสร้างการเรียกใช้ Deep Link คุณต้องสร้าง Intent ของผู้ใช้ส่วนกลางโดยใช้วลีการฝึกที่กำหนดข้อมูลจากผู้ใช้ที่คุณต้องการตั้งค่าให้กับ Deep Link ผู้ใช้พูดชื่อที่แสดงของคุณร่วมกับวลี Deep Link เพื่อทำการเรียกใช้ Deep Link (เช่น "Ok Google พูดกับ <ชื่อ ดิสเพลย์> กับ <วลี Deep Link>")

สร้างการเรียกใช้โดยนัย

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

จัดการเหตุการณ์การเรียกใช้

เมื่อ Assistant ตรงกับ Intent ส่วนกลางรายการหนึ่งของคุณ Assistant จะทริกเกอร์เหตุการณ์ที่คุณประมวลผลได้ด้วยเครื่องจัดการ ส่วนต่อไปนี้จะอธิบายสิ่งที่เครื่องจัดการทำได้ (คุณสามารถเลือกใช้ 1 แบบหรือใช้ 3 แบบผสมกันก็ได้)

ทริกเกอร์เว็บฮุค

ตัวแฮนเดิล Intent มอบอำนาจให้กับบริการเว็บได้โดยการทริกเกอร์เหตุการณ์เว็บฮุค วิธีทริกเกอร์เว็บฮุคและให้บริการเว็บจัดการการเรียกใช้

ข้อความแจ้ง

ตัวแฮนเดิล Intent ตอบสนองด้วยข้อความแจ้งแบบคงที่ได้ โดยทั่วไปข้อความแจ้งสำหรับ Intent การเรียกใช้จะต้อนรับผู้ใช้ แนะนำวิธีใช้การดำเนินการ หรือตอบสนองต่อข้อมูลที่ผู้ใช้ต้องการทันที (การดำเนินการแบบคลิกเดียว)

วิธีจัดการการจับคู่ Intent การเรียกใช้ด้วยพรอมต์

การเปลี่ยนไปยังฉาก

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