Panduan ini menunjukkan cara menggunakan konsol Dialogflow CX untuk mem-build dan menguji agen pemesanan kemeja sederhana menggunakan alur. Saat berinteraksi dengan agen ini, Anda dapat menanyakan lokasi toko, mendapatkan jam buka toko, atau melakukan pemesanan kemeja.
Agen yang telah Anda selesaikan untuk panduan ini akan digambarkan dalam grafik oleh konsol seperti berikut:
Sebelum memulai
Anda harus melakukan hal berikut sebelum membaca panduan ini:
- Baca dasar-dasar alur.
- Lakukan langkah-langkah penyiapan.
Membuat agen
Buat agen baru untuk panduan ini:
- Buka konsol Dialogflow CX.
- Buat atau pilih project.
- Klik Buat agen.
- Pilih Buat sendiri.
- Isi formulir untuk setelan agen dasar:
- Anda dapat memilih nama tampilan apa pun.
- Pilih lokasi yang Anda inginkan. Klik tombol Edit jika Anda ingin mengubah setelan lokasi lanjutan.
- Pilih zona waktu pilihan Anda.
- Pilih bahasa default untuk agen Anda.
- Secara opsional, aktifkan logging Stackdriver.
- Klik Simpan.
Impor agen opsional
Panduan ini akan memandu Anda melalui langkah-langkah untuk membuat agen pemesanan kemeja sederhana. Jika ingin melewati langkah-langkah konsol, Anda dapat mendownload agen dan mengimpornya.
Alur dan intent default
Alur dan intent berikut dibuat secara otomatis untuk agen baru. Anda dapat menemukan intent dengan mengklik Kelola, lalu Intent. Anda dapat menemukan alur dengan mengklik Build.
| Istilah | Definisi |
|---|---|
| Intent Selamat Datang Default | Intent Selamat Datang Default memiliki frasa pelatihan sederhana seperti "Halo" atau "Selamat Datang" yang dimaksudkan untuk mencocokkan input awal pengguna akhir. Anda dapat mengedit intent ini sesuai keinginan. |
| Intent Negatif Default | Intent Negatif Default dapat digunakan untuk menambahkan frasa pelatihan ke intent ini yang berfungsi sebagai contoh negatif. |
| Alur Mulai Default | Alur Mulai Default dapat digunakan sebagai satu-satunya alur Anda. Ini adalah satu-satunya alur yang akan digunakan dalam panduan ini. Untuk agen yang lebih kompleks, Anda dapat menambahkan lebih banyak alur. Alur ini memiliki rute intent default dengan Intent Selamat Datang Default sebagai persyaratan intent. |
Menguji pesan respons selamat datang default
Alur dan intent default dapat menangani percakapan dasar hanya dengan pesan selamat datang. Untuk menguji agen baru:
- Klik tombol Test Agent untuk membuka simulator.
- Masukkan
hellodi entri teks, lalu tekan enter. - Agen akan merespons dengan respons sambutan default.
- Tutup simulator.
Langkah-langkah berikut dilakukan oleh agen untuk input pengguna akhir ini:
- Saat Anda memberikan input, Alur Mulai Default adalah alur aktif, dan halaman awal alur adalah halaman aktif. Setiap pengendali status yang diterapkan ke alur aktif berada dalam cakupan, sehingga agen mengevaluasinya.
- Salah satu rute yang dievaluasi memiliki Intent Selamat Datang Default sebagai persyaratan intent. Input Anda cocok dengan intent ini, sehingga rute dipanggil.
- Rute yang dipanggil memiliki beberapa pesan respons fulfillment. Agen memilih salah satu secara acak dan menambahkannya ke antrean respons.
- Rute yang dipanggil tidak memiliki target transisi, sehingga alur dan halaman aktif tidak berubah.
- Agen merespons dengan konten antrean respons.
Mengedit pesan respons selamat datang
Anda dapat mengubah pesan selamat datang ini. Untuk mengedit pesan respons selamat datang:
- Klik tab Build.
- Pilih Alur Mulai Default di bagian Alur.
- Klik node Start di grafik. Ini adalah halaman awal untuk Alur Awal Default.
- Temukan rute intent dengan Intent Selamat Datang Default sebagai persyaratan intent, lalu klik. Tindakan ini akan membuka panel untuk mengedit informasi rute intent.
- Temukan bagian fulfillment dan hapus semua pesan respons,
lalu tambahkan
Hello, this is a shirt ordering virtual agent. How can I help you?sebagai satu-satunya respons. - Klik Simpan.
- Tutup panel pengeditan rute intent.
Menguji pesan respons selamat datang yang diperbarui
Untuk menguji respons yang diperbarui:
- Klik tombol Test Agent untuk membuka simulator.
- Masukkan
hellodi entri teks, lalu tekan enter. - Agen akan merespons dengan pesan baru Anda.
- Tutup simulator.
Halaman lokasi toko
Percakapan (sesi) Agen Percakapan (Dialogflow CX) dapat dijelaskan dan divisualisasikan sebagai mesin status. Status sesi CX diwakili oleh halaman. Sejauh ini, Anda hanya memiliki satu halaman, sehingga agen tidak terlalu berguna. Di bagian ini, Anda akan membuat halaman lain yang menangani pertanyaan tentang lokasi toko.
Membuat intent lokasi
Intent mengategorikan niat pengguna akhir untuk satu giliran percakapan. Untuk membuat intent yang cocok saat input pengguna akhir meminta lokasi toko:
- Pilih tab Kelola.
- Klik Intent.
- Klik Create.
- Masukkan
store.locationuntuk nama tampilan intent. - Masukkan frasa pelatihan berikut:
Where is the store?DirectionsTell me the addressWhere do I pick up my order?How do I get there?Where is the store located?What street are you on?What is your address?How do I get to your store?Where are you located?
- Klik Simpan.
Membuat halaman lokasi
Sekarang buat halaman baru. Anda dapat menambahkan fulfillment entri ke halaman ini yang dipanggil setiap kali halaman menjadi aktif. Fulfillment entri ini harus memiliki pesan respons yang memberikan lokasi toko. Untuk membuat halaman lokasi toko:
- Klik tab Build.
- Pilih Alur Mulai Default di bagian Alur.
- Klik tombol add tambahkan di bagian Halaman. Entri teks untuk nama tampilan halaman akan muncul.
- Masukkan
Store Locationuntuk nama tampilan halaman, lalu tekan enter. - Klik tombol more_vert opsi di samping nama tampilan halaman.
- Pilih Edit untuk membuka panel pengeditan halaman.
- Temukan Fulfillment entri, lalu klik Edit fulfillment.
- Masukkan
Our store is located at 1007 Mountain Drive, Gotham City, NJ.di kolom Agent Says. - Klik Simpan.
- Tutup panel pengeditan halaman.
Menambahkan rute intent lokasi ke alur
Sekarang Anda perlu membuat rute yang memiliki halaman lokasi toko sebagai target transisi. Saat rute ini dipanggil, sesi akan bertransisi ke halaman lokasi toko. Rute ini diterapkan ke Alur Mulai Default, sehingga berada dalam cakupan selama alur aktif. Untuk agen aliran tunggal, ini berarti rute selalu dalam cakupan. Pada titik mana pun dalam percakapan, pengguna akhir dapat meminta lokasi toko, dan rute ini akan dipanggil.
Untuk membuat rute ini:
- Klik tab Build.
- Pilih Alur Mulai Default di bagian Alur.
- Klik node Start di grafik. Ini adalah halaman awal untuk Alur Awal Default.
- Tambahkan rute intent berikut:
- Intent:
store.location - Halaman Transisi:
Store Location
- Intent:
- Klik Simpan.
- Tutup panel pengeditan rute intent.
Saat menutup panel pengeditan, perhatikan bahwa halaman baru Anda memiliki node pada grafik. Panah dari node Start ke node Store Location menunjukkan cara sesi dapat bertransisi dari node ke node.
Menguji halaman lokasi toko
Untuk menguji halaman Anda:
- Klik tombol Test Agent untuk membuka simulator.
- Masukkan
What is the store location?dan tekan enter. - Agen memberikan alamat.
- Tutup simulator.
Langkah-langkah berikut dilakukan oleh agen untuk input pengguna akhir:
- Saat Anda memberikan input, Alur Mulai Default adalah alur aktif, dan halaman awal alur adalah halaman aktif. Setiap pengendali status yang diterapkan ke alur aktif berada dalam cakupan, sehingga agen mengevaluasinya.
- Salah satu rute yang dievaluasi memiliki store.location sebagai persyaratan intent. Input Anda cocok dengan intent ini, sehingga rute dipanggil.
- Rute yang dipanggil tidak memiliki pesan respons fulfillment, sehingga tidak menambahkan apa pun ke antrean respons.
- Rute yang dipanggil memiliki target transisi, sehingga halaman aktif berubah menjadi halaman Lokasi Toko.
- Halaman Lokasi Toko memiliki fulfillment entri, sehingga pesan respons untuk fulfillment tersebut ditambahkan ke antrean respons (alamat).
- Agen merespons dengan konten antrean respons.
Halaman jam buka toko menggunakan pembuatan inline
Di bagian ini, Anda akan membuat halaman Jam Buka yang menangani pertanyaan pengguna akhir tentang jam buka. Di bagian sebelumnya, Anda telah membuat halaman dan intent dari tab Build dan Manage. Bagian ini menunjukkan cara yang lebih cepat untuk membuat jenis ini dengan pembuatan inline.
Untuk membuat rute, intent, dan halaman intent secara inline:
- Klik node Start di grafik.
- Klik tombol Rute intent tambahkan add. Panel pengeditan rute intent akan terbuka.
- Di bagian Intent, pilih Intent baru. Panel pengeditan intent akan terbuka.
Buat intent
store.hoursdengan frasa pelatihan berikut:What are your store hours?What time do you close?
Klik Simpan untuk menyimpan intent. Panel pengeditan intent akan ditutup.
Scroll ke bawah ke bagian Transisi di panel pengeditan rute intent.
Untuk transisi Halaman, pilih Halaman baru.
Masukkan
Store Hoursdi entri teks yang muncul.Klik Simpan. Halaman baru akan muncul di grafik, karena sekarang ada transisi yang mengarah ke halaman tersebut.
Tutup panel pengeditan rute intent.
Tambahkan fulfillment entri yang memberikan jam buka toko, serupa dengan langkah-langkah yang dilakukan untuk Lokasi Toko.
Tutup panel pengeditan yang terbuka.
Halaman item pesanan
Selanjutnya, Anda akan membuat halaman yang menggunakan parameter formulir. Saat pengguna akhir meminta pesanan kemeja baru, sesi akan bertransisi ke halaman ini. Jika aktif, halaman ini akan mengumpulkan ukuran dan warna untuk pesanan kemeja.
Membuat jenis entity kustom untuk ukuran kemeja
Jenis entity digunakan untuk mengontrol cara data dari input pengguna akhir diekstrak. Agen Percakapan (Dialogflow CX) menyediakan entity sistem yang telah ditetapkan yang dapat mencocokkan banyak jenis data umum. Misalnya, ada entity sistem untuk mencocokkan tanggal, waktu, warna, alamat email, dan sebagainya. Anda juga dapat membuat entitas kustom Anda sendiri untuk mencocokkan data kustom.
Untuk agen ini, Anda dapat menggunakan entity sistem untuk warna kemeja, tetapi Anda perlu membuat entity kustom untuk ukuran kemeja. Jenis entity ukuran harus memiliki entri entity berikut:
| Entity | Sinonim |
|---|---|
| kecil | kecil, mungil, sedikit |
| sedang | sedang, reguler, rata-rata |
| besar | besar, raksasa |
Untuk membuat entity ini:
- Pilih tab Kelola.
- Klik Entity Types.
- Klik +Create.
- Tetapkan nama tampilan ke
size. - Tambahkan entri entitas yang tercantum dalam tabel di atas.
- Klik Simpan.
Membuat intent pesanan dengan parameter intent
Anda memerlukan intent yang cocok saat pengguna akhir meminta pesanan kemeja baru. Intent ini juga harus secara opsional mengambil warna dan/atau ukuran kemeja yang diinginkan yang diberikan oleh pengguna akhir jika mereka memberikan info tersebut di awal.
Parameter digunakan untuk mengambil dan mereferensikan nilai yang telah disediakan oleh pengguna akhir selama sesi. Setiap parameter memiliki nama tampilan dan jenis entity. Tidak seperti input pengguna akhir mentah, parameter adalah data terstruktur yang dapat dengan mudah digunakan untuk menjalankan beberapa logika atau menghasilkan respons.
Anda mengontrol cara data pengguna akhir diekstrak dengan pencocokan intent dengan
menambahkan anotasi
pada bagian frasa pelatihan dan mengonfigurasi
parameter intent terkait.
Misalnya, pertimbangkan frasa pelatihan seperti
"Bagaimana prakiraan cuaca besok untuk Tokyo?"
Anda harus menganotasi "tomorrow" dengan parameter date
dan "Tokyo" dengan parameter location.
Saat Anda menganotasi bagian frasa pelatihan,
Agen Percakapan (Dialogflow CX) akan mengenali bahwa bagian ini hanyalah contoh
nilai sebenarnya yang akan diberikan oleh pengguna akhir saat runtime.
Untuk input pengguna akhir seperti
"Bagaimana prakiraan cuaca di Sydney pada hari Jumat?",
Agen Percakapan (Dialogflow CX) akan mengekstrak parameter date dari "Jumat"
dan parameter location dari "Sydney".
Untuk menganotasi frasa pelatihan dengan konsol:
- Pilih bagian frasa pelatihan yang ingin Anda anotasikan.
- Pilih jenis entitas yang diinginkan dari daftar.
- Parameter akan dibuat untuk Anda di tabel parameter di bawah.
Buat intent yang mirip dengan langkah-langkah yang Anda ikuti di atas.
Beri nama intent ini order.new.
Untuk setiap frasa yang berisi warna,
anotasi warna dengan parameter color
dan jenis entitas sistem @sys.color.
Untuk setiap frasa yang berisi ukuran kemeja,
anotasi ukuran dengan parameter size
dan jenis entitas kustom @size yang Anda buat di langkah sebelumnya.
Frasa dan parameter pelatihan Anda akan terlihat seperti berikut:
Membuat halaman pesanan
Buat halaman pesanan baru dengan mengikuti langkah-langkah yang mirip dengan langkah sebelumnya:
- Nama tampilan:
New Order - Fulfillment entri:
Ok, let's start a new order.
Menambahkan formulir ke halaman pesanan
Untuk setiap halaman, Anda dapat menentukan formulir, yaitu daftar parameter yang harus dikumpulkan dari pengguna akhir untuk halaman tersebut. Agen berinteraksi dengan pengguna akhir untuk beberapa giliran percakapan, hingga mengumpulkan semua parameter formulir yang diperlukan, yang juga dikenal sebagai parameter halaman. Untuk setiap parameter formulir, Anda juga memberikan perintah yang digunakan agen untuk meminta informasi tersebut dari pengguna akhir. Proses ini disebut pengisian formulir.
Saat pengguna akhir memberikan parameter intent untuk kecocokan intent, parameter intent menjadi parameter sesi. Saat halaman awalnya menjadi aktif, semua parameter formulirnya diisi otomatis dengan parameter sesi yang bernama sama. Jadi, jika pengguna akhir memberikan ukuran atau warna saat intent order.new cocok, nilai ini akan otomatis diisi untuk formulir.
Untuk halaman pesanan baru, Anda perlu menentukan dua parameter formulir yang diperlukan:
| Wajib | Nama tampilan | Jenis entitas | Adalah daftar | Perintah |
|---|---|---|---|---|
| warna | @sys.color | Warna apa yang Anda inginkan? | ||
| ukuran | @size | Berapa ukuran yang Anda inginkan? |
Untuk menambahkan formulir ini:
- Klik halaman Pesanan Baru di grafik.
- Klik tombol Parameters add add. Panel pengeditan parameter akan terbuka.
- Tambahkan parameter seperti yang dijelaskan dalam tabel di atas.
- Klik Simpan.
- Tutup panel pengeditan parameter.
Menambahkan rute intent pesanan ke alur
Serupa dengan langkah-langkah yang Anda ikuti di atas, tambahkan rute ke Alur Mulai Default. Rute ini harus dipanggil saat pengguna akhir ingin membuat pesanan baru:
- Intent: order.new
- Halaman Target Transisi: Pesanan Baru
Laman konfirmasi
Halaman terakhir Anda hanya akan mengonfirmasi pesanan dan mengakhiri sesi.
Membuat halaman konfirmasi
Buat halaman konfirmasi dengan respons yang menggunakan parameter sesi untuk mengonfirmasi pesanan:
- Nama tampilan:
Order Confirmation - Fulfillment entri:
You can pick up your order for a $session.params.size $session.params.color shirt in 7 to 10 business days. Goodbye.
Menambahkan rute kondisi ke halaman pesanan
Anda juga dapat menggunakan kondisi untuk menentukan apakah rute dipanggil. Kondisi biasanya digunakan untuk memeriksa apakah formulir sudah lengkap, atau dikonfigurasi agar selalu dipanggil saat dievaluasi.
Untuk menetapkan kondisi di konsol, lihat dokumentasi Menetapkan kondisi.
Tambahkan rute berikut ke halaman pesanan, yang akan dipanggil saat formulir halaman pesanan diisi. Perhatikan cara rute kondisi ini menggunakan referensi parameter dalam responsnya kepada pengguna akhir dan cara rute ini mentransisikan sesi ke halaman Konfirmasi Pesanan.
- Kondisi:
$page.params.status = "FINAL" - Agent Says:
You have selected a $session.params.size, $session.params.color shirt. - Halaman Transisi:
Order Confirmation
Tambahkan rute berikut ke halaman pesanan, yang akan dipanggil untuk setiap giliran percakapan saat halaman aktif dan rute kondisi dievaluasi. Saat kondisi di atas dievaluasi dan dipanggil, halaman menjadi tidak aktif, sehingga rute kondisi true ini tidak dievaluasi:
- Kondisi:
true - Agent Says:
I'd like to collect a bit more information from you.
Membuat rute kondisi untuk mengakhiri sesi
Tambahkan rute kondisi berikut ke halaman Konfirmasi Pesanan untuk mengakhiri sesi setelah halaman tersebut aktif dan fulfillment entrinya diproses:
- Kondisi:
true - Target Transisi: Halaman:
End Session
Menguji agen yang telah selesai
Uji agen dengan dialog berikut:
| Dialog | Penjelasan |
|---|---|
|
Pengguna akhir: Halo Agen: Halo, ini adalah agen virtual pemesanan kemeja. Ada yang bisa dibantu? |
|
|
Pengguna akhir: Saya ingin membeli kemeja biru Agen: Baik, mari kita mulai pesanan baru. Agen: Kami ingin mengumpulkan sedikit informasi lagi dari Anda. Agen: Ukuran apa yang Anda inginkan? |
|
|
Pengguna akhir: besar Agen: Anda telah memilih kemeja biru besar. Agen: Anda dapat mengambil pesanan kemeja biru besar dalam waktu 7 hingga 10 hari kerja. Sampai jumpa. |
|
Productionization
Sebelum menjalankan agen di produksi, pastikan untuk menerapkan praktik terbaik produksi.