Membangun model pemanggilan

Model pemanggilan menentukan cara pengguna memanggil Action di project Anda. Ketika pengguna memanggil Action, mereka memulai percakapan dengannya, yaitu 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 mirip dengan "Ok Google, bicara dengan <nama tampilan>" 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 mendefinisikan frasa pelatihan dalam niat kustom, sehingga pengguna dapat melakukan deep link ke bagian tertentu dari percakapan. Pengguna dapat mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan <nama tampilan> ke <frasa deep link>" agar cocok dengan jenis (misalnya, "Ok Google, bicaralah dengan Fakta tentang Google untuk mendapatkan fakta")

  • Intent bawaan - Ini adalah pemanggilan opsional yang memungkinkan Anda memanfaatkan model pemanggilan. Dengan mendeklarasikan dukungan untuk intent bawaan, pengguna dapat menemukan dan memanggil project Actions 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 berfungsi sebagai pemanggilan default titik entri ke project Action Anda.Model bahasa untuk pemanggilan ini dikaitkan dengan nama tampilan proyek, jadi pengguna hanya perlu mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan <nama tampilan>" untuk menggunakan pemanggilan. Saat pengguna memanggil Actions Anda dengan cara ini, Asisten cocok dengan intent sistem actions.intent.MAIN.

Untuk membuat pemanggilan utama:

Untuk membangun pemanggilan deep link, Anda membuat intent pengguna global dengan pelatihan yang mendefinisikan input pengguna yang ingin Anda tetapkan untuk deep link. Pengguna mengucapkan nama tampilan Anda dan frasa deep link untuk dibawa pemanggilan deep link (misalnya, "Ok Google, bicara dengan <display nama> ke <frasa deep link>")

Membuat panggilan implisit

Pemanggilan implisit memungkinkan pengguna memanggil Action Anda tanpa menggunakan nama tampilan. Untuk menemukan Action yang cocok, Google menggunakan sinyal seperti pengguna yang memberi tahu Asisten untuk melakukan sesuatu yang mirip dengan frasa panggilan untuk satu intent yang dikonfigurasi, atau saat pengguna berada dalam konteks di mana Action Anda mungkin akan sesuai.

Menangani peristiwa pemanggilan

Jika Asisten cocok dengan salah satu intent global Anda, Asisten akan memicu peristiwa yang dapat diproses dengan sebuah pengendali. Bagian berikut menjelaskan apa yang dimaksud dengan pengendali dapat dilakukan (Anda dapat memilih salah satu atau kombinasi dari ketiganya).

Memicu webhook

Pengendali intent Anda dapat didelegasikan ke layanan web dengan memicu peristiwa webhook. Untuk memicu webhook dan membuat layanan web menangani pemanggilan:

Perintah

Pengendali intent Anda dapat merespons dengan perintah statis. Biasanya, perintah untuk permintaan pengguna menyambut pengguna, mengarahkan mereka pada cara menggunakan Action, atau merespons dengan informasi yang dibutuhkan pengguna dengan segera (Tindakan satu kali).

Untuk menangani pencocokan intent pemanggilan dengan perintah:

Transisi ke adegan

Pengendali intent Anda dapat bertransisi ke sebuah scene untuk memproses pemanggilan yang cocok intent. Hal ini memberi Anda fleksibilitas paling besar untuk menjalankan logika. Untuk bertransisi ke adegan: