สร้าง Actions สำหรับ Google Assistant โดยใช้ Actions SDK (ระดับ 1)

1. ภาพรวม

คำเตือน: เราเลิกใช้งานการดำเนินการแบบการสนทนาไปแล้วเมื่อวันที่ 13 มิถุนายน 2023 ดูข้อมูลเพิ่มเติมได้ที่ การหยุดให้บริการ Conversational Actions

แพลตฟอร์มนักพัฒนาซอฟต์แวร์ของ Google Assistant ช่วยให้คุณสร้างซอฟต์แวร์เพื่อขยายฟังก์ชันการทำงานของ Google Assistant ซึ่งเป็นผู้ช่วยส่วนตัวเสมือนในอุปกรณ์กว่า 1 พันล้านเครื่อง ซึ่งรวมถึงลำโพงอัจฉริยะ โทรศัพท์ รถยนต์ ทีวี หูฟัง และอื่นๆ อีกมากมาย ผู้ใช้มีส่วนร่วมกับ Assistant ในการสนทนาเพื่อทำสิ่งต่างๆ เช่น ซื้อของชำหรือจองรถโดยสาร ในฐานะนักพัฒนาแอป คุณสามารถใช้แพลตฟอร์มสำหรับนักพัฒนาซอฟต์แวร์ Assistant เพื่อสร้างและจัดการประสบการณ์การสนทนาที่น่าประทับใจและมีประสิทธิภาพระหว่างผู้ใช้และบริการสำหรับการดำเนินการตามคำสั่งซื้อของบุคคลที่สามของคุณเองได้อย่างง่ายดาย

Codelab นี้ครอบคลุมแนวคิดระดับเริ่มต้นในการพัฒนาด้วย Actions SDK สำหรับ Google Assistant คุณไม่จำเป็นต้องมีประสบการณ์เกี่ยวกับแพลตฟอร์มมาก่อนเพื่อดำเนินการให้เสร็จสมบูรณ์ ใน Codelab นี้ คุณจะได้สร้าง Action for Google Assistant แบบง่ายๆ ซึ่งจะบอกดวงชะตาแก่ผู้ใช้เมื่อเริ่มต้นการผจญภัยในดินแดนตำนานของ Gryffinberg ใน Codelab ของการดำเนินการ SDK ระดับ 2 คุณสร้างการดำเนินการนี้เพิ่มเติมเพื่อปรับแต่งโชคลาภของผู้ใช้ตามข้อมูลที่ได้รับ

สิ่งที่คุณจะสร้าง

ใน Codelab นี้ คุณสร้างการดำเนินการอย่างง่ายด้วยฟังก์ชันต่อไปนี้

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

เมื่อเสร็จสิ้น Codelab นี้ การดำเนินการที่ทำเสร็จแล้วจะมีการสนทนาดังต่อไปนี้ (ข้อความถัดจากไมโครโฟนจะแสดงข้อมูลที่ผู้ใช้ป้อน ส่วนข้อความข้างลำโพงจะแสดงคำตอบของการดำเนินการ)

สิ่งที่คุณจะได้เรียนรู้

• วิธีสร้างโปรเจ็กต์ในคอนโซล Actions
• วิธีใช้เครื่องมือ gactions เพื่อพุชและดึงโปรเจ็กต์ Action ระหว่างคอนโซล Actions กับระบบไฟล์ในเครื่อง
• วิธีส่งข้อความแจ้งไปยังผู้ใช้หลังจากเรียกใช้การดําเนินการของคุณ
• วิธีประมวลผลอินพุตของผู้ใช้และแสดงผลคำตอบ
• วิธีทดสอบการดำเนินการในเครื่องมือจำลองการดำเนินการ
• วิธีใช้ Fulfillment โดยใช้ตัวแก้ไข Cloud Functions

สิ่งที่คุณต้องมี

เครื่องมือต่อไปนี้ต้องอยู่ในสภาพแวดล้อมของคุณ

• IDE หรือเครื่องมือแก้ไขข้อความที่คุณเลือก
• เทอร์มินัลสำหรับเรียกใช้คำสั่ง Shell สำหรับ Node.js และ npm
• เว็บเบราว์เซอร์ เช่น Google Chrome

หากคุณต้องการใช้เครื่องมือที่มีภาพมากขึ้นในการสร้างการดำเนินการ โปรดไปที่ Create Actions for Google Assistant with Actions Builder (Level 1) Codelab แทน ซึ่งจะสร้าง Action เดียวกันโดยใช้ IDE ของ Actions Builder ในคอนโซล

2. ตั้งค่า

ส่วนต่อไปนี้จะอธิบายวิธีตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และสร้างโปรเจ็กต์การดำเนินการ

ตรวจสอบการตั้งค่าสิทธิ์ของ Google

ในการทดสอบการดำเนินการที่คุณสร้างใน Codelab นี้ คุณต้องเปิดใช้สิทธิ์ที่จำเป็นเพื่อให้เครื่องจำลองเข้าถึงการดำเนินการได้

หากต้องการเปิดใช้สิทธิ์ ให้ทำตามขั้นตอนต่อไปนี้

1. ไปที่ส่วนควบคุมกิจกรรม
2. หากยังไม่ได้ลงชื่อเข้าใช้บัญชี Google โปรดลงชื่อเข้าใช้ก่อน
3. เปิดใช้สิทธิ์ต่อไปนี้

• กิจกรรมบนเว็บและแอป
• ในส่วน เว็บและ กิจกรรมบนแอป ให้เลือกช่องทำเครื่องหมายรวมประวัติการเข้าชมใน Chrome และกิจกรรมจากเว็บไซต์ แอป และอุปกรณ์ที่ใช้บริการต่างๆ ของ Google****

สร้างโปรเจ็กต์ Actions

