Merilis Action

Menguji Action Anda dengan pengguna memberi Anda peluang untuk mendapatkan masukan awal dan memperbaiki masalah teknis atau pengalaman pengguna sebelum Anda merilisnya secara luas.

Konsol Actions mendukung lingkungan rilis sehingga Anda dapat memberikan akses ke sekumpulan pengguna terbatas untuk menguji Action baru, atau versi yang lebih baru dari Action yang ada sebelum menerapkannya ke publik.

Siklus proses rilis

Diagram berikut menunjukkan jalur potensial yang dapat digunakan oleh siklus proses Action:

Gambar 1. Siklus proses Action dengan lingkungan rilis.

Ada dua jenis lingkungan rilis praproduksi yang didukung konsol Actions:

• Alfa: Saluran ini harus digunakan untuk menguji dengan cepat versi awal Action Anda.

  • Memungkinkan Anda mendistribusikan Action ke sekelompok kecil pengguna tanpa melalui ulasan lengkap di Google.
  • Pengguna akan mendapatkan peringatan bahwa Action belum ditinjau oleh Google terkait kepatuhan terhadap kebijakan.
  • Ideal untuk pengujian internal.

• Beta: Saluran ini memungkinkan Anda mendistribusikan Action ke sekumpulan pengguna terbatas setelah lulus peninjauan Google lengkap.

  • Anda harus menggunakan saluran ini untuk memberi pengguna di luar organisasi Anda akses ke Action versi awal.
  • Pengguna akan diberi tahu bahwa Action tersebut adalah versi pratinjau.
  • Karena versi beta telah lulus peninjauan Google, Anda dapat membuatnya bersifat publik kapan saja tanpa peninjauan lain dari Google.

Catatan: Anda hanya dapat memiliki satu Action versi alfa atau beta "aktif" yang dirilis.

Perbandingan lingkungan rilis

Tabel di bawah ini merupakan ringkasan perbedaan antara saluran deployment.

	Simulator	Alfa	Beta	Produksi
Penonton yang dituju	Khusus developer	Penguji awal dalam tim, teman, dan keluarga Anda	Penguji di luar tim Anda	Semua pengguna Asisten Google
Memerlukan Peninjauan Google	Tidak	Tidak	Ya	Ya
Siapa saja yang memiliki akses	Khusus developer	Daftar pengguna yang ditentukan developer. Pengguna harus memilih ikut serta.	Daftar pengguna yang ditentukan developer. Pengguna harus memilih ikut serta.	Tersedia secara publik untuk semua pengguna Asisten Google
Maksimum # pengguna	1	20	200	T/A
Jika tersedia	Simulator dan semua perangkat Asisten	Semua perangkat Asisten	Semua perangkat Asisten	Semua perangkat Asisten
Pembuat Tindakan	Didukung	Didukung	Didukung	Ya
Actions SDK	Didukung	Didukung	Didukung	Ya
Dialogflow	Didukung	Didukung	Didukung	Ya
Smart Home	Didukung (memerlukan penautan akun)	Tidak didukung	Tidak didukung	Ya
Template	Didukung	Tidak didukung	Tidak didukung	Ya
Panggilan eksplisit	Didukung	Didukung	Didukung	Ya
panggilan implisit	Didukung	Didukung	Didukung	Ya
Penautan akun	Didukung	Didukung	Didukung	Ya

Catatan: Jika menggunakan pembuatan versi Dialogflow, Anda dapat men-deploy versi yang berbeda ke lingkungan rilis yang berbeda. Untuk mempelajari lebih lanjut, lihat Mengirim project Anda.

Mengelola pengujian untuk rilis alfa atau beta

Untuk menyiapkan pengujian alfa atau beta, ikuti langkah-langkah berikut:

1. Klik Kelola penguji Alfa atau Kelola penguji Beta.

2. Ketik alamat email untuk penguji, yang dipisahkan dengan koma. Anda dapat menentukan hingga 20 penguji untuk pengujian alfa dan 200 penguji untuk pengujian beta.

   Catatan: Penguji harus memiliki Akun Google (@gmail.com) atau Google Workspace. Anda tidak dapat menetapkan sejumlah pengguna melalui email alias grup Google.

   

3. Salin Link keikutsertaan untuk dibagikan kepada penguji.

4. Klik Simpan.

Anda harus mengirimkan email undangan kepada penguji dengan link ke Action versi alfa atau beta (link keikutsertaan). Untuk mempelajari lebih lanjut, lihat Mendapatkan masukan.

Link keikutsertaan

Link keikutsertaan mewakili halaman direktori Tindakan Anda dan tidak pernah berubah. Link akan mengarahkan penguji ke halaman direktori Anda, dan melihat kartu keikutsertaan untuk lingkungan yang memenuhi syarat. Jika Anda mencantumkan penguji yang sama untuk alfa dan beta, mereka memenuhi syarat untuk keduanya dan melihat kartu keikutsertaan untuk versi alfa terlebih dahulu.

