Halaman

Percakapan (sesi) Dialogflow CX dapat dideskripsikan dan divisualisasikan sebagai mesin status. Status sesi diwakili oleh halaman.

Untuk setiap alur, Anda menentukan banyak halaman, tempat halaman gabungan Anda dapat menangani percakapan lengkap tentang topik yang dirancang untuk alur tersebut. Pada saat tertentu, tepat satu halaman adalah halaman saat ini, halaman saat ini dianggap aktif, dan alur yang terkait dengan halaman tersebut dianggap aktif. Setiap alur memiliki halaman awal khusus. Saat alur awalnya menjadi aktif, halaman awal menjadi halaman saat ini. Untuk setiap giliran percakapan, halaman saat ini akan tetap sama atau bertransisi ke halaman lain.

Anda mengonfigurasi setiap halaman untuk mengumpulkan informasi dari pengguna akhir yang relevan untuk status percakapan yang diwakili oleh halaman tersebut. Misalnya, Anda dapat membuat halaman (berwarna biru) dalam diagram di bawah untuk alur Pesan Makanan dari agen pengiriman pizza. Node Start pada diagram mewakili halaman awal alur Food Order. Setelah alur selesai, alur akan beralih ke alur Konfirmasi.

Siklus proses halaman

Setelah halaman menjadi aktif, agen akan mengikuti beberapa langkah yang mungkin melibatkan pemenuhan entri, pengisian otomatis formulir, evaluasi pengendali status, permintaan parameter formulir, pengiriman pesan respons kepada pengguna akhir, dan perubahan halaman atau loop berulang:

Detail proses ini adalah sebagai berikut:

1. Jika ada pengisian entri untuk halaman, entri tersebut akan dipanggil. Respons statis apa pun yang diberikan oleh pemenuhan ditambahkan ke antrean respons.

   Jika respons parsial diaktifkan, Dialogflow CX akan menghapus antrean respons dan mengirim semua pesan yang diantrekan sebagai respons parsial ke pemanggil streaming API.

   Jika fulfillment memiliki webhook, webhook akan dipanggil, yang dapat menambahkan respons tambahan ke antrean. Respons tambahan ini tidak memicu penghapusan langsung antrean respons.

2. Jika halaman memiliki parameter formulir, parameter tersebut dapat diisi otomatis:

   • Setiap parameter sesi dengan nama yang sama dengan parameter formulir disalin ke parameter formulir.
   • Jika rute memicu transisi ke halaman ini, dan rute berisi intent yang cocok, parameter intent dengan nama yang sama dengan parameter formulir akan disalin ke parameter formulir.

3. Jika ada pengendali status yang dalam cakupan, pengendali tersebut dievaluasi sesuai dengan aturan urutan evaluasi pengendali. Hal ini dapat melibatkan rute, pengendali peristiwa, atau pengendali permintaan ulang yang dipanggil dari iterasi loop sebelumnya. Jika ada pengendali status yang dipanggil, salah satu atau kedua hal berikut dapat terjadi:

   • Jika pemenuhan ada untuk handler, pemenuhan akan dipanggil. Respons statis apa pun yang diberikan oleh pemenuhan ditambahkan ke antrean respons. Respons parsial dan webhook juga dieksekusi jika diaktifkan.
   • Jika alur atau halaman target ada untuk handler, sesi akan bertransisi ke target dan halaman menjadi tidak aktif.

4. Jika semua hal berikut benar, prompt parameter formulir ditambahkan ke antrean respons:

   • Halaman memiliki formulir.
   • Masih ada parameter formulir wajib yang harus diisi.
   • Pengendali permintaan ulang tidak diikuti pada langkah 3.
   • Respons parsial dan webhook akan dieksekusi jika diaktifkan.

5. Pesan antrean respons yang tersisa dikirim ke pengguna akhir, dan agen menunggu input pengguna akhir.

6. Jika input pengguna akhir memberikan parameter formulir yang diminta, isi parameter. Lanjutkan ke langkah 3.