โปรเจ็กต์ Actions เป็นคอนเทนเนอร์สำหรับการดำเนินการ

หากต้องการสร้างโปรเจ็กต์การดำเนินการสำหรับ Codelab นี้ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดคอนโซล Actions
2. คลิกโครงการใหม่
3. ป้อนชื่อโปรเจ็กต์ เช่น actions-codelab (ชื่อนี้เป็นชื่อที่ใช้อ้างอิงภายใน หลังจากนั้นคุณสามารถตั้งชื่อภายนอกสำหรับโปรเจ็กต์ของคุณได้)

4. คลิกสร้างโครงการ
5. ในหน้าจอคุณต้องการสร้างการดำเนินการประเภทใด ให้เลือกการ์ดกำหนดเอง
6. คลิกถัดไป
7. ในหน้าจอคุณต้องการสร้างอย่างไร ให้เลือกการ์ดโปรเจ็กต์เปล่า
8. คลิกเริ่มสร้าง

บันทึกรหัสโปรเจ็กต์สำหรับการดำเนินการของคุณ

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

หากต้องการเรียกดูรหัสโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

1. ในคอนโซล Actions ให้คลิกจุดแนวตั้ง 3 จุด (แทรกไอคอนที่นี่)
2. คลิกการตั้งค่าโปรเจ็กต์

3. คัดลอกรหัสโปรเจ็กต์**

เชื่อมโยงบัญชีสำหรับการเรียกเก็บเงิน

หากยังไม่มีบัญชีสำหรับการเรียกเก็บเงิน คุณจะต้องสร้างบัญชีสำหรับการเรียกเก็บเงินและเชื่อมโยงบัญชีดังกล่าวกับโปรเจ็กต์ใน Google Cloud เพื่อทำให้ Fulfillment ใช้งานได้ในภายหลังด้วย Cloud Functions

หากต้องการเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงินกับโปรเจ็กต์ของคุณ ให้ทำตามขั้นตอนต่อไปนี้

1. ไปที่หน้าการเรียกเก็บเงินของ Google Cloud Platform
2. คลิกเพิ่มบัญชีสำหรับการเรียกเก็บเงินหรือสร้างบัญชี
3. ป้อนข้อมูลการชำระเงิน
4. คลิกเริ่มช่วงทดลองใช้ฟรีหรือส่งและเปิดใช้การเรียกเก็บเงิน
5. ไปที่หน้าการเรียกเก็บเงินของ Google Cloud Platform
6. คลิกแท็บโปรเจ็กต์ของฉัน
7. คลิกจุด 3 จุดใต้การดำเนินการถัดจากโปรเจ็กต์การดำเนินการสำหรับ Codelab
8. คลิกเปลี่ยนแปลงการเรียกเก็บเงิน
9. เลือกบัญชีสำหรับการเรียกเก็บเงินที่คุณกำหนดค่าไว้ในเมนูแบบเลื่อนลง
10. คลิกตั้งค่าบัญชี

โปรดทำตามขั้นตอนในส่วน "ล้างโปรเจ็กต์" ที่ตอนท้ายของ Codelab เพื่อหลีกเลี่ยงการเรียกเก็บเงิน

ติดตั้งอินเทอร์เฟซบรรทัดคำสั่ง gactions

ใน Codelab นี้ คุณจะใช้เครื่องมืออินเทอร์เฟซบรรทัดคำสั่ง (CLI) ของ gactions เพื่อซิงค์ข้อมูลโปรเจ็กต์ Actions ระหว่างคอนโซล Actions และระบบไฟล์ในเครื่อง

คำสำคัญ

• gactions CLI: เครื่องมือที่จะช่วยให้คุณเริ่มต้นไฟล์โปรเจ็กต์การดำเนินการ, ส่งการอัปเดตไปยังคอนโซล Actions, ทำให้โปรเจ็กต์ Actions ใช้งานได้ และอีกมากมาย

หากต้องการติดตั้ง gactions CLI ให้ทำตามวิธีการในติดตั้งเครื่องมือบรรทัดคำสั่ง gactions

ดาวน์โหลดโปรเจ็กต์ Actions

เริ่มพัฒนาการดำเนินการของคุณโดยดาวน์โหลดโปรเจ็กต์ Actions จากคอนโซล Actions

หากต้องการดาวน์โหลดโปรเจ็กต์ Actions ให้ทำตามขั้นตอนต่อไปนี้

1. หากต้องการสร้างไดเรกทอรีใหม่และเปลี่ยนเป็นไดเรกทอรีดังกล่าว ให้เรียกใช้คำสั่งต่อไปนี้

mkdir myproject
cd myproject

2. หากต้องการคัดลอกการกำหนดค่าของโปรเจ็กต์ Actions ไปยังระบบไฟล์ในเครื่อง ให้เรียกใช้คำสั่งต่อไปนี้

gactions pull --project-id <projectID>

ทำความเข้าใจโครงสร้างไฟล์

โครงการ Actions ที่คุณดาวน์โหลดจากคอนโซล Actions จะแสดงในโครงสร้างไฟล์ YAML รูปภาพต่อไปนี้แสดงโครงสร้างไฟล์ระดับสูง

โดยโครงสร้างไฟล์จะประกอบด้วยข้อมูลต่อไปนี้

