Anda dapat membuat beberapa versi agen dan memublikasikannya ke lingkungan terpisah.
Saat mengedit agen, Anda mengedit agen draf. Kapan saja, Anda dapat menyimpan agen draf sebagai versi agen, yang merupakan snapshot agen yang tidak dapat diubah.
Saat Anda menyimpan agen draf, agen tersebut 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 membuat perubahan. Agen draf mudah rusak secara tidak sengaja, terutama jika beberapa orang 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 dipromosikan ke versi produksi, dan Anda dapat melakukan rollback ke versi sebelumnya jika ditemukan masalah.
Pertimbangkan 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 dengan cara yang mengganggu status sesi. Oleh karena itu, Anda harus merencanakan untuk mengubah versi selama waktu nonaktif atau di luar jam sibuk.
Memublikasikan versi di lingkungan baru
Untuk memublikasikan draf agen ke versi dan membuat lingkungan kustom:
Konsol
- Buka konsol Dialogflow ES.
- Pilih agen Anda 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 +New Environment.
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 Jenis lingkungan guna membuat lingkungan baru. Berikan 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 Publishing History.
- Klik Kembalikan ke versi ini.
- Histori publikasi akan diperbarui.
API
Panggil metode patch
/update
untuk
Jenis lingkungan
guna memperbarui lingkungan.
Berikan versi agen yang sebelumnya Anda buat ke kolom agentVersion
.
Memuat versi sebelumnya ke draf
Memuat versi sebelumnya ke draf akan menimpa agen draf di lingkungan default dengan versi agen yang dipilih.
Untuk memuat versi sebelumnya ke draf:
Konsol
- Buka konsol Dialogflow ES.
- Pilih agen Anda 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 Muat ke Draf.
- Klik Ya, saya yakin.
- Muat ulang tab browser konsol yang terbuka, sehingga tab tersebut diperbarui dengan data agen terbaru.
API
Panggil metode patch
/update
untuk
Jenis lingkungan
dengan input berikut:
- Gunakan
-
sebagai ID lingkungan untuk menentukan lingkungan default. - Tetapkan
allowLoadToDraftAndDiscardChanges
ke true. - Untuk kolom
agentVersion
, berikan versi agen yang akan menimpa agen draf.
Mengekspor versi
Untuk mengekspor versi, Anda harus memuatnya ke draf terlebih dahulu, lalu mengekspor agen.
Menguji agen di lingkungan
Anda dapat menggunakan API untuk menguji agen di lingkungan kustom mana pun.
Panggil metode detect intent, tetapi ubah URL endpoint dengan menyisipkan environments/environment-name/users/-/
di antara agent
dan sessions
.
Misalnya, endpoint berikut menggunakan lingkungan "development" dengan pengguna yang tidak ditentukan:
"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"
Setelan khusus 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 penerapan 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 mega-agen.
Batasan
Batasan berikut berlaku:
- Jumlah maksimum lingkungan per agen: 10
- Jumlah maksimum versi per agen: 1.000