Mengimplementasikan fulfillment untuk rilis alfa atau beta

Informasi saluran rilis tidak disertakan dalam permintaan HTTP dari Asisten ke fulfillment Anda. Untuk menangani saluran rilis di fulfillment Anda, Anda harus memberikan URL fulfillment yang berbeda (misalnya, satu URL fulfillment untuk versi beta dan URL lain untuk versi produksi Action Anda).

Dapatkan masukan

Setelah Action dirilis ke saluran rilis alfa atau beta, Anda harus mengundang penguji dengan membagikan link keikutsertaan (yang sama dengan listingan direktori Asisten).

Pastikan untuk menunjukkan kepada penguji bahwa mereka harus:

• Minta aplikasi Asisten Google didownload di perangkat seluler mereka untuk melakukan pengujian alfa atau beta.
• Masuk ke aplikasi Asisten Google menggunakan akun yang sama dengan yang Anda tunjuk sebagai penguji alfa atau beta.

Setelah Anda men-deploy Action, penguji baru harus menunggu setidaknya 3 jam sebelum dapat mengakses Action menggunakan link keikutsertaan.

Saat mengklik link ini, pengguna akan diarahkan ke halaman direktori Action yang sesuai. Mereka harus mengklik tombol Saya bersedia di bagian bawah halaman direktori Tindakan untuk memilih sebagai penguji untuk pertama kalinya.

Setelah penguji memilih untuk ikut serta di ponsel mereka, Action Anda akan langsung tersedia di semua perangkat mereka. Penguji akan melihat Action Anda di bagian Aplikasi Saya di aplikasi Asisten Google yang diberi label dengan salah satu mode berikut: Alfa, Beta, atau Tidak ada pengujian. Opsi Tidak ada pengujian akan menayangkan Action versi Produksi kepada pengguna, jika tersedia. Jika tidak ada versi Produksi, pengguna tidak akan melihat apa pun.

Catatan: Pengguna tidak dapat memberi rating Action di aplikasi Asisten Google jika mereka menggunakan versi alfa atau beta. Sebagai gantinya, Anda harus memberikan cara bagi penguji untuk memberikan masukan melalui email, situs, forum pesan, atau mekanisme lain yang sesuai.

Praktik terbaik

• Pastikan pengguna dapat mengikuti pengujian. Penguji harus memiliki Akun Google (@gmail.com) atau akun G Suite untuk bergabung dalam pengujian.
• Pilih jenis pengujian yang sesuai. Grup pengujian alfa harus berukuran kecil dan menguji versi eksperimental Action yang paling tidak stabil (seperti dalam perusahaan atau tim Anda). Gunakan uji beta dengan grup yang lebih besar untuk menguji versi stabil Action yang hampir dirilis.
• Sediakan saluran bagi penguji untuk memberikan masukan kepada Anda. Saluran alfa dan beta hanya tersedia untuk penguji. Pastikan untuk menawarkan kemampuan kepada pengguna dalam memberikan masukan melalui email, situs, forum pesan, atau melalui mekanisme lain yang sesuai.
• Jalankan pengujian serentak pada tindakan yang sama. Anda dapat menjalankan pengujian alfa dan beta secara bersamaan.

Masalah umum

• Direktori Asisten untuk web tidak didukung untuk ikut serta dalam alfa atau beta. Pastikan penguji mengikuti link di perangkat seluler mereka (Android atau iOS).
• Perubahan Anda mungkin memerlukan waktu beberapa jam untuk ditampilkan. Harap tunggu selama jangka waktu yang sesuai sebelum membagikan link keikutsertaan kepada pengguna.

Buat rilis alfa atau beta baru

Untuk men-deploy Action ke saluran rilis alfa atau beta, ikuti langkah-langkah berikut:

1. Dari konsol Actions, klik Deploy > Release.

2. Klik Mulai rilis baru.

   

3. Pilih Alfa atau Beta, lalu klik Kirim.

4. Jika diminta, tunjukkan bahwa Anda telah menyelesaikan langkah yang diperlukan dalam checklist Persyaratan peninjauan tindakan.

5. Jika berlaku untuk project Anda, pilih bahasa untuk rilis.

6. Klik Kirim.

Setelah mengirimkan versi alfa atau beta, versi tersebut akan muncul di bagian Kelola Rilis.

Catatan: Setelah di-deploy, versi Anda akan berada dalam status Men-deploy hingga 3 jam sebelum tersedia untuk pengguna. Setelah deployment selesai, versi live lainnya di lingkungan rilis tersebut akan dihapus.