Navigasi siklus proses halaman

Penampil langkah eksekusi simulator memungkinkan Anda beralih di antara langkah-langkah untuk giliran percakapan tertentu dan memfokuskan elemen pembuat agen terkait untuk setiap langkah. Dalam contoh berikut, input pengguna akhir "Saya ingin menyewa mobil" memicu lima langkah eksekusi dan transisi:

1. Penampil langkah eksekusi akan mengarahkan Anda ke halaman memulai percakapan untuk langkah pertama. Dalam hal ini, halaman awalnya adalah halaman awal default.

2. Rute transisi untuk intent car_rental.reservation_create dipicu. Penampil langkah eksekusi memfokuskan rute ini, tempat Anda dapat melihat bahwa target transisi adalah halaman Pickup Location.

3. Agen membuka halaman Pickup Location.

4. Agen mengevaluasi pemenuhan entri halaman Pickup Location. Pengiriman kosong, jadi tidak ada yang terjadi.

5. Agen mencoba mengumpulkan parameter formulir pickup_location yang diperlukan dan pesan pemenuhan perintah awal untuk parameter ini ditampilkan kepada pengguna akhir.

Anda juga dapat mengurungkan ucapan terakhir dan mencoba ucapan lain untuk menguji transisi halaman yang berbeda.

Buat laman

Catatan: Halaman tidak akan muncul di grafik konsol hingga transisi dibuat dengan target yang ditetapkan ke halaman.

Untuk membuat halaman:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih alur untuk halaman di bagian Alur.
5. Klik tombol tambahkan di bagian Halaman.
6. Masukkan nama tampilan untuk halaman Anda.
7. Klik tombol setelan di samping nama tampilan halaman.
8. Pilih Edit.
9. Masukkan kolom di panel edit halaman yang muncul.
10. Klik Simpan.

API

Lihat metode create 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 halaman

Untuk mengakses data halaman:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih Google Cloud project untuk agen.
3. Pilih agen Anda.
4. Klik alur di bagian Alur.
5. Halaman alur diisi di bagian Halaman.
6. Klik tombol setelan di samping nama tampilan halaman.
7. Pilih Edit.
8. Masukkan kolom di panel edit halaman yang muncul.
9. Klik Simpan untuk menyimpan perubahan.

API

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 halaman:

• Nama tampilan: Nama yang dapat dibaca manusia untuk halaman Anda.
• Pemenuhan entri (juga dikenal sebagai Dialog entri): Ini adalah pemenuhan yang akan dipanggil saat halaman pertama kali aktif.
• Parameter: Ini adalah nilai parameter dalam formulir halaman yang merekam input terstruktur dari pengguna akhir.
• Rute: Pengendali status ini dapat dipanggil saat halaman aktif. Untuk mengetahui detailnya, lihat Rute handler tingkat halaman
• Grup rute: Rute dalam grup ini dapat dipanggil saat halaman aktif. Untuk mengetahui detailnya, lihat Grup rute
• Pengendali peristiwa: Pengendali peristiwa ini dapat dipanggil saat halaman aktif. Untuk mengetahui detailnya, lihat Handler peristiwa tingkat halaman

Setelan halaman

Setelan berikut tersedia untuk halaman:

• Setelan ucapan lanjutan: Setelan ucapan lanjutan ini dapat menggantikan setelan ucapan alur dan setelan ucapan agen yang sama secara opsional.

• Setelan adaptasi ucapan: Setelan adaptasi ucapan tingkat halaman dapat secara opsional menggantikan setelan adaptasi ucapan alur yang sama. Petunjuk yang lebih mendetail di adaptasi ucapan manual.

Untuk mengakses setelan halaman:

Konsol

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

API

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

Menghapus halaman

Untuk menghapus halaman:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih alur untuk halaman di bagian Flows.
5. Klik tombol setelan di samping nama tampilan halaman di bagian Halaman.
6. Pilih Hapus.

API

Lihat metode delete 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