• actions/: แสดงโปรเจ็กต์ Actions ระบบจะเรียก actions.yaml เมื่อมีการเรียกใช้การดำเนินการของคุณ ซึ่งจะเรียกไฟล์ custom/global/actions.intent.MAIN.yaml
• custom/: ไดเรกทอรีที่คุณจะทำงานเพื่อแก้ไขการดำเนินการ
• global/: ไดเรกทอรีนี้มี Intent ของระบบที่แพลตฟอร์มเพิ่มลงในโปรเจ็กต์โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมเกี่ยวกับ Intent ของระบบได้ภายหลังใน Codelab นี้
• manifest.yaml: ไฟล์ที่มีข้อมูลซึ่งรับส่งได้หรือไม่ใช่ข้อมูลเฉพาะสำหรับโปรเจ็กต์ที่ระบุ และย้ายระหว่างโปรเจ็กต์ได้
• settings/: แสดงการตั้งค่าของโปรเจ็กต์ Actions เช่น ชื่อที่แสดง ภาษาเริ่มต้น และหมวดหมู่

3. เริ่มการสนทนา

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

คุณต้องแก้ไขการเรียกใช้หลักเพื่อกำหนดสิ่งที่เกิดขึ้นหลังจากผู้ใช้เรียกใช้การดำเนินการของคุณ

คำสำคัญ

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

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

คำสำคัญ

• ข้อความแจ้ง: กำหนดสิ่งที่การดำเนินการของคุณส่งให้ผู้ใช้เป็นการตอบกลับ พรอมต์อาจเป็นข้อความตอบกลับแบบข้อความง่ายๆ และเสียงพูด หรือ Rich Text เช่น การ์ดและรูปภาพ

คุณใช้พรอมต์พิเศษ Canvas เพื่อแสดงภาพแบบเต็มหน้าจอให้กับผู้ใช้ได้ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับ Canvas ในเอกสารประกอบของ Interactive Canvas

ในส่วนถัดไป ให้คุณปรับแต่งข้อความแจ้งสำหรับการเรียกใช้หลักในไฟล์ custom/global/actions.intent.MAIN.yaml

ตั้งค่าการเรียกใช้หลัก

คุณจะแก้ไขพรอมต์คำขอหลักได้ในไฟล์ actions.intent.MAIN.yaml

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

1. เปิด custom/global/actions.intent.MAIN.yaml ในโปรแกรมแก้ไขข้อความ
2. แทนที่ข้อความในช่อง speech (Start building your action...) ด้วยข้อความต้อนรับต่อไปนี้ A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.

actions.intent.MAIN.yaml

handler:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: A wondrous greeting, adventurer! Welcome to the mythical land of 
                Gryffinberg! Based on your clothes, you are not from around these lands. 
                It looks like you're on your way to an epic journey.
transitionToScene: actions.scene.END_CONVERSATION

3. บันทึกไฟล์

ทดสอบการเรียกใช้หลักในเครื่องมือจำลอง

คอนโซล Actions มีเครื่องมือบนเว็บสำหรับการทดสอบการดำเนินการของคุณซึ่งเรียกว่าเครื่องมือจำลอง อินเทอร์เฟซจะจำลองอุปกรณ์ฮาร์ดแวร์และการตั้งค่า คุณจึงสนทนากับการดำเนินการได้เสมือนว่ากำลังทำงานในจออัจฉริยะ โทรศัพท์ ลำโพง หรือ KaiOS

สำหรับข้อมูลล่าสุดเกี่ยวกับการใช้เครื่องมือจำลองคอนโซล Actions หรือหากคุณพบปัญหาใดๆ ในขั้นตอนต่อไปนี้ โปรดดูที่หน้าเครื่องมือจำลอง

เมื่อเรียกใช้ Action ของคุณ ตอนนี้โปรแกรมควรจะตอบกลับด้วยพรอมต์แบบกำหนดเองที่คุณได้เพิ่มไว้ ("คำทักทายสุดมหัศจรรย์ นักผจญภัย!...")

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

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

1. หากต้องการทำให้โปรเจ็กต์ใช้งานได้กับคอนโซล Actions สำหรับการทดสอบ ให้เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

gactions deploy preview

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

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. หากต้องการเรียกใช้การดำเนินการในเครื่องมือจำลอง ให้พิมพ์ Talk to my test app ในช่องอินพุต แล้วกด Enter

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

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

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

ดูบันทึกเหตุการณ์

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

ขณะนี้การดำเนินการของคุณมีบันทึกเหตุการณ์ 1 รายการซึ่งแสดงทั้งข้อมูลที่ผู้ใช้ป้อน ("พูดกับแอปทดสอบของฉัน") และคำตอบของการดำเนินการ ภาพหน้าจอต่อไปนี้แสดงบันทึกเหตุการณ์ของการดำเนินการ

หากคลิกลูกศรชี้ลงถัดจาก Talk to my test app ในบันทึกกิจกรรม คุณจะเห็นกิจกรรมที่เกิดขึ้นตามลำดับเวลาของการสนทนา ดังนี้

• userInput: สอดคล้องกับข้อมูลที่ผู้ใช้ป้อน ("พูดกับแอปทดสอบของฉัน")
• interactionMatch: สอดคล้องกับการตอบกลับการเรียกใช้หลักของการดำเนินการของคุณ ซึ่งทริกเกอร์โดยอินพุตของผู้ใช้ หากขยายแถวนี้โดยคลิกลูกศร คุณจะเห็นข้อความแจ้งที่คุณเพิ่มสำหรับการเรียกใช้หลัก (A wondrous greeting, adventurer!...)
• endConversation: สอดคล้องกับการเปลี่ยนที่เลือกไว้ใน Intent Main invocation ซึ่งปัจจุบันสิ้นสุดการสนทนา ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนได้ในส่วนถัดไปของ Codelab นี้

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

4. สร้างการสนทนาของการดำเนินการ

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

คำสำคัญ:

• ฉาก: องค์ประกอบที่ใช้สร้างสรรค์สำหรับการดำเนินการที่ประมวลผลอินพุตของผู้ใช้และมักจะสร้างคำตอบให้กับผู้ใช้ ความตั้งใจที่กำหนดเองมักจะเปิดใช้งานฉากอื่นๆ แต่ฉากดังกล่าวยังเปิดใช้งานในลักษณะอื่นได้
• ความตั้งใจที่กำหนดเอง: ระบุข้อมูลของผู้ใช้ที่การดำเนินการเข้าใจได้ โดยคุณเป็นผู้กำหนดวลีการฝึกสำหรับ Intent เหล่านี้ เมื่อผู้ใช้พูดคำที่ตรงหรือคล้ายกับวลีการฝึกอบรม ระบบจะจับคู่ Intent ที่ตรงกัน
• วลีการฝึกอบรม: ตัวอย่างข้อความที่ผู้ใช้อาจพูดเพื่อให้ตรงกับความตั้งใจ โดยธรรมชาติแล้ว เครื่องมือทำความเข้าใจภาษาธรรมชาติ (NLU) ของ Assistant จะขยายวลีการฝึกเหล่านี้ให้ครอบคลุมวลีอื่นๆ ที่คล้ายกัน
• การเปลี่ยน: กำหนดฉากที่จะเปลี่ยนไปใช้เมื่อตรงตามเงื่อนไข

การดำเนินการมีฉากได้หลายฉาก และคุณต้องเปิดใช้งานแต่ละฉากก่อนจึงจะเรียกใช้ได้ การดำเนินการที่คุณสร้างใน Codelab นี้มีฉากชื่อ Start เพียงฉากเดียว วิธีที่ใช้กันมากที่สุดในการเปิดใช้งานฉากคือการกำหนดค่าการดำเนินการเพื่อที่ว่า Intent จะทริกเกอร์การเปลี่ยนไปยังฉากนั้นเมื่อผู้ใช้อินพุตตรงกับความตั้งใจภายในฉากนั้น

ตัวอย่างเช่น สมมติว่าเป็นการดำเนินการสมมติที่ให้ข้อมูลเกี่ยวกับสัตว์แก่ผู้ใช้ เมื่อผู้ใช้เรียกใช้การดำเนินการนี้ ระบบจะจับคู่ Intent Main invocation และทริกเกอร์การเปลี่ยนไปใช้ฉากที่ชื่อ Facts. การเปลี่ยนนี้เปิดใช้งานโหมด Facts ซึ่งจะส่งพรอมต์ต่อไปนี้ไปยังผู้ใช้: Would you like to hear a fact about cats or dogs? ภายในโหมด Facts เป็น Intent ที่กำหนดเองชื่อ Cat ซึ่งมีวลีการฝึกที่ผู้ใช้อาจพูดเพื่อฟังข้อมูลเกี่ยวกับแมว เช่น "ฉันอยากฟังข้อมูลเกี่ยวกับแมว" หรือ "แมว" เมื่อผู้ใช้ขอฟังข้อเท็จจริงเกี่ยวกับแมว ระบบจะจับคู่ Intent Cat และทริกเกอร์การเปลี่ยนไปใช้ฉากชื่อ Cat fact. ฉาก Cat fact จะเปิดใช้งานและส่งพรอมต์ที่มีข้อมูลเกี่ยวกับแมวแก่ผู้ใช้

รูปที่ 1 ความลื่นไหลของการสนทนาทั่วไปในการดําเนินการที่สร้างด้วย Actions SDK

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

การเปลี่ยนจากการเรียกใช้หลักไปเป็นฉาก

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

ทำตามขั้นตอนต่อไปนี้เพื่อสร้างฉากและเพิ่มการเปลี่ยนฉาก

1. เปิด custom/global/actions.intent.MAIN.yaml ในโปรแกรมแก้ไขข้อความ
2. แทนที่ข้อความในช่อง transitionToScene (actions.scene.END_CONVERSATION) ด้วย transitionToScene: Start

actions.intent.MAIN.yaml

handler:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Welcome to the mythical land of  Gryffinberg! Based on your clothes,
              you are not from around these lands. It looks like you're on your way
              to an epic journey.
transitionToScene: Start

การดำเนินการนี้จะบอกให้การดำเนินการเปลี่ยนจากการเรียกใช้หลักเป็นฉาก Start

3. บันทึกไฟล์
4. จากนั้นสร้างไดเรกทอรี scenes ใหม่ในไดเรกทอรี custom ดังนี้

mkdir custom/scenes 

5. สร้างไฟล์ใหม่ชื่อ Start.yaml ในไดเรกทอรี scenes ซึ่งแสดงถึงฉาก start ใน Action ของคุณ:

touch custom/scenes/Start.yaml 

6. เปิด Start.yaml ในโปรแกรมแก้ไขข้อความ
7. วางโค้ดต่อไปนี้ลงในไฟล์ Start.yaml

Start.yaml

onEnter:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Before you continue on your quest, would you like your fortune
              told?

ในโค้ดไฟล์ Start.yaml มีช่องชื่อ onEnter ซึ่งเป็นระยะแรกที่ทำงานในวงจรของฉาก

คำสำคัญ:

• OnEnter: พื้นที่งานที่เรียกใช้เมื่อฉากเปิดใช้งาน OnEnter กำหนดสิ่งที่เกิดขึ้นเมื่อผู้ใช้เข้าฉาก

ในกรณีนี้ ระบบจะเพิ่มพรอมต์ (Before you continue on your quest...) ลงในคิวพรอมต์เมื่อผู้ใช้เข้าสู่โหมด Start เป็นครั้งแรก

คำสำคัญ:

• คิวพรอมต์: จะมีการเพิ่มพรอมต์ต่อเนื่องกันในคิวพรอมต์ Assistant จะแสดงพรอมต์ทั้งหมดในคิวข้อความแจ้งแก่ผู้ใช้ก่อนที่ผู้ใช้จะโต้ตอบได้

