Model pemanggilan menentukan cara pengguna memanggil Action di project Anda. Saat pengguna memanggil Action, mereka akan memulai percakapan dengannya, yang ditentukan oleh model percakapan Anda. Anda dapat menentukan pemanggilan dengan cara berikut:
Pemanggilan utama - Ini adalah satu-satunya pemanggilan yang diperlukan untuk project Action 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.
Pemanggilan deep link - Ini adalah pemanggilan opsional yang memungkinkan Anda menentukan frasa pelatihan dalam intent kustom, sehingga pengguna dapat melakukan deep link ke bagian tertentu percakapan Anda. Pengguna dapat mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan <nama tampilan> hingga <frasa deep link>" untuk mencocokkan jenis niat 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. Misalnya, pengguna dapat mengucapkan "Ok Google, mainkan game", dan Asisten Google dapat menampilkan Action Anda sebagai opsi untuk pemanggilan.
Membuat pemanggilan utama
Setiap project Action memiliki pemanggilan utama default yang bertindak sebagai titik entri
default ke project Action Anda.Model bahasa untuk pemanggilan ini
dikaitkan dengan nama tampilan project Anda, sehingga pengguna hanya perlu mengucapkan
frasa yang mirip dengan "Ok Google, bicara dengan <display name>" untuk menggunakan
pemanggilan ini. Saat pengguna memanggil Action Anda dengan cara ini, runtime
Asisten cocok dengan intent sistem actions.intent.MAIN
.
Untuk membuat pemanggilan utama:
Membuat pemanggilan deep link
Untuk membuat pemanggilan deep link, Anda harus membuat intent pengguna global dengan frasa pelatihan yang menentukan input pengguna yang ingin ditetapkan untuk deep link. Pengguna mengucapkan nama tampilan Anda beserta frasa deep link untuk melakukan pemanggilan deep link (misalnya, "Ok Google, bicara dengan <nama tampilan> ke <frasa link dalam>")
Membuat pemanggilan implisit
Pemanggilan implisit memungkinkan pengguna memanggil Action Anda tanpa menggunakan nama tampilan project. Untuk menemukan Action yang cocok, Google menggunakan sinyal seperti pengguna yang 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 tindakan yang dapat dilakukan pengendali (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 membuat layanan web menangani panggilan:
Perintah
Pengendali intent Anda dapat merespons dengan prompt statis. Biasanya, perintah intent pemanggilan menyambut pengguna, mengarahkannya tentang cara menggunakan Action, atau merespons dengan informasi yang dibutuhkan pengguna dengan segera (Action 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 besar untuk menjalankan logika. Untuk bertransisi ke adegan: