Buat Tindakan Kustom untuk Asisten Google: 12 Langkah

2024 Pengarang: John Day | [email protected]. Terakhir diubah: 2024-01-30 09:55

Melihat potensi Google Assistant seperti yang dihadirkan di Google I/O 18 serta Volvo Cars dalam sistem infotainment mereka, saya tidak bisa menahan diri untuk mencobanya. Saya menggunakan kembali salah satu proyek lama saya, VasttraPi dan menghubungkannya dengan Google Assistant. Jika Anda ingin membaca lebih lanjut tentang proyek ini, saya akan senang jika Anda melihat artikel terkait di blog saya: Tindakan khusus untuk Asisten Google.

Dalam Instruksi ini kami akan membahas langkah-langkah yang diperlukan untuk meluncurkan Tindakan Asisten Google Anda sendiri yang akan berkomunikasi dengan server Anda dan berbicara kembali kepada Anda, mencantumkan keberangkatan yang akan datang. Ingatlah bahwa kami tidak akan menggunakan SDK karena kami menjalankan ini sepenuhnya di dalam Asisten Google dan bukan di perangkat kami sendiri. Secara keseluruhan itu akan tetap sederhana. Tindakan Anda akan dapat digunakan di perangkat yang mendukung Asisten Google seperti ponsel, tablet, asisten rumah, dan perangkat yang dapat dikenakan dan Anda bahkan dapat membagikannya seperti yang Anda lakukan dengan aplikasi di Play Store!

Salah satu keuntungan utama membuat sesuatu seperti ini dibandingkan menggunakan layanan seperti IFTTT adalah Anda dapat membuat respons khusus di server Anda yang akan dibaca oleh Google Assistant. Dalam IFTTT komunikasi sejauh yang saya ketahui adalah satu arah.

Topik-topik berikut akan dibahas:

• Membuat proyek Aksi pertama Anda
• Membuat Niat kustom Anda
• Membuat entitas kustom Anda
• Menyetel webhook untuk memenuhi tindakan Anda
• Menyiapkan server REST sederhana, ditulis dengan Python dengan Flask, yang akan memberikan tanggapan atau "pemenuhan"
• Menguji proyek Aksi Anda
• Melepaskan proyek Aksi Anda

Di sini Anda tidak akan menemukan banyak detail atau teori tentang berbagai fungsi dan konsep Asisten Google. Jika Anda tertarik dengan mereka, saya sangat menyarankan Anda mengikuti tutorial resmi atau menonton video ini.

Langkah 1: Tetapkan Izin Akun Google Anda

Sebelum kita mulai, kita perlu memastikan Asisten Google memiliki izin yang sesuai.

1. Buka Kontrol Aktivitas

2. Pastikan yang berikut ini diaktifkan:

   1. Aktivitas Web & Aplikasi
   2. Informasi Perangkat
   3. Aktivitas Suara & Audio

Langkah 2: Buat Tindakan Anda

1. Buka Actions Console dan klik "Tambah/impor proyek"
2. Sebut saja proyek Tindakan ini "perencana lalu lintas lokal".
3. Klik "Buat proyek".
4. Di halaman berikutnya, jangan pilih kategori dan klik "Lewati".
5. Anda seharusnya berada di halaman utama Actions Console sekarang.

Langkah 3: Doa Tindakan

Tentukan bagaimana Anda ingin memicu Google Assistant untuk memulai tindakan Anda.

1. Klik "Tentukan bagaimana Tindakan Anda dipanggil" di bawah "Pengaturan cepat".
2. Sebut saja "Perencana lalu lintas lokal saya" dan klik "Simpan".

3. Klik pada prompt "PERBARUI SAMPEL INVOKASI" yang muncul setelah mengklik simpan.

   Anda juga dapat menemukan opsi ini di bawah "Informasi Direktori"

4. Tambahkan "Tanyakan perencana lalu lintas lokal saya" sebagai permintaan baru dan klik "Simpan".

Langkah 4: Tambahkan Tindakan Pertama Anda

1. Klik "Tindakan" di bilah kiri.
2. Klik "TAMBAHKAN TINDAKAN PERTAMA ANDA".
3. Pilih "Niat khusus" dan kemudian klik "Bangun".
4. Anda akan dibawa ke halaman Dialogflow dimana Anda akan mengimplementasikan logika utama.

Langkah 5: Frasa Pelatihan untuk Niat Anda

1. Pilih zona waktu Anda dan klik "Buat".
2. Pada halaman berikutnya, biarkan intent yang ada dan klik "CREATE INTENT".
3. Berikan maksud nama yang masuk akal, yaitu "keberangkatan".
4. Buka "Frase pelatihan" dan klik "Tambahkan frasa pelatihan".