เพิ่มชิปคำแนะนำ

ชิปคำแนะนำจะเสนอคำแนะนำที่คลิกได้ให้ผู้ใช้ซึ่งการดำเนินการของคุณประมวลผลเป็นอินพุตของผู้ใช้ ในส่วนนี้ คุณต้องเพิ่มชิปคำแนะนำ Yes และ No รายการที่ปรากฏใต้ข้อความแจ้งที่เพิ่งกำหนดค่า (Before you continue on your quest, would you like your fortune told?) เพื่อรองรับผู้ใช้ในอุปกรณ์ที่มีหน้าจอ

หากต้องการเพิ่มชิปคำแนะนำในพรอมต์ของฉาก Start ให้ทำตามขั้นตอนต่อไปนี้

1. อัปเดตโค้ดใน Start.yaml ให้ตรงกับข้อมูลโค้ดต่อไปนี้ ซึ่งมีโค้ดสำหรับการกำหนดค่าชิปคำแนะนำ

Start.yaml

onEnter:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Before you continue on your quest, would you like your fortune
              told?
        suggestions:
        - title: "Yes"
        - title: "No"

2. บันทึกไฟล์

ทดสอบการดำเนินการในเครื่องมือจำลอง

เมื่อถึงจุดนี้ การดำเนินการของคุณควรเปลี่ยนจากการเรียกใช้หลักไปยังฉาก Start และถามผู้ใช้ว่าต้องการบอกดวงชะตาไหม ชิปคำแนะนำควรปรากฏในหน้าจอจำลองด้วย

หากต้องการทดสอบการดำเนินการในเครื่องมือจำลอง ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นเรียกใช้คำสั่งต่อไปนี้

gactions deploy preview

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. คลิกทดสอบเพื่อนำคุณไปที่เครื่องจำลอง
4. พิมพ์ Talk to my test app ในช่อง Input แล้วกด Enter การดำเนินการของคุณควรตอบกลับด้วยพรอมต์ Main invocation และพรอมต์ฉาก Start ที่เพิ่มเข้ามา "ก่อนไปทำภารกิจต่อ อยากให้บอกคำพยากรณ์ไหม" พร้อมชิปคำแนะนำแสดงอยู่

ภาพหน้าจอต่อไปนี้แสดงการโต้ตอบนี้

บันทึกเหตุการณ์จะบันทึกการโต้ตอบกับเครื่องจำลองแต่ละครั้งในเซสชันปัจจุบัน ดังนั้นบันทึกเหตุการณ์จากการทดสอบก่อนหน้าใน Codelab นี้จะปรากฏเป็นบันทึกเหตุการณ์แรก หากต้องการล้างบันทึกเหตุการณ์ ให้คลิกรีเซ็ตการทดสอบ

5. คลิกชิปคำแนะนำใช่หรือไม่ใช่เพื่อตอบกลับพรอมต์ (คุณยังสามารถพูดว่า "ใช่" หรือ "ไม่ใช่" หรือป้อน Yes หรือ No ในช่องอินพุต)

เมื่อคุณตอบกลับพรอมต์ การดำเนินการของคุณตอบกลับด้วยข้อความที่แจ้งว่าไม่สามารถเข้าใจข้อมูลที่คุณป้อน: "ขออภัย ฉันไม่เข้าใจ ลองอีกครั้งได้ไหม" เนื่องจากคุณยังไม่ได้กำหนดค่าการดำเนินการให้เข้าใจและตอบสนองต่ออินพุต "ใช่" หรือ "ไม่ใช่" การดำเนินการของคุณจึงตรงกับอินพุตกับ Intent NO_MATCH

คำสำคัญ:

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

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

เพิ่ม Intent yes และ no

ขณะนี้ผู้ใช้สามารถตอบคำถามที่การดำเนินการของคุณถามแล้ว คุณสามารถกำหนดค่าการดำเนินการให้เข้าใจผู้ใช้ คำตอบ ("ใช่" หรือ "ไม่ใช่") ในส่วนต่อไปนี้ คุณสร้าง Intent แบบกำหนดเองที่ตรงกันเมื่อผู้ใช้พูดว่า "ใช่" หรือ "ไม่ใช่" และเพิ่ม Intent เหล่านี้ลงในฉาก Start

สร้าง Intent yes

หากต้องการสร้าง Intent yes ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นสร้างไดเรกทอรีใหม่ชื่อ intents ในไดเรกทอรี custom ดังนี้

mkdir custom/intents 

2. สร้างไฟล์ใหม่ชื่อ yes.yaml ในไดเรกทอรี intents:

touch custom/intents/yes.yaml

3. เปิด yes.yaml ในโปรแกรมแก้ไขข้อความ
4. วางข้อมูลโค้ดต่อไปนี้ที่มีวลีการฝึกอบรมลงใน yes.yaml:

yes.yaml

trainingPhrases:
- of course
- let's do it
- ok
- sure
- "y"
- "yes"

5. บันทึกไฟล์

เพิ่ม Intent yes ใน Start ฉาก

ตอนนี้การดำเนินการจะเข้าใจได้เมื่อผู้ใช้แสดงความตั้งใจ "ใช่" คุณสามารถเพิ่มความตั้งใจที่กำหนดเอง yes ลงในฉาก Start เนื่องจากผู้ใช้ตอบสนองต่อข้อความแจ้งของ Start ("ก่อนทำภารกิจต่อ คุณอยากบอกดวงชะตาไหม")

หากต้องการเพิ่มความตั้งใจที่กำหนดเองนี้ลงในฉาก Start ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด custom/scenes/Start.yaml ในโปรแกรมแก้ไขข้อความ
2. เพิ่มตัวแฮนเดิล intentEvents และ yes ต่อท้ายไฟล์ Start.yaml:

