Anda dapat membuat beberapa versi agen dan memublikasikannya ke lingkungan terpisah.
Saat mengedit agen, Anda mengedit agen draf. Anda dapat menyimpan draf agen kapan saja sebagai versi agen, yang merupakan snapshot yang tidak dapat diubah dari agen Anda.
Setelah disimpan, agen draf akan dipublikasikan ke lingkungan default. Saat membuat versi agen, Anda dapat memublikasikannya ke lingkungan kustom. Anda dapat membuat berbagai lingkungan kustom untuk:
- pengujian
- development
- produksi
- dll.
Traffic produksi
Selalu gunakan versi agen untuk traffic produksi
Agen draf diperbarui setiap kali developer di tim Anda melakukan perubahan. Agen draf dapat dengan mudah merusak agen secara tidak sengaja, terutama jika ada beberapa orang yang memiliki akses tulis ke agen. Selain itu, agen draf yang baru saja diedit mungkin tidak konsisten dengan model yang dilatih, karena pelatihan mungkin mengalami penundaan atau memerlukan eksekusi manual.
Anda harus selalu menggunakan versi agen untuk traffic produksi. Agen draf harus diuji sebelum mempromosikannya ke versi produksi, dan Anda dapat melakukan rollback ke versi sebelumnya jika ada masalah.
Mempertimbangkan kemungkinan error agen saat mengubah versi
Jika Anda mengubah versi agen di lingkungan produksi saat sesi aktif, hal ini dapat menyebabkan error agen untuk beberapa sesi aktif. Error ini dapat terjadi jika versi sebelumnya dan versi baru tidak konsisten satu sama lain sehingga mengganggu status sesi. Oleh karena itu, Anda harus mengubah versi selama periode nonaktif atau di luar jam sibuk.
Memublikasikan versi di lingkungan baru
Untuk memublikasikan draf agen ke suatu versi dan membuat lingkungan kustom:
Konsol
- Buka Dialogflow ES Console.
- Pilih agen di dekat bagian atas menu sidebar kiri.
- Klik tombol setelan settings di samping nama agen.
- Klik tab Environments.
- Klik Publikasikan versi.
- Tambahkan deskripsi opsional, lalu klik Berikutnya.
Pilih +Lingkungan Baru.
Masukkan nama lingkungan.
Pilih metode fulfillment untuk lingkungan.
Pilih Setelan text-to-speech untuk lingkungan.
Klik Publikasikan.
Informasi lingkungan kini tercantum di bagian Lingkungan kustom.
API
- Panggil metode
create
untuk Jenis versi guna membuat versi agen baru. - Panggil metode
create
untuk Environment type guna membuat lingkungan baru. Masukkan versi agen yang baru saja Anda buat ke kolomagentVersion
.
Mengembalikan lingkungan ke versi sebelumnya
Anda dapat mengembalikan lingkungan ke versi agen sebelumnya:
Konsol
- Klik lingkungan di bagian Lingkungan kustom.
- Dialog setelan lingkungan akan terbuka.
- Klik tombol opsi more_vert untuk versi yang dipublikasikan sebelumnya di bagian Histori Publikasi.
- Klik Kembalikan ke versi ini.
- Histori publikasi akan diperbarui.
API
Panggil metode patch
/update
untuk Environment type guna memperbarui lingkungan.
Masukkan versi agen yang sebelumnya Anda buat ke kolom agentVersion
.
Memuat versi sebelumnya ke draf
Pemuatan versi sebelumnya ke draf akan menimpa agen draf di lingkungan default dengan versi agen yang dipilih.
Untuk memuat versi sebelumnya ke draf:
Konsol
- Buka Dialogflow ES Console.
- Pilih agen di dekat bagian atas menu sidebar kiri.
- Klik tombol setelan settings di samping nama agen.
- Klik tab Environments.
- Klik Lihat semua versi di bagian Draf.
- Klik tombol opsi more_vert untuk versi yang ingin Anda muat ke draf.
- Klik Load to Draft.
- Klik Ya, saya yakin.
- Muat ulang tab browser konsol yang terbuka, agar tab tersebut dimuat ulang dengan data agen terbaru.
API
Panggil metode patch
/update
untuk
Environment type
dengan input berikut:
- Gunakan
-
sebagai ID lingkungan untuk menentukan lingkungan default. - Tetapkan
allowLoadToDraftAndDiscardChanges
ke true. - Untuk kolom
agentVersion
, berikan versi agen yang akan menimpa draf agen.
Mengekspor versi
Untuk mengekspor versi, Anda harus memuatnya ke draf terlebih dahulu, lalu mengekspor agen.
Menguji agen Anda di lingkungan
Anda dapat menggunakan API untuk menguji agen di setiap lingkungan kustom.
Panggil metode
detect intent, tetapi ubah URL endpoint dengan memasukkan
environments/environment-name/users/-/
di antara agent
dan sessions
.
Misalnya, endpoint berikut menggunakan lingkungan "pengembangan" dengan pengguna yang tidak ditentukan:
"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"
Setelan spesifik per lingkungan
Fulfillment dan text-to-speech dikonfigurasi oleh lingkungan, sehingga agen akan menggunakan setelan lingkungan untuk fitur ini.
Untuk informasi selengkapnya tentang cara data diterapkan di berbagai tingkat, lihat tingkat aplikasi agen.
Asisten Google
Jika Anda menggunakan lingkungan rilis Actions on Google, lihat batasan pembuatan versi untuk library fulfillment Dialogflow.
Mega-agen
Lihat cara kerja versi dan lingkungan di agen besar.
Batasan
Batasan berikut berlaku:
- Jumlah maksimum lingkungan per agen: 10
- Jumlah maksimum versi per agen: 1.000