Versi dan lingkungan

Anda dapat membuat beberapa versi alur agen dan playbook (juga dikenal sebagai agen Vertex AI) dan men-deploy-nya ke lingkungan penayangan terpisah.

Saat mengedit alur atau playbook, Anda mengedit draf. Anda dapat menyimpan draf sebagai versi kapan saja. Versi adalah ringkasan data alur atau playbook yang tidak dapat diubah 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-deploynya 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 yang dilatih, 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 ada masalah yang ditemukan.

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.

Pertimbangkan 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 dengan cara yang mengganggu status sesi. Oleh karena itu, Anda harus merencanakan untuk mengubah versi selama waktu nonaktif atau di luar jam sibuk.

Memuat versi ke draf

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

Memuat versi alur ke draf dapat memperbarui beberapa resource di agen, termasuk resource tingkat agen seperti intent dan entity. Saat memuat versi untuk dibuat drafnya 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.

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 Shared Resources.
5. Klik Versi.
6. Alur agen dicantumkan. Pilih salah 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 Version History.
6. Klik Lihat histori versi.
7. Versi tercantum untuk playbook yang dipilih.

Informasi berikut ditampilkan untuk setiap resource:

• Nama tampilan: Nama tampilan versi.
• ID Versi: ID untuk versi.
• NLU Type: NLU type 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 dan 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 opsi.
3. Klik opsi Muat ke draf.
4. Opsi disediakan untuk menimpa data tingkat agen saat memuat.

Untuk menghapus versi alur 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 tingkat agen ditimpa saat memulihkan alur 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 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 opsi.
3. Klik opsi Bandingkan versi.
4. Pilih versi alur atau alur draf lain untuk dibandingkan.
5. Perbandingan berdampingan akan 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 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 Lingkungan.
6. Lingkungan agen dicantumkan.

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

Untuk memilih versi alur dan playbook 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	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 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 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 perlu direferensikan 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 detectIntent, streamingDetectIntent, matchIntent, dan entitas sesi; berikan versi alur yang dipilih di kolom query_parameters.flow_versions permintaan.