Versi dan lingkungan

Anda dapat membuat beberapa versi alur, playbook, dan alat agen, lalu men-deploy-nya ke lingkungan penayangan terpisah.

Saat mengedit alur, playbook, atau alat, Anda mengedit draf. Kapan saja, Anda dapat menyimpan draf sebagai versi. Versi adalah snapshot data alur kerja, playbook, atau alat yang tidak dapat diubah dan data agen terkait. Untuk alur, hal ini mencakup maksud (intent), entity, webhook, halaman, grup rute. Untuk playbook, hal ini hanya mencakup contoh.

Saat Anda menyimpan draf, draf tersebut akan di-deploy ke lingkungan default. Saat membuat versi tertentu, Anda dapat men-deploy-nya ke lingkungan kustom. Anda dapat membuat berbagai lingkungan kustom seperti:

• pengujian
• development
• produksi

Selain itu, Anda dapat membuat webhook khusus lingkungan, sehingga Anda dapat mengisolasi lingkungan produksi dari lingkungan pengembangan dan pengujian.

Praktik terbaik traffic produksi

Selalu gunakan versi untuk traffic produksi

Draf diperbarui setiap kali developer di tim Anda membuat perubahan. Draf dapat rusak secara tidak sengaja, terutama jika beberapa orang memiliki akses tulis ke agen. Selain itu, draf yang baru diedit mungkin tidak konsisten dengan model terlatih, karena pelatihan mungkin tertunda atau memerlukan eksekusi manual.

Anda harus selalu menggunakan versi untuk traffic produksi. Draf resource harus diuji sebelum dipromosikan ke versi produksi, dan Anda dapat melakukan rollback ke versi sebelumnya jika ada masalah yang ditemukan.

Selalu gunakan webhook khusus lingkungan

Saat melakukan pembaruan pada agen, Anda sering kali memiliki pembaruan yang saling bergantung pada kode webhook. Selama pengembangan dan pengujian perubahan ini, Anda menginginkan hal berikut:

• Untuk menguji update agen terhadap update kode webhook.
• Agar tidak men-deploy kode webhook ke produksi sebelum Anda menyelesaikan pengujian.

Menggunakan webhook khusus lingkungan akan mencapai kedua sasaran ini.

Pertimbangkan kemungkinan kesalahan agen saat mengubah versi

Jika Anda mengubah versi 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.

Memuat versi ke draf

Kapan saja, Anda dapat memuat versi ke draf, sehingga dapat diedit dan digunakan oleh lingkungan default.

Memuat versi alur ke draf dapat memperbarui beberapa resource di agen, termasuk resource tingkat agen seperti maksud dan entity. Saat memuat versi ke draf dengan konsol atau API, Anda dapat memilih apakah resource tingkat agen akan diganti atau tidak.

Demikian pula, memulihkan versi playbook ke draf akan menimpa playbook yang ada dalam draf dan contohnya. Selain itu, memulihkan alat akan menimpa alat yang ada di draf.

Mengelola versi

Untuk mengelola versi Anda:

Konsol

Untuk mencantumkan versi saat ini untuk alur:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tab Sumber Daya Bersama.
5. Klik Versi.
6. Alur agen dicantumkan. Pilih satu.
7. Versi dicantumkan untuk alur yang dipilih.

Untuk mencantumkan versi saat ini untuk playbook:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih playbook
5. Klik Histori Versi.
6. Klik Lihat histori versi.
7. Versi tercantum untuk playbook yang dipilih.

Untuk mencantumkan versi saat ini untuk alat:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih alat
5. Klik Histori Versi.
6. Klik Lihat histori versi.
7. Versi tercantum untuk alat yang dipilih.

Informasi berikut ditampilkan untuk setiap resource:

• Nama tampilan: Nama tampilan versi.
• ID Versi: ID untuk versi.
• Jenis NLU: Jenis NLU untuk versi alur.
• Stempel waktu pembuatan: Tanggal dan waktu versi dibuat.
• Status: Status pelatihan. Versi alur belum siap digunakan hingga statusnya ditandai sebagai Siap.

Untuk membuat versi baru, klik tombol Buat, lalu berikan Nama tampilan dan Deskripsi untuk versi tersebut.

Untuk memuat versi alur tertentu sebagai alur draf:

1. Arahkan kursor ke baris versi.
2. Klik tombol .
3. Klik opsi Muat ke draf.
4. Opsi disediakan untuk mengganti data tingkat agen saat memuat.

Untuk menghapus versi alur tertentu:

1. Arahkan kursor ke baris versi.
2. Klik tombol .
3. Klik opsi Hapus versi.

API

Lihat metode untuk jenis Version. Buka referensi Version API

Pilih protokol dan versi untuk Referensi versi:

