Flows

Dialog yang kompleks sering kali melibatkan beberapa topik percakapan. Misalnya, agen pengantaran pizza mungkin memiliki pesanan makanan, informasi pelanggan, dan konfirmasi sebagai topik 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. Tiap agen memiliki satu alur yang disebut Default Start Flow. Satu alur ini mungkin sudah cukup untuk agen sederhana. Agen yang lebih rumit mungkin memerlukan alur tambahan, dan anggota tim pengembangan yang berbeda dapat bertanggung jawab untuk membangun dan mempertahankan alur ini. Misalnya, alur agen pengantaran pizza mungkin terlihat seperti berikut:

Alur mulai default

Default Start Flow otomatis dibuat saat Anda melakukan inisialisasi agen. Alur ini dapat berfungsi sebagai satu-satunya alur untuk agen sederhana atau sebagai titik entri awal untuk agen yang lebih kompleks yang menggabungkan beberapa alur.

Catatan: Default Start Flow tidak dapat dihapus.

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

00000000-0000-0000-0000-000000000000

Halaman awal alur

Setiap alur menyertakan halaman Start, yang direpresentasikan sebagai node dalam grafik konsol saat alur dipilih. Halaman ini menjadi halaman aktif setelah aktivasi alur.

Tidak seperti halaman standar, halaman awal tidak memiliki parameter dan pesan respons. Anda tetap dapat mengirim pesan menggunakan salah satu metode 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 flow 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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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 Anda.
3. Temukan agen dalam daftar.
4. Klik tombol tambahkan di bagian Flows.
5. Pilih Create flow.
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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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 Anda.
3. Temukan agen dalam daftar.
4. Klik nama tampilan agen.
5. Klik alur di bagian Flows.
6. Halaman alur diisi di bagian Pages. Untuk mempelajari cara mengedit halaman, lihat Panduan halaman.
7. Klik alur dalam 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 flow, lihat get dan patch/update untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

Protokol	V3	V3beta1
REST	Resource flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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	Resource halaman	Resource 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: Halaman yang membentuk alur.
• Rute: Rute yang tersedia saat halaman awal alur aktif. Rute berbasis intent juga dapat dipicu saat halaman alur lainnya aktif. Untuk mengetahui detailnya, lihat Cakupan pengendali status dan Rute tingkat alur.
• Pengendali peristiwa: Pengendali yang dapat dipanggil saat alur aktif. Untuk mengetahui detailnya, lihat Pengendali peristiwa tingkat alur.

Untuk mempelajari lebih lanjut cara data diterapkan di berbagai tingkat, lihat Tingkat penerapan data.

Setelan alur

Setelan berikut tersedia untuk flow:

• Nama tampilan: Nama alur yang dapat dibaca manusia.
• Deskripsi: Deskripsi alur.
• Setelan ML: Setelan ML alur juga diakses dan dijelaskan dalam Setelan ML agen.
• Deteksi otomatis bahasa: Deteksi otomatis bahasa memungkinkan Anda menentukan bahasa pengguna akhir yang harus dikenali dan direspons secara otomatis oleh Dialogflow CX. Untuk mengetahui detailnya, lihat Agen multibahasa.

• 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 direferensikan oleh alur yang terkunci atau halaman mana pun di bawah alur yang 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 dapat secara opsional mengganti setelan ucapan agen yang sama.

• Setelan adaptasi ucapan: Setelan adaptasi ucapan tingkat alur. Untuk mempelajari lebih lanjut, lihat Adaptasi ucapan manual.

• Parameter input: Parameter dari playbook tugas yang disediakan untuk alur.

• Parameter yang ditampilkan: Parameter yang ditampilkan flow ke playbook tugas.

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 Anda.
3. Temukan agen dalam daftar.
4. Tahan kursor di atas alur di bagian Flows.
5. Klik tombol opsi .
6. Pilih Flow settings.
7. Jelajahi atau edit 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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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 Anda.
3. Temukan agen dalam daftar.
4. Tahan kursor di atas alur di bagian Flows.
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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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 Anda.
3. Temukan agen dalam daftar.
4. Klik Agent Settings.
5. Buka tab ML.
6. Untuk melatih satu alur, klik Train di baris yang sesuai.
7. Untuk melatih beberapa alur, pilih alur tersebut dengan kotak centang, lalu klik Train selected flow NLU model.

API

Lihat metode train untuk jenis Flow. Buka referensi Flow API

Pilih protokol dan versi untuk referensi Flow:

Protokol	V3	V3beta1
REST	Resource flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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 akan mengekspor alur Anda sebagai data mentah untuk diimpor ke agen mana pun. Resource yang direferensikan oleh alur (intent, entity, dan webhook) disertakan dalam ekspor. Pilih format data mentah saat mengikuti langkah-langkah di bawah.

• Ekspor diagram (Pratinjau): Opsi ini mengekspor flow Anda sebagai diagram visual dalam format XML draw.io, yang dapat diimpor ke alat seperti Lucidchart atau diagrams.net. Pilih format data XML saat mengikuti langkah-langkah di bawah.

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

Anda dapat mengekspor alur dengan opsi berikut:

• Sertakan alur yang direferensikan: Mengekspor alur target dan semua alur yang direferensikan secara rekursif tanpa kedalaman maksimum. Semua alur yang diekspor dan transisinya dipertahankan selama impor.

Untuk mengekspor alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Anda.
3. Temukan agen dalam daftar.
4. Tahan kursor di atas alur di bagian Flows.
5. Klik tombol opsi .
6. Pilih Export flow.
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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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

Mengimpor alur dari agen sumber ke agen target juga akan mengimpor resource global yang direferensikan, seperti intent, entity, dan webhook. Jika agen target memiliki resource dengan nama tampilan yang sama, Dialogflow CX akan menampilkan ringkasan dan menawarkan tiga opsi untuk menyelesaikan konflik:

• 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 nama.
• Keep original resources: Resource agen target tidak akan diubah.

Untuk mengimpor alur:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Anda.
3. Temukan agen dalam daftar.
4. Klik tombol tambahkan di bagian Flows.
5. Pilih Import flow.
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 flow	Resource flow
RPC	Antarmuka flow	Antarmuka flow
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