5. Gunakan frasa berikut untuk melatih model Anda sehingga dapat menafsirkan apa yang Anda katakan:

   1. Saya di rumah sekarang
   2. Untuk saat ini saya di rumah
   3. Saya di apartemen kami saat ini
   4. Saya duduk di rumah
   5. Saat ini saya dekat dengan pekerjaan
   6. saya di tempat kerja
   7. saya sedang di kantor
   8. Kerja
   9. Rumah

Langkah 6: Entitas

Sekarang Anda telah menentukan apa yang kurang lebih diharapkan sebagai input, kita perlu menentukan bagian mana dari input yang menarik bagi logika bisnis kita sehingga dapat diekstraksi dan disorot ke server kita. Dalam kasus kami, kami ingin mengetahui apakah pengguna berada di rumah atau di tempat kerja, sehingga kami dapat merespons kembali dengan keberangkatan dari stasiun tertentu. Mari kita lihat bagaimana kita bisa melakukannya.

1. Jika Anda mengklik dua kali pada satu atau lebih kata dari frasa pelatihan, Anda akan mendapatkan daftar entitas yang telah ditentukan sebelumnya. Anda dapat membaca lebih lanjut tentang masing-masing dari mereka di sini. Secara keseluruhan, yang paling cocok adalah @sys.location namun saya pikir yang terbaik dan termudah jika kita membuat entitas kita sendiri yang harus kita sebut @current-location.
2. Klik opsi "Entitas" di sisi kiri.
3. Klik "BUAT ENTITAS".

4. Setel nama menjadi "lokasi saat ini" dan tentukan dua nilai referensi beserta sinonimnya:

   1. rumah

      rumah, rumah, apartemen, tempat tidur bayi

   2. kerja

      kerja, kantor, Aptiv, tambang kode (tertawa bercanda)

5. Klik "Simpan. Untuk efek ekstra, Anda juga dapat mengeklik "Izinkan perluasan otomatis" untuk memberi Asisten Google kebebasan lebih lanjut untuk mencoba dan mencocokkan lebih banyak sinonim dengan nilai referensi Anda.

Langkah 7: Tindakan dan Parameter

Saatnya memberi makna pada kata kunci di dalam frasa pelatihan Anda.

1. Klik "Intents" dan kemudian arahkan ke Intent kustom Anda, yaitu "keberangkatan" jika Anda telah mengikuti saran nama saya.
2. Gulir ke bawah ke "Frasa pelatihan".
3. Klik dua kali pada kata-kata yang menunjukkan lokasi Anda saat ini dan pilih tag @current-location dari jendela pop-up.
4. Gulir ke bawah ke "Tindakan dan parameter", klik "kelola"
5. Jika semuanya dilakukan dengan benar, Anda akan melihat entitas baru Anda terdaftar di sana.
6. Centang kotak "Diperlukan" yang membuat kolom baru, "Perintah", muncul. Prompt adalah apa yang akan didengar pengguna jika tidak ada yang sesuai dengan harapan yang diberikan.
7. Klik "Tentukan petunjuk" dan masukkan sesuatu seperti "Saya tidak mengerti lokasi Anda. Di mana Anda saat ini?".

Langkah 8: Pemenuhan

Sekarang saatnya untuk menghubungkan layanan web Anda ke Google Assistant Action. Kait Anda akan dipanggil saat maksud khusus ini dipicu dan harus menghasilkan pemenuhan tindakan ini. Sebelum itu, kami juga ingin menetapkan niat kami untuk menyimpulkan tindakan setelah terpenuhi.

1. Pergi ke "Respons" dan klik "TAMBAHKAN RESPON".
2. Jangan tambahkan tanggapan apa pun, cukup aktifkan "Tetapkan maksud ini sebagai akhir percakapan".
3. Gulir ke bawah ke "Fulfillment" klik "ENABLE FULFILLMENT" lalu aktifkan "Enable webhook call for this intent".
4. Klik "Simpan" dan kemudian pergi ke opsi "Pemenuhan" di sisi kiri.

5. Aktifkan opsi "Webhook" dan masukkan URL yang sedang "didengarkan" oleh server web Anda.

   Setiap kali niat dipicu, itu akan mengirim permintaan POST ke situs web Anda dengan isi permintaan yang berisi objek JSON dengan lokasi pengguna saat ini

6. Klik Simpan.
7. Sekarang kita siap untuk membuat layanan web kita, tetapi sebelum itu, mari kita pastikan bahwa Action kita menyambut kita dengan cara yang benar.

Langkah 9: Niat Selamat Datang

Untuk menyesuaikan pengalaman pengguna, kita harus membuat salam yang sesuai untuk kita setiap kali kita memicu tindakan kita.

1. Pergi ke "Intents" dan kemudian klik "Default Welcome Intent".
2. Gulir ke bawah ke "Respons", hapus yang sudah ada dan masukkan tindakan yang Anda inginkan bagaimana menyambut Anda setelah dimulai.
3. Klik "Simpan".