Catatan: Jika Anda adalah developer project, versi pengujian akan diaktifkan secara default di perangkat. Jika Anda ingin mengakses versi alfa dan beta, nonaktifkan opsi Pengujian di perangkat di simulator Konsol Actions.

Mengupgrade rilis yang sudah ada dari alfa atau beta ke produksi

Rilis produksi dapat berupa peluncuran penuh ke semua pengguna Asisten Google, atau peluncuran bertahap ke wilayah tertentu atau persentase pengguna. Peluncuran bertahap membantu menguji stabilitas project Action Anda. Sebaiknya rilis ke sekelompok kecil pengguna dan buat peningkatan bertahap hingga Anda mencapai 100% pengguna. Tindakan ini memungkinkan Anda mengatasi bug sebelum meluncurkan ke seluruh basis pengguna.

Catatan: Baik dirilis sebagai peluncuran penuh maupun bertahap, Action Anda harus lulus proses peninjauan sebelum di-deploy ke produksi. Hanya satu peninjauan yang diperlukan; namun, jika Action Anda diubah, tindakan tersebut harus ditinjau kembali. Anda harus mengirimkan Action versi baru ke Beta atau Produksi untuk memulai peninjauan.

Peluncuran bertahap

Peluncuran bertahap memungkinkan developer mengelola rilis produksi dengan meluncurkan ke sekelompok pengguna dan secara bertahap meningkatkannya bagi semua pengguna. Anda dapat secara bertahap meningkatkan wilayah atau persentase pengguna dalam peluncuran Anda.

Catatan: Anda tidak dapat memilih persentase pengguna dalam wilayah yang dipilih. Anda tidak dapat beralih antara jenis staging (lokasi atau persentase pengguna) saat mengupgrade rilis yang sedang berjalan. Anda harus membatalkan rilis dan memulai rilis jika ingin mengubah jenis staging. Hanya boleh ada satu versi yang aktif di jalur peluncuran bertahap.

Untuk men-deploy Action sebagai peluncuran bertahap, ikuti langkah-langkah berikut:

1. Di bagian Kelola rilis, pilih versi yang akan diupgrade ke peluncuran produksi.
2. Klik Kelola deployment.
3. Pilih Deploy to Production.
4. Pilih Peluncuran bertahap.
5. Klik Pilih jenis peluncuran.

6. Pilih Lokasi yang ditentukan atau Persentase pengguna. Untuk informasi selengkapnya tentang pilihan ini, lihat Meluncurkan menurut lokasi yang ditentukan atau Meluncurkan berdasarkan persentase basis pengguna.

   

7. Klik Kirim.

Untuk melanjutkan tahap peluncuran, lihat Meningkatkan tahap peluncuran.

Peluncuran penuh

Memilih opsi ini akan merilis project Action Anda ke semua pengguna di semua negara target Anda.

Untuk men-deploy Action sebagai peluncuran penuh, ikuti langkah-langkah berikut:

1. Di bagian Kelola rilis, pilih versi yang akan diupgrade ke peluncuran produksi.

2. Klik Kelola deployment.

   

3. Pilih Deploy to Production.

4. Pilih Peluncuran penuh.

5. Klik Kirim.

Membuat rilis produksi baru tanpa uji alfa atau beta

Rilis produksi dapat berupa peluncuran penuh ke semua pengguna Asisten Google, atau peluncuran bertahap ke wilayah tertentu atau persentase pengguna. Peluncuran bertahap membantu menguji stabilitas project Action Anda. Sebaiknya rilis ke sekelompok kecil pengguna dan buat peningkatan bertahap hingga Anda mencapai 100% pengguna. Tindakan ini memungkinkan Anda mengatasi bug sebelum meluncurkan ke seluruh basis pengguna.

Catatan: Baik dirilis sebagai peluncuran penuh maupun bertahap, Action Anda harus lulus proses peninjauan sebelum di-deploy ke produksi. Hanya satu peninjauan yang diperlukan; namun, jika Anda mengubah Action dan merilisnya ke tahap produksi, tindakan tersebut harus ditinjau lagi. Anda harus mengirimkan Action versi baru ke versi beta atau produksi untuk memulai peninjauan.

Peluncuran bertahap

Peluncuran bertahap memungkinkan developer mengelola rilis produksi dengan meluncurkan ke sekelompok pengguna dan secara bertahap meningkatkannya bagi semua pengguna. Anda dapat secara bertahap meningkatkan wilayah atau persentase pengguna dalam peluncuran Anda.

Catatan: Anda tidak dapat memilih persentase pengguna dalam wilayah yang dipilih. Anda tidak dapat beralih antara jenis staging (lokasi atau persentase pengguna) saat mengupgrade rilis yang sedang berjalan. Anda harus membatalkan rilis dan memulai rilis jika ingin mengubah jenis staging. Hanya boleh ada satu versi yang aktif di jalur peluncuran bertahap.

