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 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

  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 Publikasikan versi.
  6. Tambahkan deskripsi opsional, lalu klik Berikutnya.
  7. Pilih +New Environment.

  8. Masukkan nama lingkungan.

  9. Pilih metode fulfillment untuk lingkungan.

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

  11. Klik Publikasikan.

  12. Informasi lingkungan kini tercantum di bagian Lingkungan kustom.

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 Lingkungan kustom.
  2. Dialog setelan lingkungan akan terbuka.
  3. Klik tombol opsi untuk versi yang dipublikasikan sebelumnya di bagian Histori Publikasi.
  4. Klik Kembalikan ke versi ini.
  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.

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 Lihat semua versi di bagian Draf.
  6. Klik tombol opsi untuk versi yang ingin Anda muat ke draf.
  7. Klik Muat ke Draf.
  8. Klik Ya, saya yakin.
  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 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