คู่มือนี้จะอธิบายการตั้งค่าสภาพแวดล้อมเพื่อสร้างการดำเนินการโดยใช้ทั้ง Actions SDK และ Actions Builder คุณจะดำเนินการต่อไปนี้
- ติดตั้ง Node.js: คุณต้องมีสภาพแวดล้อมรันไทม์นี้เพื่อใช้ไลบรารี Fulfillment ของ Node.js
- ติดตั้ง Firebase CLI: เครื่องมือบรรทัดคำสั่งนี้ช่วยให้คุณพัฒนาและนำทรัพยากร Dependency ของ Firebase เช่น เว็บแอปสำหรับ Interactive Canvas ไปใช้กับโฮสติ้งของ Firebase ได้
- ติดตั้งเครื่องมือบรรทัดคำสั่ง gactions: เมื่อพัฒนาด้วย Actions SDK คุณจะใช้เครื่องมือนี้เพื่อสร้าง จัดการ และทำให้แพ็กเกจ Action ใช้งานได้สำหรับ Action ของคุณ
- สร้างโปรเจ็กต์ Actions: โปรเจ็กต์ Actions เป็นคอนเทนเนอร์เชิงตรรกะสําหรับการดําเนินการแบบการสนทนา คุณต้องสร้าง URL ในคอนโซลการดำเนินการ ก่อนจึงจะเริ่มสร้างได้
- เริ่มต้นและทำให้ตัวอย่างใช้งานได้: ตัวอย่างง่ายๆ นี้แสดงวิธีเริ่มสร้าง Actions ที่ขับเคลื่อนโดย Interactive Canvas
เมื่อเริ่มต้นอย่างรวดเร็วนี้เสร็จแล้ว คุณจะซิงค์โปรเจ็กต์ Actions ระหว่างสภาพแวดล้อมการพัฒนาในเครื่องกับประสบการณ์การใช้งานเว็บของ Actions Builder ได้
ติดตั้ง Node.js และ Firebase CLI
ดาวน์โหลดและติดตั้ง Node.js ตามเอกสารประกอบ Node.js เพื่อใช้ไลบรารี Fulfillment ของเรา การติดตั้ง Node.js ยังช่วยให้คุณติดตั้ง Firebase CLI ด้วย npm และหลังจากนั้นเพื่อเรียกใช้การติดตั้งใช้งาน Fulfillment การสนทนาภายในเครื่องได้
ติดตั้งและตั้งค่า Firebase CLI ตามเอกสาร Firebase Firebase CLI ให้คุณทำให้เว็บแอป Canvas แบบอินเทอร์แอกทีฟใช้งานได้กับโฮสติ้งของ Firebase และติดตั้งใช้งาน Fulfillment บน Cloud Functions for Firebase ด้วยตนเองได้หากจำเป็น
ติดตั้งเครื่องมือบรรทัดคำสั่ง gactions
ติดตั้งเครื่องมืออินเทอร์เฟซบรรทัดคำสั่ง (CLI) ของ gactions โดยดาวน์โหลดแพ็กเกจการติดตั้ง คลายการแพคข้อมูล และกำหนดค่าเส้นทางการดำเนินการ
หากต้องการติดตั้งและกำหนดค่า Gactions ให้ทำตามขั้นตอนต่อไปนี้
ดาวน์โหลดแพ็กเกจที่เหมาะกับระบบปฏิบัติการของคุณ
แพลตฟอร์ม Package ตรวจสอบข้อผิดพลาด Windows ดาวน์โหลด SHA256 Linux ดาวน์โหลด SHA256 Mac OS ดาวน์โหลด SHA256 แยกแพ็กเกจไปยังตำแหน่งที่ต้องการ แล้วเพิ่มไบนารีลงในตัวแปร
PATH
ของสภาพแวดล้อม อีกทางเลือกหนึ่งคือ แตกแพ็กเกจไปยังตำแหน่งที่มีในตัวแปรPATH
อยู่แล้ว (เช่น/usr/local/bin
)ใน Linux และ Mac ให้เปิดใช้สิทธิ์ดำเนินการหากจำเป็น
chmod +x PATH_TO/gactions
เรียกใช้คำสั่งต่อไปนี้เพื่อตรวจสอบสิทธิ์ CLI คำสั่งนี้จะเริ่มขั้นตอนการตรวจสอบสิทธิ์และต้องใช้เว็บเบราว์เซอร์
gactions login
เมื่อโฟลว์เสร็จสมบูรณ์แล้ว CLI จะตรวจสอบสิทธิ์โดยอัตโนมัติ
สร้างและสร้างโปรเจ็กต์
ก่อนที่จะใช้เครื่องมือบรรทัดคำสั่ง gactions คุณต้องสร้างโปรเจ็กต์ในคอนโซล Actions และให้สิทธิ์เข้าถึงโครงการแก่ gactions ก่อน หากต้องการสร้างและตั้งค่าโปรเจ็กต์ ให้ทำดังนี้
- ไปที่คอนโซลการดําเนินการ
- คลิกโครงการใหม่ ป้อนชื่อโครงการแล้วคลิกสร้างโครงการ
- เลือกหมวดหมู่แล้วคลิกถัดไป
- เลือกโครงการเปล่าแล้วคลิกเริ่มสร้าง
- เปิดใช้ Actions API ในคอนโซล Google Cloud โดยทำตามวิธีการในหัวข้อเปิดใช้และปิดใช้ API วิธีนี้ช่วยให้การกระทำโต้ตอบกับโปรเจ็กต์ของคุณได้
ดูตัวอย่าง Hello World
ตัวอย่างแบบอินเทอร์แอกทีฟของ Hello World จะแสดงวิธีสร้างโปรเจ็กต์ Actions แบบง่ายๆ ด้วย Action เดียวที่ขับเคลื่อนโดย Interactive Canvas
สร้างไดเรกทอรีเปล่าและเริ่มต้นตัวอย่าง Interactive Canvas ในไดเรกทอรีนั้น ตัวอย่างเช่น โค้ดต่อไปนี้เริ่มต้นตัวอย่างในไดเรกทอรี
interactive-canvas-sample/
ซึ่งใช้เป็นตัวอย่างในเอกสารนี้gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample
เปิดไฟล์
interactive-canvas-sample/sdk/settings/settings.yaml
และเปลี่ยนค่าของช่องprojectId
เป็นรหัสโปรเจ็กต์
ทำให้ตัวอย่างใช้งานได้และทดสอบตัวอย่าง
หลังจากตั้งค่าตัวอย่างแล้ว คุณจะทำให้เว็บแอป Canvas แบบอินเทอร์แอกทีฟและโปรเจ็กต์ Actions ใช้งานได้ กระบวนการนี้จะสร้างโปรเจ็กต์ Actions เวอร์ชันร่างที่คุณนําไปใช้กับเครื่องมือจําลองการดําเนินการเพื่อดูตัวอย่างและทดสอบได้ ดังนี้
จากไดเรกทอรี
interactive-canvas-sample/
ให้เรียกใช้คำสั่งต่อไปนี้เพื่อทำให้เว็บแอป Canvas แบบอินเทอร์แอกทีฟใช้งานได้ (เนื้อหาของไดเรกทอรีpublic/
)firebase deploy --project PROJECT_ID --only hosting
คุณดูเว็บแอปเวอร์ชันที่แสดงผลได้ที่ URL ที่แสดงผลโดย Firebase CLI ในเบราว์เซอร์ ดังนี้
https://PROJECT_ID.web.app
เปิดไฟล์
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
และเปลี่ยนค่าของตัวแปรCANVAS_URL
เป็น URL เว็บแอปของโปรเจ็กต์const CANVAS_URL = 'https://PROJECT_ID.web.app';
จากไดเรกทอรี
interactive-canvas-sample/sdk/
ให้เรียกใช้คำสั่งต่อไปนี้เพื่อพุชเวอร์ชันในเครื่องของโปรเจ็กต์ Actions ไปยังคอนโซลในฐานะเวอร์ชันร่างgactions push
จากไดเรกทอรี
interactive-canvas-sample/sdk/
ให้เรียกใช้คำสั่งต่อไปนี้เพื่อทดสอบโปรเจ็กต์ Actions ในเครื่องมือจำลองgactions deploy preview
เปิดลิงก์ที่เครื่องมือบรรทัดคำสั่งส่งกลับมาเพื่อไปที่เครื่องจำลอง
ในเครื่องจำลอง ให้ป้อน "พูดกับตัวอย่างผ้าใบแบบอินเทอร์แอกทีฟ" เพื่อเริ่มการดำเนินการ คุณควรเห็นสามเหลี่ยมหมุนที่ขับเคลื่อนโดยเว็บแอปซึ่งทำให้ใช้งานได้ที่
https://PROJECT_ID.web.app