คู่มือเริ่มใช้งานฉบับย่อสําหรับ SDK เครื่องมือสร้างและเครื่องมือสร้าง

คู่มือนี้จะอธิบายการตั้งค่าสภาพแวดล้อมเพื่อสร้างการทํางาน โดยใช้ทั้ง Actions SDK และ Action Builder โดยจะต้องดําเนินงานต่อไปนี้

• ติดตั้ง Node.js: คุณต้องมีสภาพแวดล้อมรันไทม์นี้เพื่อใช้ไลบรารีการดําเนินการของ Node.js
• ติดตั้ง Firebase CLI: เครื่องมือบรรทัดคําสั่งนี้ช่วยให้คุณพัฒนาและใช้ทรัพยากร Dependency ของ Firebase เช่น เว็บแอปสําหรับ Interactive Canvas ไปยังโฮสติ้งของ Firebase ได้
• ติดตั้งเครื่องมือบรรทัดคําสั่ง GPA: เมื่อพัฒนาด้วย Actions SDK คุณใช้เครื่องมือนี้ในการสร้าง จัดการ และทําให้แพ็กเกจการดําเนินการใช้งานได้
• สร้างโปรเจ็กต์การดําเนินการ: โปรเจ็กต์การดําเนินการคือคอนเทนเนอร์ที่เหมาะสมสําหรับการดําเนินการด้านการสนทนา คุณต้องสร้างคอนโซลขึ้นในคอนโซลการทํางานก่อน จึงจะเริ่มสร้างได้
• เริ่มต้นและทําให้ตัวอย่างใช้งานได้: ตัวอย่างแบบง่ายนี้จะแสดงวิธีเริ่มต้นสร้างการดําเนินการที่ขับเคลื่อนโดย Interactive Canvas

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

ติดตั้ง Node.js และ Firebase CLI

ดาวน์โหลดและติดตั้ง Node.js ตามเอกสารประกอบ Node.js เพื่อใช้คลังการดําเนินการของเรา นอกจากนี้ การติดตั้ง Node.js ยังช่วยให้คุณติดตั้ง Firebase CLI ด้วย npm ขึ้นไป เพื่อเรียกใช้การดําเนินการตามการใช้งานของบริบทภายในเครื่องได้

ติดตั้งและตั้งค่า Firebase CLI ตามเอกสารประกอบใน Firebase Firebase CLI ช่วยให้คุณทําให้เว็บแอป Canvas เชิงโต้ตอบใช้งานได้กับโฮสติ้งของ Firebase และการทําให้ Cloud Functions for Firebase ใช้งานได้ด้วยตนเองหากจําเป็น

ติดตั้งเครื่องมือบรรทัดคําสั่ง gactions

ติดตั้งเครื่องมืออินเทอร์เฟซบรรทัดคําสั่ง (CLI) ด้วยการดาวน์โหลดแพ็กเกจการติดตั้ง คลายการแพคแพ็กเกจ และกําหนดค่าเส้นทางการดําเนินการ

หากต้องการติดตั้งและกําหนดค่าช่องว่าง ให้ทําตามขั้นตอนต่อไปนี้

1. ดาวน์โหลดแพคเกจที่เหมาะสมสําหรับระบบปฏิบัติการของคุณ:

   แพลตฟอร์ม	Package	ตรวจสอบข้อผิดพลาด
   Windows	ดาวน์โหลด	SHA256
   Linux	ดาวน์โหลด	SHA256
   Mac OS	ดาวน์โหลด	SHA256

2. แตกแพ็กเกจไปยังตําแหน่งที่คุณต้องการและเพิ่มไบนารีไปยังตัวแปร PATH ของสภาพแวดล้อม หรือแตกแพ็กเกจไปยังตําแหน่งที่อยู่ในตัวแปร PATH อยู่แล้ว (เช่น /usr/local/bin)

3. ใน Linux และ Mac ให้เปิดใช้สิทธิ์การดําเนินการหากจําเป็น

   chmod +x PATH_TO/gactions

4. เรียกใช้คําสั่งต่อไปนี้เพื่อตรวจสอบสิทธิ์ CLI คําสั่งนี้จะเริ่มขั้นตอนการตรวจสอบสิทธิ์และต้องใช้เว็บเบราว์เซอร์

   gactions login

   เมื่อกระบวนการเสร็จสมบูรณ์แล้ว CLI จะตรวจสอบสิทธิ์โดยอัตโนมัติ

