Versi dan lingkungan

Anda dapat membuat beberapa versi alur agen dan men-deploy-nya ke lingkungan penayangan yang terpisah.

Saat mengedit alur, Anda mengedit alur draf. Anda dapat menyimpan alur draf kapan saja sebagai versi flow. Versi flow adalah snapshot yang tidak dapat diubah dari data flow dan data agen terkait seperti intent, entity, webhook, halaman, grup rute, dll.

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

• pengujian
• development
• produksi
• dll.

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 alur untuk traffic produksi

Alur draf diperbarui setiap kali developer di tim Anda membuat perubahan. Alur draf dapat terputus secara tidak sengaja, terutama jika beberapa orang memiliki akses tulis ke agen. Selain itu, alur 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 flow untuk traffic produksi. Alur draf harus diuji sebelum mempromosikannya 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 memiliki pembaruan yang saling bergantung pada kode webhook. Selama pengembangan dan pengujian perubahan ini, Anda menginginkan hal berikut:

• Untuk menguji update agen terhadap pembaruan kode webhook.
• Untuk menghindari deployment kode webhook ke produksi hingga Anda menyelesaikan pengujian.

Menggunakan Webhook khusus lingkungan akan mencapai kedua sasaran ini.

Mempertimbangkan kemungkinan error agen saat mengubah versi

Jika Anda mengubah versi alur 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 perlu mengubah versi selama periode nonaktif atau di luar jam sibuk.

Memuat versi alur ke draf

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

Memuat versi alur ke draf dapat memperbarui beberapa resource dalam agen, termasuk resource tingkat agen seperti intent dan entity. Saat memuat versi ke draf dengan konsol atau API, Anda dapat memilih apakah resource tingkat agen akan ditimpa.

Mengelola versi alur

Untuk mengelola versi alur:

Konsol

Untuk menampilkan daftar versi terbaru flow:

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tab Manage.
5. Klik Versions.
6. Alur agen dicantumkan. Pilih salah satu.
7. Versi dicantumkan untuk alur yang dipilih.

Informasi berikut ditampilkan untuk setiap alur:

• 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 Ready.

Untuk membuat versi alur baru, klik tombol Create, lalu berikan Display name dan Description untuk versi tersebut.

Untuk memuat versi alur tertentu sebagai alur draf:

1. Tahan kursor ke baris versi.
2. Klik tombol opsi .
3. Klik opsi Muat ke draf.
4. Opsi diberikan untuk menimpa data tingkat agen saat memuat.

Untuk menghapus versi alur tertentu:

1. Tahan kursor ke baris versi.
2. Klik tombol opsi .
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 flow sebagai alur draf.

Catatan: Saat memanggil metode delete untuk menghapus versi, Anda harus menghapus semua referensi ke versi 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 secara berdampingan antara versi alur atau versi draf. Untuk membandingkan versi:

Konsol

1. Tahan kursor ke baris versi.
2. Klik tombol opsi .
3. Klik opsi Bandingkan versi.
4. Pilih versi alur atau alur draf lain sebagai perbandingan.
5. Perbandingan secara berdampingan 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:

Konsol

Untuk menampilkan daftar lingkungan saat ini untuk agen:

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tab Manage.
5. Klik Lingkungan.
6. Lingkungan agen dicantumkan.

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

Untuk memilih versi alur dan 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	Referensi lingkungan	Referensi 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 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 entitas sesi detectIntent, streamingDetectIntent, matchIntent, dan sesi; ubah URL dengan memasukkan 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 simulator konsol atau API, Anda dapat menentukan kumpulan versi flow saat melakukan panggilan sesi runtime. Versi alur yang dipilih tidak perlu direferensikan di lingkungan apa pun.

Konsol

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

API

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