Ringkasan intent (Dialogflow)

Intent adalah objek pesan yang menjelaskan cara melakukan sesuatu. Anda dapat menggunakan intent dengan salah satu dari dua cara berikut:

  • Dengan menyediakan fulfillment untuk intent, atau
  • Dengan meminta fulfillment intent oleh Asisten Google.

Proses yang digunakan untuk menyediakan fulfillment intent berbeda untuk developer yang mem-build dengan Dialogflow dan untuk developer yang mem-build dengan Actions SDK. Namun, dalam kedua kasus ini, Anda harus memberikan nama intent dan URL web fulfillment fulfillment Anda. Tindakan ini akan memberi tahu Actions on Google bahwa Anda dapat mendukung kueri pengguna yang cocok dengan intent.

Untuk meminta fulfillment intent, Anda menentukan intent dalam objek possibleIntents saat merespons Asisten. Dalam permintaan berikutnya ke fulfillment Anda, Asisten akan menampilkan hasil intent yang diproses kepada Anda. Untuk mengetahui informasi selengkapnya, baca ringkasan penggunaan helper.

Intent umum

Tabel berikut menjelaskan intent yang diminta Asisten untuk Anda penuhi.

Nama intent Penggunaan Peristiwa Dialogflow
actions.intent.MAIN Wajib: Setiap paket Action mendeklarasikan satu dan hanya satu intent yang berfungsi sebagai titik entri bagi pengguna untuk memulai percakapan. WELCOME atau GOOGLE_ASSISTANT_WELCOME
actions.intent.TEXT Mendapatkan representasi teks mentah dari permintaan pengguna. Anda paling sering menggunakannya saat terlibat dalam percakapan dengan pengguna.
actions.intent.CANCEL Anda menerima intent ini saat memilih untuk menerima intent pembatalan dalam paket tindakan Anda. Saat pengguna mengucapkan perintah pembatalan global seperti "berhenti", Anda akan menerima intent ini dalam permintaan berikutnya ke fulfillment, sehingga Anda dapat merespons dengan pesan terakhir dan melakukan pembersihan apa pun dalam logika fulfillment Anda. actions_intent_CANCEL
actions.intent.NO_INPUT Anda menerima intent ini saat memilih untuk menerima intent tanpa input dalam paket tindakan Anda. Jika pengguna tidak merespons suatu perintah, Anda akan menerima intent ini dalam permintaan fulfillment Anda berikutnya. actions_intent_NO_INPUT

Helpers

Tabel berikut menjelaskan helper yang didukung yang dapat Anda minta untuk dipenuhi Asisten.

Nama intent Penggunaan Peristiwa Dialogflow
actions.intent.PERMISSION Dapatkan nama lengkap, lokasi sementara, atau lokasi akurat pengguna, atau ketiganya. actions_intent_PERMISSION
actions.intent.OPTION Terima item yang dipilih dari UI daftar atau carousel. Atau, jika pengguna tidak memilih dari UI daftar atau carousel, terima input ucapan atau teks yang cocok dengan kunci dalam UI daftar atau carousel. actions_intent_OPTION
actions.intent.DATETIME Dapatkan input tanggal dan waktu dari pengguna. actions_intent_DATETIME
actions.intent.SIGN_IN Meminta alur penautan akun untuk menautkan akun pengguna. actions_intent_SIGN_IN
actions.intent.PLACE Dapatkan alamat atau lokasi tersimpan dari pengguna. actions_intent_PLACE
actions.intent.CONFIRMATION Dapatkan konfirmasi dari pengguna (misalnya, jawaban untuk pertanyaan ya atau tidak). actions_intent_CONFIRMATION
actions.intent.NEW_SURFACE Meminta izin kepada pengguna untuk menyerahkan ke platform Asisten lainnya. actions_intent_NEW_SURFACE

Intent bawaan

Intent bawaan membuat model beberapa cara umum yang digunakan pengguna untuk mengekspresikan tugas yang mereka coba lakukan atau informasi yang mereka cari, seperti memesan makanan, memesan transportasi, atau memeriksa saldo akun. Lihat referensi intent bawaan untuk mengetahui informasi selengkapnya.

Intent tambahan

Sebagian besar Action Percakapan dibuat dengan kombinasi intent, helper, dan respons umum. Namun, Action yang menggabungkan fitur tambahan seperti transaksi atau update harian memiliki akses ke intent khusus untuk fitur tersebut.

Penunjang transaksi

Tabel berikut menjelaskan helper yang terkait dengan penanganan pembelian yang dapat Anda minta untuk dipenuhi Asisten. Anda dapat menemukan informasi selengkapnya tentang cara menerapkan intent ini dan intent terkait lainnya dalam dokumentasi fitur transaksi.

Nama intent Penggunaan Peristiwa Dialogflow
actions.intent.DELIVERY_ADDRESS Mendapatkan input alamat pengiriman dari pengguna. actions_intent_DELIVERY_ADDRESS
actions.intent.TRANSACTION_REQUIREMENTS_CHECK Periksa apakah semua persyaratan untuk transaksi terpenuhi. actions_intent_TRANSACTION_REQUIREMENTS_CHECK
actions.intent.TRANSACTION_DECISION Menanyakan kepada pengguna apakah transaksi harus terjadi. actions_intent_TRANSACTION_DECISION
actions.intent.DIGITAL_PURCHASE_CHECK Memvalidasi konfigurasi transaksi pengguna. Digunakan untuk menghindari penawaran produk digital kepada pengguna yang transaksinya akan gagal. actions_intent_DIGITAL_PURCHASE_CHECK
actions.intent.COMPLETE_PURCHASE Memulai permintaan pembelian. Menghasilkan hasil pembelian yang menjelaskan apakah transaksi berhasil atau gagal dan bagaimana transaksi tersebut berhasil. actions_intent_COMPLETE_PURCHASE

Intent engagement pengguna

Tabel berikut menjelaskan intent yang terkait dengan fitur engagement pengguna. Anda dapat menemukan informasi selengkapnya tentang cara menerapkan intent ini dan intent terkait lainnya dalam dokumentasi fitur engagement pengguna.

Nama intent Menyediakan fulfillment Meminta pemenuhan Penggunaan Peristiwa Dialogflow
actions.intent.REGISTER_UPDATE X Meminta pengguna mendaftar untuk update. actions_intent_REGISTER_UPDATE
actions.intent.CONFIGURE_UPDATES X Anda menerima intent ini saat pengguna mencoba mendaftar untuk update (yaitu, intent Register_UPDATE harus dikirim). actions_intent_CONFIGURE_UPDATES

Intent kustom

Anda dapat membuat intent sendiri untuk menentukan pintasan ke dalam percakapan guna membantu pengguna menyelesaikan berbagai hal dengan lebih efisien. Intent ini berada di namespace Anda sendiri; Anda dapat menentukan cara pengguna memicu intent, dan paket Action Anda adalah satu-satunya yang dapat mendukungnya.

Untuk mengetahui informasi selengkapnya, baca menentukan Action di Dialogflow atau dengan Actions SDK. Anda dapat menemukan informasi selengkapnya tentang paket Action dalam dokumentasi Referensi paket tindakan.

Intent smart home

Jika membangun Action smart home, Anda dapat menentukan dukungan untuk intent dengan cara yang sedikit berbeda. Lihat dokumentasi intent smart home untuk informasi selengkapnya.