Start.yaml

intentEvents:
- handler:
    staticPrompt:
      candidates:
      - promptResponse:
          firstSimple:
            variants:
            - speech: Your future depends on the item you choose to use for your quest. Choose wisely! Farewell, stranger.
  intent: "yes"
  transitionToScene: actions.scene.END_CONVERSATION

เมื่อจับคู่ Intent ของ yes แล้ว ระบบจะเพิ่มพรอมต์ "YourFuture ทั้งนี้ขึ้นอยู่กับรายการที่คุณเลือกใช้สำหรับภารกิจ..." ลงในคิวพรอมต์ จากนั้นฉาก Start จะเปลี่ยนเป็นโหมดระบบ actions.scene.END_CONVERSATION ซึ่งจะส่งพรอมต์ในคิวพรอมต์และจบการสนทนา

ทดสอบ Intent yes ในเครื่องจำลอง

ในขั้นตอนนี้ การดำเนินการของคุณจะเข้าใจเมื่อผู้ใช้ต้องการฟังคำทำนายและแสดงผลคำตอบที่เหมาะสม

หากต้องการทดสอบ Intent นี้ในเครื่องจำลอง ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นเรียกใช้คำสั่งต่อไปนี้

gactions deploy preview

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. คลิกทดสอบเพื่อนำคุณไปที่เครื่องจำลอง
4. หากต้องการทดสอบการดำเนินการในเครื่องมือจำลอง ให้พิมพ์ Talk to my test app ในช่องอินพุต แล้วกด Enter
5. พิมพ์ Yes ในช่อง Input แล้วกด Enter หรือคลิกชิปคำแนะนำใช่

การดำเนินการของคุณตอบสนองต่อผู้ใช้และบอกดวงชะตาของผู้ใช้จะขึ้นอยู่กับความช่วยเหลือที่เลือก จากนั้นการดำเนินการของคุณจะสิ้นสุดลงเซสชันเนื่องจากคุณกำหนดค่าการเปลี่ยน End conversation สำหรับ Intent yes

สร้าง Intent no

ตอนนี้คุณสามารถสร้าง Intent no เพื่อให้การดำเนินการเข้าใจและตอบสนองต่อผู้ใช้เมื่อไม่ต้องการฟังคำทำนายได้

หากต้องการสร้างความตั้งใจนี้ ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นสร้างไฟล์ใหม่ชื่อ no.yaml ในไดเรกทอรี intents ดังนี้

touch custom/intents/no.yaml

2. เปิด no.yaml ในโปรแกรมแก้ไขข้อความ
3. วางวลีการฝึกอบรมต่อไปนี้ลงในไฟล์ no.yaml

no.yaml

trainingPhrases:
- nope
- I don't want
- "n"
- "no"
- nah
- no thanks

4. บันทึกไฟล์

เพิ่ม Intent no ใน Start ฉาก

ตอนนี้การดำเนินการจะเข้าใจเมื่อผู้ใช้แสดงความรู้สึก "no" หรือข้อความที่คล้ายกับ "no" เช่น "nope" คุณต้องเพิ่มความตั้งใจที่กำหนดเอง no ลงในฉาก Start เนื่องจากผู้ใช้ตอบสนองต่อข้อความแจ้งของ Start ("ก่อนไปทำภารกิจต่อ คุณอยากบอกดวงชะตาไหม")

หากต้องการเพิ่ม Intent นี้สำหรับฉาก Start ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด custom/scenes/Start.yaml ในโปรแกรมแก้ไขข้อความ
2. เพิ่มตัวแฮนเดิล no ต่อไปนี้ใต้เครื่องจัดการ yes ใน Start.yaml

Start.yaml

- handler:
    staticPrompt:
      candidates:
      - promptResponse:
          firstSimple:
            variants:
            - speech: I understand, stranger. Best of luck on your quest! Farewell.
  intent: "no"
  transitionToScene: actions.scene.END_CONVERSATION

3. บันทึกไฟล์

ทดสอบ Intent no ในเครื่องจำลอง

ในขั้นตอนนี้ การดำเนินการของคุณจะเข้าใจเมื่อผู้ใช้ไม่ต้องการฟังโชคชะตาของตนเองและส่งกลับคำตอบที่เหมาะสม

หากต้องการทดสอบ Intent นี้ในเครื่องจำลอง ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นเรียกใช้คำสั่งต่อไปนี้

gactions deploy preview

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. คลิกทดสอบเพื่อนำคุณไปที่เครื่องจำลอง
4. พิมพ์ Talk to my test app ในช่อง Input แล้วกด Enter
5. พิมพ์ No ในช่อง Input แล้วกด Enter หรือคลิกชิปคำแนะนำ No

การดำเนินการของคุณขอให้พวกเขาโชคดีบนเส้นทาง แทนการให้โชคลาภแก่ผู้ใช้ จากนั้นการดำเนินการของคุณจะสิ้นสุดลงเซสชันเนื่องจากคุณกำหนดค่าการเปลี่ยน End conversation สำหรับ Intent no

5. ใช้การจำหน่าย

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

คำสำคัญ

• Fulfillment: โค้ดที่มีตรรกะสำหรับการดำเนินการของคุณ เว็บฮุคทริกเกอร์ให้เรียกใช้การดำเนินการตามคำสั่งซื้อโดยอิงตามเหตุการณ์ที่เกิดขึ้นภายในการดำเนินการของคุณ

การดำเนินการตามคำสั่งซื้อจะระบุว่าผู้ใช้เป็นผู้ใช้ที่กลับมาหรือผู้ใช้ใหม่ และแก้ไขข้อความทักทายของการดำเนินการสำหรับผู้ใช้ที่กลับมา ข้อความทักทายจะถูกตัดให้สั้นลงสำหรับผู้ใช้ที่กลับมาและรับทราบการกลับมาของผู้ใช้: "สวัสดีที่มหัศจรรย์ นักผจญภัย! ขอต้อนรับกลับสู่ดินแดนในตำนานของ Gryffinberg!"

