Flows

Dialog kompleks sering kali melibatkan beberapa topik percakapan. Misalnya, agen pengiriman pizza mungkin memiliki pesanan makanan, informasi pelanggan, dan konfirmasi sebagai topik yang berbeda. Setiap topik memerlukan beberapa giliran percakapan agar agen dapat memperoleh informasi yang relevan dari pengguna akhir.

Alur digunakan untuk menentukan topik ini dan jalur percakapan terkait. Setiap agen memiliki satu alur yang disebut Alur Awal Default. Anda mungkin hanya memerlukan satu alur ini untuk agen sederhana. Agen yang lebih rumit mungkin memerlukan alur tambahan, dan anggota tim pengembangan yang berbeda dapat bertanggung jawab untuk membuat dan mempertahankan alur ini. Misalnya, alur agen pengiriman pizza mungkin terlihat seperti berikut:

Alur awal default

Saat Anda membuat agen, Alur Mulai Default akan dibuat secara otomatis. Untuk agen sederhana, Anda dapat menggunakan alur ini sebagai satu-satunya alur. Untuk agen yang lebih kompleks, Anda dapat menambahkan lebih banyak alur, dan alur awal default dapat digunakan sebagai titik entri sederhana ke percakapan.

Catatan: Alur Mulai Default tidak dapat dihapus.

Saat menggunakan API, Anda dapat mereferensikan alur awal default dengan ID alur berikut:

00000000-0000-0000-0000-000000000000

Halaman awal alur

Setiap alur memiliki halaman khusus bernama Mulai di konsol. Saat alur dipilih di konsol, halaman awal akan ditampilkan sebagai node pada grafik. Saat alur awalnya menjadi aktif, halaman ini menjadi halaman aktif saat ini.

Halaman awal tidak memiliki parameter atau pesan respons seperti halaman normal. Namun, Anda dapat mengirim pesan menggunakan salah satu pendekatan berikut:

• Penyebaran intent
• Gunakan kondisi true sederhana dalam rute yang memiliki respons fulfillment atau target transisi ke halaman normal dengan fulfillment entri.
• Peristiwa kustom

Mereferensikan halaman awal dalam permintaan API

Untuk mereferensikan halaman awal alur dalam permintaan API runtime, gunakan START_PAGE sebagai ID halaman.

Untuk membuat perubahan waktu desain pada halaman awal melalui API, gunakan metode API get dan patch/update untuk jenis Flow.

Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Membuat alur

Untuk membuat alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tombol tambahkan di bagian Alur.
5. Pilih Buat alur.
6. Masukkan nama tampilan untuk alur Anda.
7. Klik alur yang baru saja Anda buat.

API

Lihat metode create untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Data alur

Untuk mengakses data alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud untuk agen.
3. Temukan agen dalam daftar.
4. Klik nama tampilan agen.
5. Klik alur di bagian Alur.
6. Halaman alur diisi di bagian Halaman. Lihat panduan halaman untuk mengetahui informasi tentang cara mengedit halaman.
7. Klik alur di grafik.
8. Panel edit alur akan muncul. Gunakan panel ini untuk menjelajahi dan mengedit data alur tambahan.
9. Klik Simpan untuk menyimpan perubahan.

API

Untuk alur, lihat get dan patch/update untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Untuk halaman, lihat metode get dan patch/update untuk jenis Page. Buka referensi Page API

Pilih protokol dan versi untuk Referensi halaman:

Protokol	V3	V3beta1
REST	Referensi halaman	Referensi halaman
RPC	Antarmuka halaman	Antarmuka halaman
C++	PagesClient	Tidak tersedia
C#	PagesClient	Tidak tersedia
Go	PagesClient	Tidak tersedia
Java	PagesClient	PagesClient
Node.js	PagesClient	PagesClient
PHP	Tidak tersedia	Tidak tersedia
Python	PagesClient	PagesClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Data berikut dikaitkan dengan alur:

• Halaman: Daftar halaman yang membentuk alur.
• Rute: Semua rute ini dapat dipanggil saat halaman awal untuk alur aktif. Rute dengan persyaratan intent dapat diikuti saat halaman lain dalam alur aktif. Untuk mengetahui detailnya, lihat Cakupan pengendali status dan Rute tingkat alur.
• Pengendali peristiwa: Pengendali ini dapat dipanggil saat alur aktif. Untuk mengetahui detailnya, lihat Pemroses peristiwa tingkat alur

Untuk mengetahui informasi selengkapnya tentang cara data diterapkan di berbagai tingkat, lihat tingkat penerapan data.

Setelan alur

Setelan berikut tersedia untuk alur:

• Nama tampilan: Nama yang dapat dibaca manusia untuk alur.
• Deskripsi: Deskripsi untuk alur.
• Setelan ML Setelan ML alur juga diakses dan dijelaskan di setelan ML agen.
• Deteksi bahasa otomatis Deteksi bahasa otomatis memungkinkan Anda menentukan bahasa pengguna akhir yang harus otomatis dikenali dan direspons oleh Agen Percakapan (Dialogflow CX). Lihat dokumentasi deteksi otomatis bahasa untuk mengetahui detailnya.

• Kunci alur: Alur yang terkunci tidak dapat diedit, termasuk perubahan berikut pada resource turunannya:

  1. Halaman tidak dapat dibuat, diedit, atau dihapus.
  2. Versi tidak dapat dibuat, diedit, atau dihapus.
  3. Grup rute tingkat alur tidak dapat dibuat, diedit, atau dihapus.
  4. Grup rute tingkat agen yang dirujuk oleh alur terkunci atau halaman apa pun dalam alur terkunci tidak dapat dihapus, tetapi masih dapat diedit.
  Catatan: Setelan ini tidak dapat diubah jika kunci diaktifkan di tingkat agen.

• Setelan ucapan lanjutan: Setelan ucapan lanjutan ini secara opsional dapat mengganti setelan ucapan agen yang sama.

• Setelan adaptasi ucapan: Setelan adaptasi ucapan tingkat alur dengan petunjuk yang lebih mendetail di adaptasi ucapan manual.

Untuk mengetahui informasi selengkapnya tentang cara data diterapkan di berbagai tingkat, lihat tingkat penerapan data.

Untuk mengakses setelan alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Arahkan kursor mouse ke alur di bagian Alur.
5. Klik tombol opsi.
6. Pilih Setelan alur.
7. Menjelajahi atau mengedit setelan.
8. Klik Simpan untuk menyimpan perubahan.

API

Lihat metode get dan patch/update untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Menghapus alur

Untuk menghapus alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Arahkan kursor mouse ke alur di bagian Alur.
5. Klik tombol setelan.
6. Pilih Hapus.

API

Lihat metode delete untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Melatih alur

Untuk melatih alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik Setelan Agen.
5. Buka tab ML.
6. Untuk melatih satu alur, klik Latih di baris yang sesuai.
7. Untuk melatih beberapa alur, pilih alur dengan kotak centang, lalu klik Latih model NLU alur yang dipilih.

API

Lihat metode train untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Mengekspor alur

Anda dapat mengekspor alur dengan dua cara:

• Ekspor data: Tindakan ini mengekspor alur Anda sebagai data mentah, sehingga dapat diimpor ke agen mana pun. Saat Anda mengekspor alur, resource yang dirujuk oleh alur (intent, entity, webhook) juga diekspor. Saat mengikuti langkah-langkah di bawah, pilih format data data mentah.

• Ekspor diagram (Pratinjau): Opsi ini mengekspor alur Anda sebagai diagram visual. Format ekspornya adalah XML draw.io, sehingga Anda dapat mengimpor diagram di Lucidchart, diagrams.net, atau alat diagram lainnya yang dapat mengimpor format draw.io. Saat mengikuti langkah-langkah di bawah, pilih format data XML.

  Catatan: Ekspor diagram tidak tersedia untuk agen yang menggunakan CMEK.

Anda dapat mengekspor alur dengan opsi berikut:

• Sertakan alur yang dirujuk: Ekspor alur target dan semua tingkat alur yang dirujuk. Alur yang dirujuk mencakup alur yang dirujuk oleh alur target, selain alur yang dirujuk oleh alur yang dirujuk berikutnya, tanpa kedalaman maksimum. Selama impor, semua alur yang diekspor akan diimpor dan transisi antara alur ini akan dipertahankan.

Untuk mengekspor flow:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Arahkan kursor mouse ke alur di bagian Alur.
5. Klik tombol opsi.
6. Pilih Ekspor alur.
7. Ikuti petunjuk untuk menyelesaikan.

API

Lihat metode export untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup

Mengimpor alur

Saat Anda mengimpor alur dari agen sumber ke agen target, resource global yang dirujuk oleh alur (intent, entity, webhook) akan diimpor bersama dengan data khusus alur. Jika agen target memiliki resource global dengan nama tampilan yang sama yang ditemukan di agen sumber, Agen Percakapan (Dialogflow CX) akan memberikan ringkasan resource ini, beserta tiga opsi untuk menyelesaikan konflik untuk resource ini:

• Ganti resource yang ada: Resource agen sumber akan menimpa resource agen target.
• Impor sebagai resource baru: Resource agen sumber akan ditambahkan dengan akhiran yang berbeda dalam namanya.
• Mempertahankan resource asli: Resource agen target tidak akan berubah.

Untuk mengimpor flow:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik tombol tambahkan di bagian Alur.
5. Pilih Impor alur.
6. Ikuti petunjuk untuk menyelesaikan.

API

Lihat metode import untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

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

Tutup