Model pemanggilan menentukan cara pengguna memanggil Action dalam project Anda. Saat pengguna memanggil Action, mereka akan memulai percakapan dengan Action, yang ditentukan oleh model percakapan Anda. Anda dapat menentukan pemanggilan dengan cara berikut:
Panggilan utama - Ini adalah satu-satunya pemanggilan yang diperlukan untuk project Actions Anda. Pengguna mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan <display name>" untuk mencocokkan intent ini, yang biasanya Anda tangani dengan menyapa pengguna dengan pesan selamat datang.
Panggilan deep link - Ini adalah pemanggilan opsional yang memungkinkan Anda menentukan frasa pelatihan dalam intent kustom, sehingga pengguna dapat melakukan deep link ke bagian tertentu dari percakapan Anda. Pengguna dapat mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan <nama tampilan> untuk <frasa deep link>" agar cocok dengan jenis intent ini (misalnya, "Ok Google, bicara dengan Fakta tentang Google untuk mendapatkan fakta perusahaan")
Intent bawaan - Ini adalah pemanggilan opsional yang memungkinkan Anda memanfaatkan model pemanggilan yang ditentukan sistem. Dengan mendeklarasikan dukungan untuk intent bawaan, pengguna dapat menemukan dan memanggil project Action Anda tanpa harus menentukan nama tampilan Anda. Misalnya, pengguna dapat mengucapkan "Ok Google, mainkan game", dan Asisten Google dapat menyajikan Action Anda sebagai opsi untuk dipanggil.
Membuat pemanggilan utama
Setiap project Actions memiliki pemanggilan utama default yang bertindak sebagai titik entri
default ke project Actions Anda.Model bahasa untuk pemanggilan ini
dikaitkan dengan nama tampilan project Anda, sehingga pengguna hanya perlu mengucapkan
frasa yang mirip dengan "Ok Google, talk to <display name>" untuk menggunakan
pemanggilan ini. Saat pengguna memanggil Action Anda dengan cara ini, runtime
Asisten akan cocok dengan intent sistem actions.intent.MAIN.
Untuk membuat pemanggilan utama:
Membuat pemanggilan deep link
Untuk membuat pemanggilan deep link, Anda dapat membuat intent pengguna global dengan frasa pelatihan yang menentukan input pengguna yang ingin Anda tetapkan untuk deep link. Pengguna mengucapkan nama tampilan Anda yang dikombinasikan dengan frasa deep link untuk melakukan pemanggilan deep link (misalnya, "Ok Google, bicara dengan <nama tampilan> ke <frasa deep link>")
Membuat pemanggilan implisit
Panggilan implisit memungkinkan pengguna memanggil Action tanpa menggunakan nama tampilan project Anda. Untuk menemukan Actions yang cocok, Google menggunakan sinyal seperti pengguna memberi tahu Asisten untuk melakukan sesuatu yang mirip dengan frasa pemanggilan untuk salah satu intent yang dikonfigurasi, atau saat pengguna berada dalam konteks di mana Action Anda akan sesuai.
Menangani peristiwa pemanggilan
Saat cocok dengan salah satu intent global Anda, Asisten akan memicu peristiwa yang dapat Anda proses dengan pengendali. Bagian berikut menjelaskan apa yang dapat dilakukan oleh pengendali Anda (Anda dapat memilih salah satu atau kombinasi dari ketiganya).
Memicu webhook
Pengendali intent Anda dapat mendelegasikan ke layanan web dengan memicu peristiwa webhook. Untuk memicu webhook dan meminta layanan web menangani pemanggilan:
Perintah
Pengendali intent Anda dapat merespons dengan perintah statis. Biasanya, perintah untuk intent pemanggilan menyambut pengguna, mengarahkan mereka pada cara menggunakan Action, atau merespons dengan cepat yang diperlukan pengguna (Tindakan satu kali).
Untuk menangani pencocokan intent pemanggilan dengan perintah:
Transisi ke scene
Pengendali intent Anda dapat bertransisi ke scene untuk memproses intent pemanggilan yang cocok. Hal ini memberi Anda fleksibilitas paling tinggi untuk menjalankan logika. Untuk bertransisi ke adegan: