Versi dan lingkungan

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

  1. Buka Dialogflow ES Console.
  2. Pilih agen 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 +Lingkungan Baru.

  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 Environment type guna membuat lingkungan baru. Masukkan 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 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

  1. Buka Dialogflow ES Console.
  2. Pilih agen 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 Load to Draft.
  8. Klik Ya, saya yakin.
  9. 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