Membangun model pemanggilan

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.

Gambar 1. Model pemanggilan terdiri dari semua intent yang memenuhi syarat untuk memulai percakapan dengan Action Anda.

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:

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: