Flows

Dialog kompleks sering kali melibatkan banyak topik percakapan. Misalnya, agen pengiriman pizza dapat 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.

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

Contoh diagram multi-alur.

Alur Dialogflow CX memiliki tujuan yang sama dengan sub-agen untuk agen mega Dialogflow ES. Flow memberikan kontrol percakapan yang lebih baik, dan tidak menimbulkan biaya tambahan.

Alur awal default

Saat Anda membuat agen, Alur Mulai Default akan otomatis dibuat. 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.

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 Start di konsol. Saat alur dipilih di konsol, halaman awal ditampilkan sebagai node pada grafik. Jika flow 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:

Halaman awal referensi 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.

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

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 Flows.
  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.

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

Data aliran

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 Flow.
  6. Halaman alur diisi pada bagian Halaman. Lihat panduan halaman untuk informasi tentang cara mengedit 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.

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
Untuk halaman, lihat metode get dan patch/update untuk jenis Page.

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

Data berikut terkait dengan flow:

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

Setelan alur

Setelan berikut tersedia untuk alur:

  • Display name: Nama yang dapat dibaca manusia untuk alur.
  • Description: Deskripsi untuk alur.
  • Setelan ML Setelan Flow ML juga diakses dan dijelaskan di setelan ML agen.
  • Deteksi otomatis bahasa Deteksi otomatis bahasa memungkinkan Anda menentukan bahasa pengguna akhir mana yang harus otomatis dikenali dan direspons oleh Dialogflow. Lihat dokumentasi deteksi otomatis bahasa untuk mengetahui detailnya.
  • Setelan ucapan lanjutan: Setelan ucapan ini dapat secara opsional 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 level, lihat tingkat aplikasi data.

Untuk mengakses setelan alur:

Konsol

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Arahkan mouse ke alur di bagian Flow.
  5. Klik tombol opsi.
  6. Pilih Setelan alur.
  7. Jelajahi atau edit setelan.
  8. Klik Simpan untuk menyimpan perubahan.

API

Lihat metode get dan patch/update untuk jenis Flow.

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

Menghapus alur

Untuk menghapus alur:

Konsol

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

API

Lihat metode delete untuk jenis Flow.

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

Latih alur

Untuk melatih alur:

Konsol

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Klik Agent Settings.
  5. Buka tab ML.
  6. Untuk melatih satu alur, klik Latih di baris yang sesuai.
  7. Untuk melatih beberapa alur, pilih dengan kotak centang, lalu klik Train selected flow NLU model.

API

Lihat metode train untuk jenis Flow.

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

Mengekspor alur

Anda dapat mengekspor flow dengan dua cara:

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

  • Ekspor diagram (Pratinjau): Ekspor alur Anda sebagai diagram visual. Format ekspor 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 ini, pilih format data XML.

Anda dapat mengekspor flow dengan opsi berikut:

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

Untuk mengekspor alur:

Konsol

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Arahkan mouse ke alur di bagian Flow.
  5. Klik tombol opsi.
  6. Pilih Export flow.
  7. Ikuti petunjuk untuk menyelesaikannya.

API

Lihat metode export untuk jenis Flow.

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

Mengimpor flow

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

  • Mengganti resource yang ada: Resource agen sumber akan menimpa resource agen target.
  • Impor sebagai resource baru: Resource agen sumber akan ditambahkan dengan akhiran khusus pada namanya.
  • Pertahankan 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 Flows.
  5. Pilih Alur impor.
  6. Ikuti petunjuk untuk menyelesaikannya.

API

Lihat metode import untuk jenis Flow.

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