สำหรับ Codelab นี้ คุณจะใช้ตัวแก้ไข Cloud Functions เพื่อแก้ไขและทำให้โค้ดการดำเนินการตามคำสั่งซื้อใช้งานได้

คำสำคัญ

• ตัวแก้ไขฟังก์ชันระบบคลาวด์: เครื่องมือแก้ไขแบบผสานรวมสำหรับโปรเจ็กต์ Actions ที่แก้ไขและทำให้โค้ดการดำเนินการตามคำสั่งซื้อใช้งานได้โดยใช้ Cloud Functions for Firebase

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

สร้างการดำเนินการตามคำสั่งซื้อ

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

ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มตรรกะนี้ลงในการดำเนินการให้สมบูรณ์

1. ในเทอร์มินัล ให้ตรวจสอบว่าคุณอยู่ในไดเรกทอรีรากของโปรเจ็กต์และสร้างไดเรกทอรี webhooks ใหม่ โดยทำดังนี้

mkdir webhooks 

2. สร้างไฟล์ใหม่ชื่อ ActionsOnGoogleFulfillment.yaml ในไดเรกทอรี webhooks:

touch webhooks/ActionsOnGoogleFulfillment.yaml

3. เปิด ActionsOnGoogleFulfillment.yaml ในโปรแกรมแก้ไขข้อความ
4. เพิ่มตัวแฮนเดิล greeting และเนื้อหา inlineCloudFunction ลงในไฟล์ ActionsOnGoogleFulfillment.yaml ดังนี้

ActionsOnGoogleFulfillment.yaml

handlers:
- name: greeting
inlineCloudFunction:
  executeFunction: ActionsOnGoogleFulfillment

ไฟล์ ActionsOnGoogleFulfillment.yaml จะกำหนดเครื่องจัดการเว็บฮุค (เช่น ตัวแฮนเดิล greeting) และบอกให้การดำเนินการใช้ฟังก์ชันระบบคลาวด์เป็นปลายทางของเว็บฮุค

5. สร้างไดเรกทอรี ActionsOnGoogleFulfillment ใหม่ในไดเรกทอรี webhooks:

mkdir webhooks/ActionsOnGoogleFulfillment

6. สร้างไฟล์ใหม่ชื่อ index.js ในไดเรกทอรี ActionsOnGoogleFulfillment:

touch webhooks/ActionsOnGoogleFulfillment/index.js

7. เปิด index.js ในโปรแกรมแก้ไขข้อความ
8. เพิ่มโค้ดต่อไปนี้ใน index.js:

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

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

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});


exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

โค้ดนี้จะระบุเครื่องจัดการ greeting ซึ่งจะส่งคำทักทายที่เหมาะสมไปยัง

ผู้ใช้

9. บันทึกไฟล์
10. สร้างไฟล์ใหม่ชื่อ package.json ในไดเรกทอรี ActionsOnGoogleFulfillment:

touch webhooks/ActionsOnGoogleFulfillment/package.json

ไฟล์ package.json จะระบุทรัพยากร Dependency และข้อมูลเมตาอื่นๆ สำหรับเว็บฮุคของคุณ

11. เปิด package.json ในโปรแกรมแก้ไขข้อความ
12. คัดลอกโค้ดจากที่เก็บ GitHub นี้และวางลงในไฟล์ package.json
13. บันทึกไฟล์

ทำความเข้าใจโค้ด

การดำเนินการตามคำสั่งซื้อซึ่งใช้ไลบรารี Actions on Google Fulfillment สำหรับ Node.js จะตอบสนองต่อคำขอ HTTP จาก Google Assistant

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

อัปเดตการเรียกใช้หลักเพื่อทริกเกอร์เว็บฮุค

เมื่อกำหนดฟังก์ชัน greeting แล้ว คุณก็กำหนดค่าเครื่องจัดการเหตุการณ์ greeting ใน Intent การเรียกใช้หลักได้ เพื่อให้การดำเนินการของคุณเรียกใช้ฟังก์ชันนี้เมื่อผู้ใช้เรียกใช้การดำเนินการของคุณ

หากต้องการกำหนดค่าการดำเนินการของคุณให้เรียกใช้เครื่องจัดการ greeting ใหม่ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด custom/global/actions.intent.MAIN.yaml ในโปรแกรมแก้ไขข้อความ
2. แทนที่รหัสใน actions.intent.MAIN.yaml ด้วยรหัสต่อไปนี้:

actions.intent.MAIN.yaml

handler:
  webhookHandler: greeting
transitionToScene: Start

3. บันทึกไฟล์

ในตอนนี้ เมื่อตรงกับ Intent การเรียกใช้หลักแล้ว ระบบจะเรียกใช้เครื่องจัดการเว็บฮุค greeting

ทดสอบการเรียกใช้หลักที่อัปเดตในเครื่องมือจำลอง

หากต้องการทดสอบการดำเนินการในเครื่องมือจำลอง ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นเรียกใช้คำสั่งต่อไปนี้

เนื่องจากคำสั่งนี้ทำให้ทรัพยากร Dependency ของเว็บฮุคและการติดตั้งใช้งานได้ จึงใช้เวลานานกว่าคำสั่งก่อนหน้า

gactions deploy preview

