Panduan memulai cepat SDK Actions dan Builder

Panduan ini akan memandu Anda dalam menyiapkan lingkungan untuk membuat Action menggunakan Action SDK dan Action Builder. Anda akan melakukan tugas berikut:

• Menginstal Node.js: Anda membutuhkan lingkungan runtime ini untuk menggunakan library fulfillment Node.js kami.
• Menginstal Firebase CLI: Alat command line ini memungkinkan Anda mengembangkan dan men-deploy dependensi Firebase, seperti aplikasi web untuk Interactive Canvas, ke Firebase Hosting.
• Menginstal alat command line gaction: Saat mengembangkan dengan Actions SDK, Anda menggunakan alat ini untuk membuat, mengelola, dan men-deploy paket Action untuk Action Anda.
• Membuat project Actions: Project Actions adalah container logis untuk Action Percakapan Anda. Anda harus membuatnya di konsol Actions sebelum dapat mulai mem-build.
• Menginisialisasi dan men-deploy sampel: Contoh sederhana ini menunjukkan cara mulai membuat Action yang didukung oleh Interactive Canvas.

Setelah menyelesaikan panduan memulai cepat ini, Anda dapat menyinkronkan project Actions antara lingkungan pengembangan lokal dan pengalaman web Actions Builder.

Menginstal Node.js dan Firebase CLI

Download dan instal Node.js sesuai dengan dokumentasi Node.js untuk menggunakan library fulfillment kami. Penginstalan Node.js juga memungkinkan Anda untuk menginstal Firebase CLI dengan npm, dan kemudian, untuk menjalankan implementasi fulfillment percakapan Anda secara lokal.

Instal dan siapkan Firebase CLI sesuai dengan dokumentasi Firebase. Dengan Firebase CLI, Anda dapat men-deploy aplikasi web Canvas Interaktif ke Firebase Hosting dan, jika perlu, men-deploy fulfillment ke Cloud Functions for Firebase secara manual.

Menginstal alat command line gaction

Instal alat antarmuka command line (CLI) gactions dengan mendownload paket penginstalan, mengekstraknya, dan mengonfigurasi jalur eksekusi.

Untuk menginstal dan mengonfigurasi gaction, ikuti langkah-langkah berikut:

1. Download paket yang sesuai untuk sistem operasi Anda:

   Platform	Package (Paket)	Checksum
   Windows	Download	SHA256
   Linux	Download	SHA256
   OS Mac	Download	SHA256

2. Ekstrak paket ke lokasi pilihan Anda dan tambahkan biner ke variabel PATH lingkungan Anda. Atau, ekstrak paket ke lokasi yang sudah ada dalam variabel PATH Anda (misalnya /usr/local/bin).

3. Di Linux dan Mac, aktifkan izin eksekusi jika diperlukan:

   chmod +x PATH_TO/gactions

4. Jalankan perintah berikut untuk mengautentikasi CLI. Perintah ini memulai alur autentikasi dan memerlukan browser web:

   gactions login

   Setelah alur selesai, CLI akan otomatis mengautentikasi.

Membuat dan menyiapkan project

Catatan: Pembuatan project tindakan tidak didukung di CLI gaksi.

Sebelum dapat menggunakan alat command line gaction, Anda harus membuat project di konsol Actions dan memberi gaksi akses ke project tersebut. Untuk membuat dan menyiapkan project, lakukan langkah berikut:

1. Buka konsol Actions.
2. Klik Project baru, masukkan nama project, lalu klik Buat project.
3. Pilih kategori, lalu klik Next.
4. Pilih Project kosong, lalu klik Mulai mem-build.
5. Aktifkan Actions API di Google Cloud Console dengan mengikuti petunjuk di Mengaktifkan dan menonaktifkan API. Hal ini memungkinkan gaksi berinteraksi dengan project Anda.

Mendapatkan contoh hello world

Contoh interaktif hello world menunjukkan cara membuat project Actions sederhana dengan satu Action yang didukung oleh Interactive Canvas.

1. Buat direktori kosong dan inisialisasi sampel Canvas Interaktif di direktori tersebut. Misalnya, kode berikut menginisialisasi contoh dalam direktori interactive-canvas-sample/, yang digunakan sebagai contoh di seluruh dokumen ini:

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

2. Buka file interactive-canvas-sample/sdk/settings/settings.yaml dan ubah nilai kolom projectId menjadi ID project Anda.

   Catatan: Untuk mendapatkan ID project Anda, pertama-tama buka project Anda di konsol Actions, lalu klik ikon lainnya. Kemudian, pilih Project settings dan salin string di kolom Project ID.

Men-deploy dan menguji sampel

Setelah menyiapkan contoh, Anda dapat men-deploy aplikasi web Interactive Canvas dan project Actions. Proses ini membuat versi draf project Action yang dapat Anda deploy ke simulator Action untuk pratinjau dan pengujian:

1. Dari direktori interactive-canvas-sample/, jalankan perintah berikut untuk men-deploy aplikasi web Interactive Canvas (konten direktori public/).

   firebase deploy --project PROJECT_ID --only hosting
   

   Anda dapat melihat versi aplikasi web yang dirender di URL yang ditampilkan oleh Firebase CLI di browser: https://PROJECT_ID.web.app.

2. Buka file interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js dan ubah nilai variabel CANVAS_URL menjadi URL aplikasi web project Anda.

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

3. Dari direktori interactive-canvas-sample/sdk/, jalankan perintah berikut untuk mengirim versi lokal project Action Anda ke konsol sebagai versi draf:

   gactions push
   

   Catatan: Anda akan melihat beberapa peringatan terkait tidak adanya beberapa setelan dan resource project yang ditentukan. Anda dapat mengabaikannya dengan aman atau sekarang.

4. Dari direktori interactive-canvas-sample/sdk/, jalankan perintah berikut untuk menguji project Action Anda di simulator:

   gactions deploy preview
   

   Catatan: Jika menggunakan project baru, Anda perlu mengaktifkan Cloud Functions API dan mengaitkan akun penagihan dengan project Anda di Google Cloud. Anda dapat mengaktifkan Cloud Functions API dengan membuka Cloud Console.

5. Buka link yang ditampilkan alat command line untuk membuka simulator.

6. Di simulator, masukkan "Talk to Interactive canvas sample" untuk memulai Action. Anda akan melihat segitiga berputar yang didukung oleh aplikasi web yang di-deploy pada https://PROJECT_ID.web.app

   

   Gambar 1. Simulator yang melihat pratinjau project Actions