สร้างและตั้งค่าโครงการ

หมายเหตุ: CLI ไม่รองรับการสร้างโปรเจ็กต์

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

1. ไปที่คอนโซล Actions
2. คลิกโครงการใหม่ จากนั้นป้อนชื่อโครงการแล้วคลิกสร้างโครงการ
3. เลือกหมวดหมู่ แล้วคลิกถัดไป
4. เลือกโครงการเปล่า แล้วคลิกเริ่มสร้าง
5. เปิดใช้ Actions API ในคอนโซล Google Cloud โดยทําตามวิธีการในหัวข้อเปิดหรือปิดใช้ API การดําเนินการนี้ช่วยให้ช่องว่างโต้ตอบกับโปรเจ็กต์ได้

ดูตัวอย่าง Hello World

ตัวอย่างวิดีโออินเทอร์แอกทีฟของ hello World จะแสดงวิธีการสร้างโปรเจ็กต์การดําเนินการ ที่เรียบง่ายด้วย Action เดียวที่ขับเคลื่อนโดย Interactive Canvas

1. สร้างไดเรกทอรีที่ว่างเปล่าและเริ่มต้นตัวอย่าง Interactive Canvas ในไดเรกทอรีนั้น เช่น โค้ดต่อไปนี้จะเริ่มต้นตัวอย่างในไดเรกทอรี interactive-canvas-sample/ ซึ่งใช้เป็นตัวอย่างตลอดทั้งเอกสารนี้

   gactions init interactive-canvas --dest interactive-canvas-sample
   cd interactive-canvas-sample
   

2. เปิดไฟล์ interactive-canvas-sample/sdk/settings/settings.yaml และเปลี่ยนค่าของช่อง projectId เป็นรหัสของโปรเจ็กต์

   หมายเหตุ: หากต้องการรับรหัสของโครงการ ให้เปิดโครงการในคอนโซลการดําเนินการก่อนแล้วคลิกไอคอน เพิ่มเติม จากนั้นเลือกการตั้งค่าโปรเจ็กต์ แล้วคัดลอกสตริงในช่องรหัสโปรเจ็กต์

ทําให้ใช้งานได้และทดสอบตัวอย่าง

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

1. จากไดเรกทอรี interactive-canvas-sample/ ให้เรียกใช้คําสั่งต่อไปนี้เพื่อทําให้เว็บแอป Interactive Canvas ใช้งานได้ (เนื้อหาของไดเรกทอรี public/)

   firebase deploy --project PROJECT_ID --only hosting
   

   คุณดูเว็บแอปที่แสดงผลได้ใน URL ที่ Firebase CLI แสดงในเบราว์เซอร์ https://PROJECT_ID.web.app

2. เปิดไฟล์ interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js และเปลี่ยนค่าของตัวแปร CANVAS_URL เป็น URL ของเว็บแอปของโปรเจ็กต์

   const CANVAS_URL = 'https://PROJECT_ID.web.app';
   

3. จากไดเรกทอรี interactive-canvas-sample/sdk/ ให้เรียกใช้คําสั่งต่อไปนี้เพื่อพุชโปรเจ็กต์ Actions เวอร์ชันในเครื่องไปยังคอนโซลเป็นเวอร์ชันร่าง

   gactions push
   

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

4. เรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรี interactive-canvas-sample/sdk/ เพื่อทดสอบโครงการ Actions ในเครื่องมือจําลอง

   gactions deploy preview
   

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

5. เปิดลิงก์ที่เครื่องมือบรรทัดคําสั่งกลับมาเพื่อไปยังเครื่องจําลอง

6. ในเครื่องมือจําลอง ให้ป้อน "ตัวอย่างการพูดคุยกับ Canvas แบบอินเทอร์แอกทีฟ" เพื่อเริ่มดําเนินการ คุณจะเห็นรูปสามเหลี่ยมที่หมุนโดยเว็บแอปที่ทําให้ใช้งานได้ที่ https://PROJECT_ID.web.app

   

   รูปที่ 1 เครื่องจําลองแสดงตัวอย่างโปรเจ็กต์การดําเนินการ