Halaman ini menjelaskan cara membuat aplikasi Google Chat yang dapat memahami dan merespons dengan bahasa alami menggunakan Dialogflow. Panduan ini menggunakan Dialogflow CX, yang memiliki integrasi langsung dengan Google Chat. Anda juga dapat menggunakan Dialogflow ES untuk membangun aplikasi Google Chat Dialogflow ES dengan mengikuti panduan Google Chat Dialogflow ES.
Misalnya, pertimbangkan aplikasi Chat yang membantu orang menyewa mobil. Pengguna dapat menulis, "Saya ingin menyewa mobil". Aplikasi Chat mungkin merespons dengan pertanyaan seperti "Di mana Anda ingin mengambil kendaraan?" yang memulai percakapan seperti manusia dengan pengguna. Dalam percakapan ini, aplikasi Chat memahami dan merespons dengan ucapan manusia saat memesan penyewaan mobil.
Ini hanyalah salah satu contoh. Aplikasi Chat Dialogflow berguna dalam semua jenis interaksi. Jika memerlukan ucapan manusia yang alami, aplikasi ini memerlukan aplikasi Chat Dialogflow. Agen bawaan membantu Anda memulai dengan cepat, dan menunjukkan kemampuan Dialogflow, seperti:
- Pesan penerbangan
- Menjadwalkan janji temu dokter
- Pesan pengantaran makanan
- Menjawab pertanyaan tentang katalog produk retail, seperti apakah item tersedia dalam warna lain
-
Gambar 1. Memilih agen siap pakai untuk aplikasi Chat Dialogflow. -
Gambar 2. Menguji agen di Dialogflow CX untuk memastikan logika dan konfigurasi agen berfungsi sebagaimana mestinya. Diagram ini menunjukkan serangkaian halaman topik yang berurutan yang berkaitan dengan langkah-langkah tertentu dalam percakapan, seperti menetapkan lokasi pengambilan dan pengembalian untuk mobil sewaan, serta mengonfigurasi logika yang menghubungkannya. Percakapan diuji di simulator. -
Gambar 3. Mengonfigurasi aplikasi Chat untuk memproses respons menggunakan agen Dialogflow CX di halaman konfigurasi Chat API di konsol Google Cloud. -
Gambar 4. Melakukan percakapan tentang pemesanan mobil sewaan dengan aplikasi Chat Dialogflow di Google Chat.
Tujuan
- Siapkan lingkungan Anda.
- Buat dan deploy agen Dialogflow CX.
- Buat dan deploy aplikasi Chat yang didukung oleh agen Dialogflow CX.
- Uji aplikasi Chat.
Prasyarat
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Project Google Cloud yang mengaktifkan penagihan. Untuk memeriksa apakah penagihan diaktifkan untuk project yang ada, lihat Memverifikasi status penagihan project Anda. Untuk membuat project dan menyiapkan penagihan, lihat Membuat project Google Cloud.
Arsitektur
Diagram berikut menunjukkan arsitektur aplikasi Chat yang dibangun dengan Dialogflow:
Dalam diagram sebelumnya, pengguna yang berinteraksi dengan aplikasi Chat Dialogflow memiliki alur informasi berikut:
- Pengguna mengirim pesan di Chat ke aplikasi Chat, baik di pesan langsung maupun di ruang Chat.
- Agen virtual Dialogflow, yang berada di Google Cloud, menerima dan memproses pesan untuk menghasilkan respons.
- Atau, menggunakan webhook Dialogflow, agen Dialogflow dapat berinteraksi dengan layanan pihak ketiga eksternal, seperti sistem manajemen project atau alat ticketing.
- Agen Dialogflow mengirimkan respons kembali ke layanan aplikasi Chat di Chat.
- Respons akan dikirim ke ruang Chat.
Menyiapkan lingkungan
Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di Konsol Google Cloud, aktifkan Google Chat API dan Dialogflow API.
Pastikan Anda mengaktifkan API di project Cloud yang benar, lalu klik Berikutnya.
Pastikan Anda mengaktifkan API yang benar, lalu klik Aktifkan.
Buat agen Dialogflow CX
Agen Dialogflow CX adalah agen virtual yang menangani percakapan serentak dengan pengguna akhir Anda. Modul ini adalah modul pemahaman bahasa alami yang memahami nuansa bahasa manusia. Dialogflow menerjemahkan teks pengguna akhir selama percakapan ke data terstruktur yang dapat dipahami oleh aplikasi dan layanan Anda. Anda mendesain dan membangun agen Dialogflow untuk menangani jenis percakapan yang diperlukan sistem Anda.
Agen Dialogflow seperti agen pusat panggilan manusia. Anda melatih keduanya untuk menangani skenario percakapan yang diharapkan, dan pelatihan Anda tidak perlu terlalu eksplisit.
Berikut cara membuat agen Dialogflow CX:
Di konsol Dialogflow CX, buka Konsol Dialogflow CX. Klik Menu > Dialogflow CX.
Pilih project Google Cloud. Untuk menemukan project, Anda mungkin perlu mengklik Semua, lalu menelusurinya.
Sekarang Anda memiliki opsi untuk memilih agen bawaan atau membuat agen Anda sendiri. Jika Anda lebih suka mempelajari penyesuaian agen secara mendetail nanti, pilih salah satu agen bawaan, yang juga berguna untuk mempelajari kemampuan agen.
Untuk memilih agen bawaan, ikuti langkah-langkah berikut:
- Klik Gunakan agen bawaan.
Pilih agen bawaan. Untuk panduan ini, pilih Perjalanan: rental mobil.
Agen diberi rating pemula, menengah, atau lanjutan berdasarkan jumlah fitur yang digunakan agen dan kecanggihan logika percakapannya. Memilih agen menengah atau lanjutan mungkin memerlukan penyesuaian dan setelan khusus agen, termasuk mengaktifkan fitur dan API di Konsol Google Cloud.
Klik Impor sebagai agen.
Untuk membuat agen Anda sendiri, ikuti langkah-langkah berikut:
- Klik Buat agen.
- Pilih Buat otomatis untuk membuat agen penyimpanan data atau pilih Buat sendiri untuk membuat jenis agen lainnya.
Untuk mengetahui panduan mendetail tentang proses pembuatan agen, lihat Membuat agen Dialogflow CX.
Konfigurasi setelan agen dasar:
- Di Nama tampilan, masukkan nama tampilan.
- Pilih lokasi yang Anda inginkan. Jika Anda ingin mengubah setelan lokasi lanjutan, klik Edit.
- Pilih zona waktu yang Anda inginkan.
- Pilih bahasa default untuk agen Anda. Anda tidak dapat mengubah bahasa default agen setelah dibuat.
Klik Buat. Dialogflow CX mulai membuat agen, lalu menampilkan alur mulai default agen.
Sesuaikan agen secara opsional. Untuk mengetahui panduan mendetail tentang proses penyesuaian agen, lihat Membuat agen Dialogflow CX.
Sebagai praktik terbaik, uji agen:
- Klik Test agent.
- Pilih Test agent in environment.
- Di Environment, pilih Draft.
- Di Flow, pilih Default Start Flow.
- Di Page, pilih Start Page.
- Di kotak penulisan Bicara dengan agen, ketik
Hello
, lalu tekan Enter. Agen akan merespons dengan memperkenalkan diri. - Selesaikan pengujian dengan melakukan percakapan pengujian contoh.
Agen Dialogflow CX dibuat. Kembali ke konsol Dialogflow CX. Klik Menu > Dialogflow CX.
Di bagian Agen, klik > Copy name. Simpan nama ini, karena Anda akan menggunakannya saat mengonfigurasi aplikasi Chat.
Membuat aplikasi Chat dan menghubungkannya dengan agen Dialogflow
Setelah membuat agen Dialogflow CX, ikuti langkah-langkah berikut untuk mengubahnya menjadi aplikasi Chat:
Di konsol Google Cloud, buka Google Chat API. Telusuri "Google Chat API", lalu klik Google Chat API, lalu klik Kelola.
Klik Konfigurasi dan siapkan aplikasi Chat:
- Di Nama aplikasi, masukkan
Dialogflow App
. - Di Avatar URL, masukkan
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
. - Di Deskripsi, masukkan
Responds to real human conversation
. - Di bagian Functionality, pilih Join spaces and group conversations.
- Di bagian Connection settings, pilih Dialogflow.
- Di bagian Dialogflow settings, pilih Dialogflow CX.
- Di Agent or Environment resource name, tempel nama agen Dialogflow CX yang Anda salin di akhir Create a Dialogflow CX agent.
- Sediakan aplikasi Chat ini untuk orang dan grup tertentu di domain Anda dan masukkan alamat email Anda.
- Di bagian Logs, pilih Log errors to Logging.
- Di Nama aplikasi, masukkan
Klik Simpan.
Aplikasi Chat siap menerima dan merespons pesan di Chat.
Menguji aplikasi Chat
Uji aplikasi Chat Dialogflow CX dengan mengirimkan pesan di Google Chat.
Buka Google Chat menggunakan akun Google Workspace yang Anda berikan saat menambahkan diri Anda sebagai penguji tepercaya.
- Klik Percakapan baru.
- Di kolom Tambahkan 1 orang atau lebih, ketik nama aplikasi Chat Anda.
Pilih aplikasi Chat Anda dari hasil. Pesan langsung akan terbuka.
Di pesan langsung baru dengan aplikasi, ketik
Hello
, lalu tekanenter
.Aplikasi Chat Dialogflow merespons dengan memperkenalkan dirinya.
- Selesaikan pengujian dengan melakukan percakapan pengujian contoh.
Contoh percakapan pengujian
Untuk menguji aplikasi Chat Dialogflow CX di konsol Dialogflow CX atau di Google Chat, lakukan percakapan berikut. Penjelasan ini membantu Anda memahami cara agen Dialogflow CX menafsirkan bahasa alami pengguna dan menghasilkan respons bahasa alaminya sendiri di setiap langkah dalam percakapan. Contoh percakapan ini didasarkan pada agen bawaan yang disebut Travel: car rental.
Dialog | Penjelasan |
---|---|
Pengguna akhir: Halo Agen: Halo! Saya adalah agen penyewaan mobil virtual. Saya dapat membantu Anda memulai pemesanan sewa mobil baru. Ada yang bisa saya bantu? |
|
Pengguna akhir: Saya ingin menyewa mobil. Agen: Di mana Anda ingin mengambil kendaraan? |
|
Pengguna akhir: Las Vegas Agen: Oke, pengambilan Anda akan dilakukan di Las Vegas. Agen: Apakah lokasi penurunan Anda berbeda dengan lokasi pengambilan? |
|
Pengguna akhir: Ya. Saya akan mengantarkan mobilnya di Los Angeles. Agen: Oke, pengantaran Anda akan dilakukan di Los Angeles. Agen: Kapan tanggal dan waktu yang Anda inginkan untuk mengambil kendaraan? |
|
Pengguna akhir: Saya ingin mengambil mobil pada 5 Maret pukul 12.00. Agen: Kapan tanggal dan waktu yang Anda inginkan untuk mengantarkan kendaraan? |
|
Pengguna akhir: 15 Maret pukul 12.00. Agen: Jadi, untuk mengonfirmasi: Anda akan mengambil kendaraan di Las Vegas 05-03-2024 12.00.00 dan mengembalikannya di Los Angeles 15-03-2024 12.00.00 Apakah sudah benar? |
|
Pengguna akhir: Ya, terima kasih. Agen: Bagus! Sekarang, pilih kendaraan. Agen: Apakah Anda ingin kendaraan kelas ekonomi atau mewah? |
|
Pengguna akhir: Ekonomi, ya. Agen: Apakah Anda ingin Cymbal Car atau Cymbal Truck? |
|
Pengguna akhir: Cymbal Truck. Agen: Cymbal Truck berharga $50,33 per hari. Kapasitasnya 4 orang dan dilengkapi dengan radio AM/FM. Ingin melanjutkan ke pembayaran? Pengguna akhir: Ya, tolong. |
|
Agen: Jenis kartu apa yang akan Anda gunakan? Pengguna akhir: Altostrat Agen: Masukkan nomor kartu. Pengguna akhir: 1234 1234 1234 1234 Agen: Siapa nama yang tertera di kartu? Pengguna akhir: Charlie Agen: Berapa alamat jalan penagihan? Pengguna akhir: 1800 Amphibious Blvd. Mountain View, CA Agen: Berapa kode ZIP penagihan? Pengguna akhir: 94045 Agen: Anda akan mengambil Cymbal Car di Las Vegas, 05-03-2024 12.00.00 dan mengembalikannya, 15-03-2024 12.00.00. Total untuk perjalanan ini adalah $175,38. Agen: Terima kasih telah menyewa mobil di tempat kami dan semoga hari Anda menyenangkan. |
|
Mengirim pesan kartu dari Dialogflow
Dialogflow dapat merespons dengan pesan teks atau kartu. Untuk merespons dengan pesan kartu, tentukan sebagai payload kustom dalam pemenuhan.
JSON berikut menunjukkan cara mengirim pesan kartu sebagai payload kustom dalam pemenuhan:
json
{
'cardsV2': [{
'cardId': 'createCardMessage',
'card': {
'header': {
'title': 'A card message!',
'subtitle': 'Sent from Dialogflow',
'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
'imageType': 'CIRCLE'
},
'sections': [
{
'widgets': [
{
'buttonList': {
'buttons': [
{
'text': 'Read the docs!',
'onClick': {
'openLink': {
'url': 'https://developers.google.com/workspace/chat'
}
}
}
]
}
}
]
}
]
}
}]
}
Batas dan pertimbangan
- Peristiwa interaksi chat
memiliki dukungan terbatas dan beberapa pertimbangan:
- Jenis peristiwa interaksi
berikut didukung:
MESSAGE
ADDED_TO_SPACE
CARD_CLICKED
- Untuk peristiwa
MESSAGE
atauADDED_TO_SPACE
, input kueri yang dikirim ke agen Dialogflow sesuai dengan nilai kolomargumentText
dalam pesan Chat. Jika pesan menyertakan perintah garis miring, nilai kolomtext
akan digunakan sebagai gantinya. - Untuk peristiwa
CARD_CLICKED
, input kueri yang dikirim ke agen Dialogflow diformat sebagaiCARD_CLICKED.functionName
, denganfunctionName
sesuai dengan nilai kolomfunction
dari objek Action yang dilampirkan ke elemen kartu interaktif (seperti tombol). - Payload JSON lengkap dari setiap peristiwa interaksi Chat
dikirim ke Dialogflow sebagai payload kustom dalam parameter kueri, dan
dapat diakses dengan
webhook Dialogflow
dengan mengkueri nilai kolom
WebhookRequest.payload
.
- Jenis peristiwa interaksi
berikut didukung:
- Pertimbangan untuk merespons
perintah garis miring dan
menerima data dari kartu atau dialog:
- Saat aplikasi Chat Dialogflow menerima pesan dengan perintah garis miring, input kueri hanya berisi nilai kolom
text
. Kolomtext
dimulai dengan nama perintah garis miring (misalnya,/command
), yang dapat Anda gunakan untuk mengonfigurasi maksud agen Dialogflow untuk mendeteksi perintah garis miring. - Jika agen Dialogflow perlu memproses payload JSON peristiwa interaksi Chat, agen dapat melakukannya dengan menggunakan webhook Dialogflow untuk memeriksa payload kustom dalam parameter kueri.
- Untuk menampilkan dialog dari
Agen Dialogflow, respons dengan satu payload JSON kustom yang
mencakup pesan yang berisi
DIALOG
respons tindakan. - Untuk memproses data yang dimasukkan dari kartu, agen Dialogflow dapat mendeteksi
maksud (intent) yang dimulai dengan teks
CARD_CLICKED
dan merespons dengan payload JSON kustom tunggal yang berisi action yang sesuai.
- Saat aplikasi Chat Dialogflow menerima pesan dengan perintah garis miring, input kueri hanya berisi nilai kolom
- Pratinjau link tidak didukung.
- Jika agen Dialogflow merespons hanya dengan satu pesan, pesan tersebut akan dikirim ke Google Chat secara serentak. Jika agen Dialogflow merespons
dengan beberapa pesan, semua pesan akan dikirim ke Chat
secara asinkron dengan memanggil metode
create
di resourcespaces.messages
di Chat API satu kali untuk setiap pesan. - Saat menggunakan integrasi Dialogflow CX dengan Chat, agen Dialogflow dan aplikasi Chat harus disiapkan di project Google Cloud yang sama. Jika Anda perlu menyiapkan Dialogflow dan Chat di project Cloud yang berbeda, Anda dapat menyiapkan server perantara untuk memfasilitasi koneksi. Untuk mempelajari caranya, lihat contoh integrasi Chat untuk Dialogflow CX ini di GitHub.
Memecahkan masalah
Saat aplikasi atau kartu Google Chat menampilkan error, antarmuka Chat akan menampilkan pesan yang mengatakan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error apa pun, tetapi aplikasi atau kartu Chat menghasilkan hasil yang tidak terduga; misalnya, pesan kartu mungkin tidak muncul.
Meskipun pesan error mungkin tidak ditampilkan di UI Chat, pesan error deskriptif dan data log tersedia untuk membantu Anda memperbaiki error jika logging error untuk aplikasi Chat diaktifkan. Untuk mendapatkan bantuan dalam melihat, men-debug, dan memperbaiki error, lihat Memecahkan masalah dan memperbaiki error Google Chat.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, sebaiknya hapus project Cloud tersebut.
- Di Konsol Google Cloud, buka halaman Manage resources. Klik Menu > IAM & Admin > Kelola Resource.
- Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus .
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
Topik terkait
- Dialogflow CX menggunakan pendekatan
mesin status
untuk desain agen Dialogflow, yang memberi Anda kontrol yang jelas dan eksplisit atas percakapan, pengalaman pengguna akhir yang lebih baik, dan alur kerja pengembangan yang lebih baik. Saat membangun aplikasi Chat Dialogflow, sebaiknya gunakan Dialogflow CX.
- Untuk mempelajari lebih lanjut cara membangun dan mengonfigurasi agen, lihat Agen Dialogflow CX.
- Untuk panduan mendetail yang menginstruksikan cara membangun dan mengonfigurasi agen, lihat Membuat agen Dialogflow CX.
- Membangun aplikasi untuk Google Chat dengan Gemini. Codelab: Untuk contoh cara membangun agen penyimpanan data Dialogflow CX, lihat aplikasi Chat pengetahuan dari codelab
- Membangun aplikasi untuk Google Chat dengan Gemini. Codelab: Untuk contoh cara membangun agen percakapan Dialogflow CX, lihat aplikasi Chat masukan dari codelab
- Dialogflow ES adalah cara lain untuk menggunakan Dialogflow dengan aplikasi Chat.