Versi dan lingkungan

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 Anda 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 melakukan perubahan. Agen draf dapat dengan mudah rusak tanpa disengaja, terutama jika beberapa orang memiliki akses tulis ke agen. Selain itu, agen draf yang baru diedit mungkin tidak konsisten dengan model terlatih, 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 ada masalah yang ditemukan.

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 sehingga mengganggu status sesi. Oleh karena itu, Anda harus berencana 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

1. Buka konsol Dialogflow ES.
2. Pilih agen Anda di dekat bagian atas menu sidebar kiri.
3. Klik tombol setelan di samping nama agen.
4. Klik tab Environments.
5. Klik Publish a version.
6. Tambahkan deskripsi opsional, lalu klik Next.

7. Pilih +New Environment.

   Catatan: Anda dapat membuat versi agen tanpa memublikasikannya dengan memilih Create version without publishing dari menu lingkungan.

8. Masukkan nama lingkungan.

9. Pilih metode fulfillment untuk lingkungan.

10. Pilih setelan Text-to-speech untuk lingkungan.

11. Klik Publish.

12. Informasi lingkungan kini tercantum di bagian Custom environments.

API

1. Panggil metode create untuk jenis Versi guna membuat versi agen baru.
2. Panggil metode create untuk jenis Lingkungan guna membuat lingkungan baru. Berikan versi agen yang baru saja Anda buat ke kolom agentVersion.

Mengembalikan lingkungan ke versi sebelumnya

Anda dapat mengembalikan lingkungan ke versi agen sebelumnya:

Konsol

1. Klik lingkungan di bagian Custom environments.
2. Dialog setelan lingkungan akan terbuka.
3. Klik tombol opsi untuk versi yang sebelumnya dipublikasikan di bagian Publishing History.
4. Klik Revert to this version.
5. 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.

Perhatian: Memuat versi sebelumnya ke draf akan meniadakan semua perubahan terbaru pada draf dan tidak dapat diurungkan. Anda mungkin ingin menyimpan draf ke versi sebelum melakukan langkah-langkah ini.

Untuk memuat versi sebelumnya ke draf:

Konsol

1. Buka konsol Dialogflow ES.
2. Pilih agen Anda di dekat bagian atas menu sidebar kiri.
3. Klik tombol setelan di samping nama agen.
4. Klik tab Environments.
5. Klik View all versions di bagian Draft.
6. Klik tombol opsi untuk versi yang ingin Anda muat ke draf.
7. Klik Load to Draft.
8. Klik Yes, I'm sure.
9. 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 benar (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 salah satu lingkungan kustom. Panggil metode deteksi intent, tetapi ubah URL endpoint dengan menyisipkan environments/environment-name/users/-/ 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 mengetahui 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