Langkah 10: Layanan Web Python Anda

Mari kita membuat server Python cepat dan kotor menggunakan Flask. Tidak ada tangkapan layar untuk langkah ini, tetapi harus cukup lurus ke depan.

1. Buka tab baru dan buat akun di pythonanywhere.com
2. Verifikasi email Anda.
3. Siapkan aplikasi web Anda dengan mengklik "Buka tab web".
4. Klik "Tambahkan aplikasi web baru" dan pilih "Flask" sebagai kerangka kerja web Python Anda.
5. Pilih Python 3.6 dan klik "Berikutnya".
6. Pilih jalur yang Anda inginkan untuk "flask_app.py" Anda. Saya menempatkannya langsung di dalam folder rumah saya sebagai "/home/nama-pengguna-anda/flask_app.py".
7. Kembali ke halaman utama dengan mengklik logo Python di sudut kiri atas.
8. Di bawah file, klik "flask_app.py" untuk mulai mengeditnya.
9. Ketika editor teks web terbuka, rekatkan kode berikut dan klik "Simpan". Ide keseluruhannya adalah bergantung pada JSON yang diurai yang berasal dari Asisten Google, server kami akan melakukan tindakan (misalnya membaca atau menulis) dan melaporkannya kembali sebagai tanggapan /fulfillment yang harus dibacakan kepada pengguna.
10. Klik "Buka tab web" lagi dan kemudian pada "tombol Muat Ulang" hijau.
11. Sekarang Anda harus memiliki server web Python Anda sendiri yang berjalan di "https://your-username.pythonanywhere.com/departures".

Langkah 11: Uji Tindakan Anda

OK, Anda cukup banyak dilakukan sekarang. Mari kita uji seluruh tumpukan sekarang dan buat contoh "Halo dunia" ini berfungsi!

1. Klik "Integrasi" dari bilah sisi kiri.
2. Klik "Pengaturan Integrasi" di bawah opsi Asisten Google.
3. Di bawah "Doa implisit tambahkan nama niat Anda, yaitu "keberangkatan" sehingga dapat dipicu secara langsung dengan mengatakan sesuatu seperti "Hai Google, bicarakan dengan perencana lalu lintas lokal saya tentang keberangkatan dari rumah".
4. Aktifkan perubahan "Pratinjau otomatis".
5. Klik "Test" yang akan membuka halaman baru.
6. Ketik "Bicara dengan perencana lalu lintas lokal saya".
7. Tindakan Anda harus dipanggil yang seharusnya menyapa Anda dengan salah satu respons niat selamat datang yang ditetapkan sebelumnya.
8. Kemudian ketik "Saya sedang bekerja". Server Python Anda harus dihubungi dan responsnya akan dibaca oleh Asisten Google.

Keren bukan? Sekarang bayangkan apa yang dapat Anda lakukan saat berinteraksi dengan sensor, aktuator, dan API lainnya melalui Asisten Google Anda.

Langkah 12: Lepaskan Tindakan Anda

Setelah Anda selesai menguji Tindakan Anda dan itu dalam keadaan baik, inilah saatnya untuk berbagi cinta dengan dunia atau, jika itu tidak masuk akal, dengan teman dan keluarga Anda.

1. Kembali ke konsol Tindakan Anda dan pilih tindakan perencana lalu lintas lokal Anda.
2. Di bawah "Bersiaplah untuk penerapan", klik "Masukkan informasi yang diperlukan untuk mencantumkan Tindakan Anda di direktori Tindakan".
3. Masukkan deskripsi singkat, deskripsi yang lebih panjang, logo kecil, detail kontak Anda, tautan kebijakan privasi (jika Anda tidak akan membagikan ini secara publik, cukup masukkan tautan ke situs web Anda atau semacamnya) dan sebuah kategori.
4. Gulir ke atas dan klik "Simpan".
5. Klik opsi "Lepaskan" dari bilah sisi kiri.
6. Di sini Anda dapat memilih status Action Anda. Jika Anda tidak ingin mendengar jawaban "Ayo dapatkan versi uji Perencana lalu lintas lokal saya", Anda harus membuat rilis publik yang lengkap. Namun hal itu memerlukan tinjauan oleh Google dan tidak akan dibahas dalam tutorial ini. Sebagai gantinya, Anda masih dapat membagikan ini hingga 20 orang dengan memilih rilis Alfa dan menambahkan mereka sebagai penguji Alfa.
7. Tambahkan penguji alfa dengan mengirimi mereka tautan atau menambahkan email mereka.
8. Klik "SUBMIT FOR ALPHA", centang kotak, klik "SUBMIT" dan selesai!

Sekarang Action Anda sudah aktif dan dapat diakses oleh Anda dan teman Anda. Selamat bersenang-senang!

Jika Anda tertarik dengan kode yang saya gunakan, lihat proyeknya di GitHub.