Protokol	V3	V3beta1
REST	Resource versi	Resource versi
RPC	Antarmuka versi	Antarmuka versi
C++	VersionsClient	Tidak tersedia
C#	VersionsClient	Tidak tersedia
Go	VersionsClient	Tidak tersedia
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	Tidak tersedia	Tidak tersedia
Python	VersionsClient	VersionsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Catatan: Metode load memiliki kolom allowOverrideAgentResources, yang dapat digunakan untuk mengontrol apakah resource tingkat agen ditimpa saat memulihkan alur sebagai alur draf.

Catatan: Saat memanggil metode delete untuk menghapus versi, Anda harus menghapus semua referensi ke versi tersebut dalam data lingkungan terlebih dahulu.

Membandingkan versi alur

Catatan: Bandingkan versi dibatasi oleh ukuran respons 2 MB. Gunakan metode REST API untuk mengatasi batasan ini.

Setelah membuat versi alur, Anda dapat menggunakan alat bandingkan versi untuk melihat perbandingan berdampingan antara versi alur atau versi draf. Fitur ini tidak tersedia untuk playbook. Untuk membandingkan versi:

Konsol

1. Arahkan kursor ke baris versi.
2. Klik tombol .
3. Klik opsi Bandingkan versi.
4. Pilih versi alur atau draf alur lain untuk perbandingan.
5. Perbandingan per aspek ditampilkan.

API

Lihat metode compareVersions untuk jenis Version. Buka referensi Version API

Pilih protokol dan versi untuk Referensi versi:

Protokol	V3	V3beta1
REST	Resource versi	Resource versi
RPC	Antarmuka versi	Antarmuka versi
C++	VersionsClient	Tidak tersedia
C#	VersionsClient	Tidak tersedia
Go	VersionsClient	Tidak tersedia
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	Tidak tersedia	Tidak tersedia
Python	VersionsClient	VersionsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Mengelola lingkungan

Untuk mengelola lingkungan agen Anda:

Konsol

Untuk mencantumkan lingkungan saat ini untuk agen:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tab Sumber Daya Bersama.
5. Klik Environments.
6. Lingkungan agen dicantumkan.

Untuk membuat lingkungan baru, klik tombol Buat dan berikan informasi.

Untuk memilih versi alur, playbook, dan alat serta mengonfigurasi lingkungan, klik lingkungan dan berikan informasi.

Untuk melihat histori pengeditan lingkungan, klik tombol histori di dekat sisi kanan lingkungan dalam daftar.

Untuk menyalin nama resource lingkungan yang menyertakan ID lingkungan, klik tombol salin di dekat sisi kanan lingkungan dalam daftar.

Untuk menghapus lingkungan, klik tombol hapus di dekat sisi kanan lingkungan dalam daftar.

API

Lihat metode untuk jenis Environment. Buka referensi Environment API

Pilih protokol dan versi untuk referensi Lingkungan:

Protokol	V3	V3beta1
REST	Resource lingkungan	Resource lingkungan
RPC	Antarmuka lingkungan	Antarmuka lingkungan
C++	EnvironmentsClient	Tidak tersedia
C#	EnvironmentsClient	Tidak tersedia
Go	EnvironmentsClient	Tidak tersedia
Java	EnvironmentsClient	EnvironmentsClient
Node.js	EnvironmentsClient	EnvironmentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	EnvironmentsClient	EnvironmentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Catatan: Untuk mereferensikan alur draf, gunakan 0 sebagai ID versi alur.

Menentukan lingkungan untuk panggilan sesi

Dengan menggunakan simulator konsol atau API, Anda dapat menentukan lingkungan saat melakukan panggilan sesi runtime. Jika lingkungan tidak ditentukan, lingkungan default akan digunakan.

Konsol

Saat menggunakan simulator konsol, pilih opsi Test agent in environment, lalu pilih lingkungan.

API

Untuk menentukan lingkungan untuk panggilan REST entity sesi, detectIntent, streamingDetectIntent, dan matchIntent; ubah URL dengan menyisipkan environments/environment-id di antara parameter jalur agent dan sessions.

Misalnya, URL berikut menggunakan ID lingkungan 6db409d7-57ac-41d7-83bd-89b8768e2745:

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Menentukan versi alur untuk panggilan sesi

Dengan menggunakan simulator konsol atau API, Anda dapat menentukan serangkaian versi alur saat melakukan panggilan sesi runtime. Versi alur yang dipilih tidak harus dirujuk di lingkungan mana pun.

Konsol

Saat menggunakan simulator konsol, pilih opsi Test agent with specific flow versions, lalu pilih versi alur.

API

Untuk menentukan versi alur untuk panggilan REST entitas sesi, detectIntent, streamingDetectIntent, dan matchIntent; berikan versi alur yang dipilih di kolom query_parameters.flow_versions permintaan.