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

คู่มือนี้จะอธิบายการตั้งค่าสภาพแวดล้อมเพื่อสร้างการดำเนินการโดยใช้ทั้ง 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 ให้ทำตามขั้นตอนต่อไปนี้

  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 จะตรวจสอบสิทธิ์โดยอัตโนมัติ

สร้างและสร้างโปรเจ็กต์

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

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

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

ตัวอย่างแบบอินเทอร์แอกทีฟของ Hello World จะแสดงวิธีสร้างโปรเจ็กต์ Actions แบบง่ายๆ ด้วย 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 เป็นรหัสโปรเจ็กต์

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

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

  1. จากไดเรกทอรี interactive-canvas-sample/ ให้เรียกใช้คำสั่งต่อไปนี้เพื่อทำให้เว็บแอป 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
    
  5. เปิดลิงก์ที่เครื่องมือบรรทัดคำสั่งส่งกลับมาเพื่อไปที่เครื่องจำลอง

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

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