Untuk men-deploy Action sebagai peluncuran bertahap, ikuti langkah-langkah berikut:

1. Dari konsol Actions, klik Deploy > Release.

2. Klik Mulai rilis baru.

   

3. Pilih Produksi.

4. Jika diminta, tunjukkan bahwa Anda telah menyelesaikan langkah yang diperlukan dalam checklist Persyaratan peninjauan tindakan.

5. Jika berlaku untuk project Anda, pilih bahasa untuk rilis.

6. Pilih Peluncuran bertahap.

7. Klik Pilih jenis peluncuran.

8. Pilih Lokasi yang ditentukan atau Persentase pengguna. Untuk informasi selengkapnya tentang pilihan ini, lihat Meluncurkan menurut lokasi yang ditentukan atau Meluncurkan berdasarkan persentase basis pengguna.

   

9. Klik Kirim.

Luncurkan berdasarkan lokasi yang ditentukan

Memilih opsi ini akan merilis project Action Anda ke negara atau wilayah yang Anda pilih.

Untuk meluncurkan Action menurut lokasi, ikuti langkah-langkah berikut:

1. Klik Pilih negara atau wilayah, lalu centang kotak wilayah yang akan ditargetkan untuk rilis Anda.

2. Klik Kirim.

   Catatan: Hanya wilayah yang Anda pilih di penargetan lokasi yang diizinkan.

Luncurkan berdasarkan persentase basis pengguna

Opsi ini merilis Action Anda ke persentase pengguna yang dipilih secara acak.

Untuk meluncurkan Action ke sebagian pengguna, ikuti langkah-langkah berikut:

1. Klik Persentase pengguna.

2. Pilih persentase pengguna yang ingin diberi tindakan.

   

3. Klik Kirim.

   Catatan: Anda dapat mengembalikan jenis rilis ini dengan menetapkan persentase ke 0%.

Peluncuran penuh

Memilih opsi ini akan merilis project Action Anda ke semua pengguna di semua negara target Anda.

Untuk men-deploy Action sebagai peluncuran penuh, ikuti langkah-langkah berikut:

1. Dari konsol Actions, klik Deploy > Release.

2. Klik Mulai rilis baru.

   

3. Pilih Produksi.

4. Jika diminta, tunjukkan bahwa Anda telah menyelesaikan langkah yang diperlukan dalam checklist Persyaratan peninjauan tindakan.

5. Jika berlaku untuk project Anda, pilih bahasa untuk rilis.

6. Pilih Peluncuran penuh.

7. Klik Kirim.

Setelah dikirim, versi produksi akan muncul di bagian Kelola Rilis.

Catatan: Setelah Anda melakukan deployment, versi tersebut akan berada dalam status Men-deploy hingga 3 jam sebelum tersedia untuk pengguna Anda. Setelah deployment selesai, deployment versi aktif lainnya di lingkungan rilis tersebut akan dibatalkan deploymentnya secara otomatis.

Mengedit atau membatalkan deployment rilis

Setelah mengirimkan Action ke saluran rilis, Anda masih dapat melakukan perubahan. Anda dapat menguji versi saat ini, membatalkan versi dari peninjauan, melihat detail rilis, mengelola deployment, membatalkan deployment, dan mengupgrade tahap peluncuran. Di sini Anda juga dapat melihat detail rilis sebelumnya.

Melihat dan mengedit rilis

Untuk melihat detail rilis, atau membuat perubahan pada rilis Action, ikuti langkah-langkah berikut:

1. Di bagian Kelola Rilis, pilih versi di bagian Nama rilis.
2. Pilih Edit peluncuran, Kelola deployment, atau Lihat selengkapnya.

Meningkatkan tahap peluncuran rilis

Untuk melanjutkan tahap peluncuran Action, ikuti langkah-langkah berikut:

1. Di bagian Kelola rilis, pilih versi yang akan diupgrade.
2. Klik tombol Edit peluncuran.
3. Lakukan perubahan pada peluncuran. Misalnya, Anda mungkin ingin memajukan basis pengguna dari 5% menjadi 20%.
4. Klik Kirim.

Membatalkan deployment dari produksi

• Jika Anda perlu membuat peluncuran bertahap secara offline, klik Edit peluncuran di bagian Kelola rilis. Anda dapat menghapus semua wilayah atau memilih 0%, bergantung pada apakah peluncuran Anda didasarkan pada lokasi atau persentase basis pengguna.
• Untuk membatalkan deployment Action yang diluncurkan sepenuhnya (100% dari basis pengguna), klik tombol Kelola deployment di bagian Kelola rilis, lalu pilih Batalkan deployment dari Produksi.