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.