Versi dan lingkungan

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

Saat mengedit alur, playbook, atau alat, Anda mengedit draf. Kapan saja, Anda dapat menyimpan draf sebagai versi. Versi adalah snapshot yang tidak dapat diubah dari data flow, playbook, atau alat Anda dan data agen terkait. Untuk alur, ini mencakup intent, entity, webhook, halaman, grup rute. Untuk playbook, 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 melakukan 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 mengalami penundaan atau memerlukan eksekusi manual.

Anda harus selalu menggunakan versi untuk traffic produksi. Resource draf harus diuji sebelum dipromosikan ke versi produksi, dan Anda dapat melakukan rollback ke versi sebelumnya jika ditemukan masalah.

Selalu gunakan webhook khusus lingkungan

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

• Untuk menguji update agen terhadap update 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 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 merencanakan untuk mengubah versi selama periode 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 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.

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

Mengelola versi

Untuk mengelola versi Anda:

Konsol

Untuk mencantumkan versi saat ini untuk flow:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tab Shared Resources.
5. Klik Versions.
6. Alur agen dicantumkan. Pilih satu.
7. Versi tercantum 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:

• Display name: Nama tampilan versi.
• ID Versi: ID untuk versi.
• NLU Type: Jenis NLU untuk versi flow.
• Stempel waktu pembuatan: Tanggal dan waktu pembuatan versi.
• Status: Status pelatihan. Versi flow belum siap digunakan hingga statusnya ditandai sebagai Ready.

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

Untuk memuat versi flow tertentu sebagai flow draf:

1. Arahkan kursor ke baris versi.
2. Klik tombol opsi .
3. Klik opsi Load to draft.
4. Tersedia opsi untuk menimpa data tingkat agen saat memuat.

Untuk menghapus versi flow tertentu:

1. Arahkan 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 level agen ditimpa saat memulihkan flow sebagai flow 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 flow, Anda dapat menggunakan alat bandingkan versi untuk melihat perbandingan berdampingan antara versi flow atau versi draf. Fitur ini tidak tersedia untuk playbook. Untuk membandingkan versi:

Konsol

1. Arahkan kursor ke baris versi.
2. Klik tombol opsi .
3. Klik opsi Bandingkan versi.
4. Pilih versi alur atau draf alur lain untuk dibandingkan.
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 Shared Resources.
5. Klik Environments.
6. Lingkungan agen akan dicantumkan.

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

Untuk memilih versi flow, 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 draf alur, 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 bagi panggilan REST entity sesi, detectIntent, streamingDetectIntent, 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 flow 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 flow untuk panggilan REST detectIntent, streamingDetectIntent, matchIntent, dan entity sesi; berikan versi flow yang dipilih di kolom query_parameters.flow_versions permintaan.