หากคุณได้รับข้อผิดพลาด 403 เกี่ยวกับ Cloud Build API หรือข้อผิดพลาด 403 เกี่ยวกับการเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงิน โปรดดูเปิดใช้ ปิดใช้ หรือเปลี่ยนแปลงการเรียกเก็บเงินสำหรับโปรเจ็กต์ คุณต้องเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงินกับโปรเจ็กต์ใน Google Cloud เพื่อทำให้ใช้งานได้โดยใช้ Cloud Functions หลังจากเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงินแล้ว ให้เรียกใช้ gactions deploy preview อีกครั้ง โปรดทำตามขั้นตอนในส่วน "ล้างโปรเจ็กต์" ที่ตอนท้ายของ Codelab เพื่อหลีกเลี่ยงการเรียกเก็บเงิน

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. หากต้องการทดสอบการดำเนินการในเครื่องมือจำลอง ให้พิมพ์ Talk to my test app ในช่องอินพุต แล้วกด Enter

เนื่องจากคุณทดสอบการดำเนินการของคุณก่อนหน้านี้ใน Codelab นี้แล้ว คุณไม่ใช่ผู้ใช้ใหม่ จึงได้รับคำทักทายแบบย่อดังนี้ "สวัสดี ผู้มาผจญภัย! ขอต้อนรับกลับสู่ดินแดนในตำนานของ Gryffinberg!..."

6. แสดงภาพการดำเนินการด้วยเครื่องมือสร้างการดำเนินการ

Actions SDK สามารถทำงานร่วมกับ IDE บนเว็บที่เรียกว่า Actions Builder ที่ผสานรวมไว้ในคอนโซล Actions คุณจะพุชระบบไฟล์ในเครื่องไปยังฉบับร่างของการดำเนินการในคอนโซลได้ด้วยคำสั่ง gactions push gactions push จะย้ายเนื้อหาทั้งหมดจากไฟล์ในเครื่องไปยัง Actions Builder ซึ่งต่างจาก gactions deploy preview ซึ่งให้คุณทดสอบการดำเนินการในเครื่องมือจำลองเท่านั้น

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

การเรียกใช้ gactions push จะลบล้างฉบับร่างปัจจุบันของโปรเจ็กต์ Actions หากคุณทำงานร่วมกัน

หากต้องการพุชโปรเจ็กต์ Actions และดูโปรเจ็กต์ในคอนโซล Actions ให้ทำตามขั้นตอนต่อไปนี้

1. จากนั้นเรียกใช้คำสั่งต่อไปนี้เพื่อพุชโปรเจ็กต์ไปยังคอนโซล Actions

gactions push

คุณควรได้รับเอาต์พุตที่มีลักษณะดังนี้

✔ Done. Files were pushed to Actions Console, and you can now view your project with this URL: https://console.actions.google.com/project/{project-id}/overview. If you want to test your changes, run "gactions deploy preview", or navigate to the Test section in the Console.

2. คัดลอก URL ที่ระบุและวางลงในเบราว์เซอร์
3. ในคอนโซลการดําเนินการ ให้คลิกพัฒนาในแถบนำทางด้านบน
4. คลิกลูกศรแบบเลื่อนลงถัดจากฉาก แล้วคลิกเริ่ม คุณควรจะเห็นภาพแสดงฉาก Start ของการดำเนินการตามที่แสดงในภาพหน้าจอต่อไปนี้

ล้างข้อมูลโปรเจ็กต์ [แนะนำ]

ข้อควรระวัง: Codelab ระดับ 2 สร้างการทำงานสำหรับ Google Assistant โดยใช้ Actions SDK (ระดับ 2) จะต่อยอดมาจากโปรเจ็กต์ที่คุณสร้างไว้ใน Codelab นี้ หากคุณวางแผนที่จะทำ Codelab ระดับ 2 โปรดอย่าลบโครงการของคุณ ให้ลบโปรเจ็กต์ใน "ล้างข้อมูลโปรเจ็กต์" แทน ที่ตอนท้ายของ Codelab ระดับ 2

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

1. หากต้องการลบโปรเจ็กต์และทรัพยากรที่อยู่ในระบบคลาวด์ ให้ทำตามขั้นตอนที่ระบุไว้ในส่วนการปิดระบบ (ลบ) โปรเจ็กต์

โปรดตรวจสอบว่าคุณได้เลือกโปรเจ็กต์ที่ถูกต้องสำหรับการลบในหน้าการตั้งค่า Google Cloud Platform

2. ไม่บังคับ: หากต้องการนำโปรเจ็กต์ออกจากคอนโซล Actions ทันที ให้ทำตามขั้นตอนที่แสดงในส่วนลบโปรเจ็กต์ หากไม่ทำขั้นตอนนี้ ระบบจะนำโปรเจ็กต์ของคุณออกโดยอัตโนมัติหลังจากผ่านไปประมาณ 30 วัน

7. ยินดีด้วย

คุณรู้พื้นฐานในการสร้าง Actions สำหรับ Google Assistant ด้วย Actions SDK

สิ่งที่คุณได้ครอบคลุม

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

ดูข้อมูลเพิ่มเติม

ดูแหล่งข้อมูลต่อไปนี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้าง Actions สําหรับ Google Assistant

• เว็บไซต์เอกสารประกอบอย่างเป็นทางการสำหรับการพัฒนา Actions for Google Assistant
• หน้า Actions on Google GitHub สำหรับโค้ดและไลบรารีตัวอย่าง
• ชุมชน Reddit อย่างเป็นทางการสำหรับนักพัฒนาแอปที่ทำงานร่วมกับ Assistant

ติดตาม @ActionsOnGoogle บน Twitter เพื่อดูประกาศล่าสุดและทวีตด้วย #AoGDevs เพื่อแชร์สิ่งที่คุณสร้าง

แบบสำรวจความคิดเห็น

ก่อนไป โปรดตอบแบบสำรวจสั้นๆ เกี่ยวกับประสบการณ์ที่คุณได้รับ