Membuat Action untuk Asisten Google menggunakan Action Builder (Level 1)

Platform developer Asisten Google memungkinkan Anda membuat software untuk memperluas fungsi Asisten Google (asisten pribadi virtual) di lebih dari 1 miliar perangkat, termasuk smart speaker, ponsel, mobil, TV, headphone, dan lainnya. Pengguna berinteraksi dengan Asisten melalui percakapan untuk menyelesaikan berbagai hal, seperti membeli bahan makanan atau memesan transportasi online. Sebagai developer, Anda dapat menggunakan platform developer Asisten untuk dengan mudah membuat dan mengelola pengalaman percakapan yang menyenangkan dan efektif antara pengguna dan layanan fulfillment pihak ketiga Anda sendiri.

Codelab ini mencakup konsep tingkat awal pengembangan dengan Asisten Google; Anda tak perlu memiliki pengalaman sebelumnya menggunakan platform ini untuk menyelesaikannya. Dalam codelab ini, Anda akan membuat Action Asisten Google sederhana yang memberikan pengguna sebuah ramalan (Fortune) saat mereka memulai sebuah petualangan di negeri dongeng Gryffinberg. Di codelab level 2 Action Builder, Anda akan mengembangkan Action ini lebih lanjut untuk menyesuaikan ramalan pengguna berdasarkan input mereka.

Yang akan Anda buat

Dalam codelab ini, Anda akan membuat Action sederhana dengan fungsi berikut:

• Merespons pengguna dengan pesan sambutan
• Mengajukan pertanyaan kepada pengguna. Saat mereka menjawab, Action Anda akan menanggapi pilihan pengguna dengan tepat
• Memberikan chip saran yang dapat diklik pengguna untuk memberikan masukan
• Mengubah pesan sambutan kepada pengguna berdasarkan apakah mereka pengguna lama yang kembali

Setelah menyelesaikan codelab ini, Action lengkap Anda akan memiliki alur percakapan berikut:

Yang akan Anda pelajari

• Cara membuat project di Konsol Actions
• Cara mengirim pesan kepada pengguna setelah mereka memanggil Action Anda
• Cara memproses input pengguna dan memberikan respons
• Cara menguji Action di simulator Action
• Cara menerapkan fulfillment menggunakan editor Cloud Functions

Yang akan Anda butuhkan

Fitur berikut harus ada dalam lingkungan pengembangan Anda:

• Browser web, seperti Google Chrome

Bagian berikut menjelaskan cara menyiapkan lingkungan pengembangan dan membuat project Action Anda.

Memeriksa setelan izin Google Anda

Untuk menguji Action yang Anda buat di codelab ini, Anda perlu mengaktifkan izin yang diperlukan agar simulator dapat mengakses Action Anda. Untuk mengaktifkan izin, ikuti langkah-langkah berikut:

1. Buka halaman Kontrol aktivitas.
2. Login dengan Akun Google Anda, jika Anda belum melakukannya.
3. Aktifkan izin berikut:

• Aktivitas Web & Aplikasi
• Di bagian Aktivitas Web & Aplikasi, centang kotak di samping Sertakan histori Chrome dan aktivitas dari situs, aplikasi, dan perangkat yang menggunakan layanan Google.

Membuat project Action

Project Action Anda adalah container untuk Action Anda. Untuk membuat project Action codelab ini, ikuti langkah-langkah berikut:

1. Buka Konsol Actions.
2. Klik New project.
3. Ketikkan Project name, misalnya actions-codelab. (Nama adalah untuk referensi internal Anda. Setelah ini, Anda dapat menetapkan nama eksternal untuk project Anda.)

4. Klik Create project.
5. Di layar What kind of Action do you want to build?, pilih kartu Custom.
6. Klik Next.
7. Pilih kartu Blank project.
8. Klik Start building.

Mengaitkan akun penagihan

Untuk men-deploy fulfillment Anda nanti dalam codelab ini menggunakan Cloud Functions, Anda harus mengaitkan akun penagihan dengan project Anda di Google Cloud. Jika sudah memiliki akun penagihan, Anda dapat mengabaikan langkah-langkah berikut.

Untuk mengaitkan akun penagihan dengan project Anda, ikuti langkah-langkah berikut:

1. Buka halaman penagihan Google Cloud Platform.
2. Klik Tambahkan akun penagihan.
3. Masukkan informasi pembayaran Anda dan klik Mulai uji coba gratis saya atau Kirim dan aktifkan penagihan.
4. Klik tab Project Saya di bagian atas halaman.
5. Klik tiga titik pada Action di samping project Action untuk codelab ini.
6. Klik Ubah penagihan.
7. Di menu drop-down, pilih akun penagihan yang sudah Anda konfigurasi. Klik Tetapkan akun.

Agar tidak dikenai biaya lebih, ikuti langkah-langkah di bagian "Membersihkan project" pada halaman "Langkah berikutnya" di akhir codelab ini.

Pengguna memulai percakapan dengan Action Anda melalui pemanggilan (invocation). Misalnya, jika Anda memiliki Action bernama iFlix, pengguna bisa memanggil Action Anda dengan mengucapkan frasa seperti"Ok Google, bicara dengan iFlix", yang mana iFlix adalah nama tampilannya. Action Anda harus memiliki nama tampilan jika Anda ingin men-deploy-nya ke produksi; namun, untuk menguji Action, Anda tidak perlu menetapkan nama tampilan. Sebagai gantinya, Anda dapat menggunakan frasa "Talk to my test app" ("Bicara dengan aplikasi pengujian saya") di simulator untuk mengaktifkan Action Anda.

Anda harus mengedit pemanggilan utama untuk menentukan apa yang terjadi setelah pengguna memanggil Action Anda.

Istilah utama:

• Pemanggilan utama (main invocation): Titik entri bagi pengguna untuk memulai percakapan dengan Action Anda. Saat pengguna mengucapkan frasa yang mirip dengan "Ok Google, bicara dengan {display name}", pemanggilan utama akan memicu dan merespons pengguna.

Secara default, Action Builder menyediakan pesan generik saat pemanggilan dipicu ("Start building your Action by defining main invocation.") "Mulai buat Action Anda dengan menentukan pemanggilan utama".

Istilah utama:

• Pesan (prompt): Menentukan apa yang dikirimkan Action kepada pengguna sebagai respons. Pesan dapat berupa respons teks dan ucapan sederhana atau pesan yang lebih kaya, seperti kartu dan gambar.

Anda dapat menggunakan pesan khusus, Canvas, untuk menampilkan visual layar penuh kepada pengguna. Untuk informasi selengkapnya tentang Canvas, lihat Dokumentasi Canvas Interaktif.

Di bagian berikutnya, Anda akan menyesuaikan pesan untuk pemanggilan utama di Konsol Actions.

Menyiapkan pemanggilan utama

Untuk mengubah pesan yang dikirimkan Action kepada pengguna saat pengguna memanggil Action, ikuti langkah-langkah berikut:

1. Klik Main invocation di navigasi.

2. Di editor kode, ganti teks di kolom speech (Start building your action...) dengan pesan selamat datang berikut: A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey. =

Catatan: Anda dapat menggunakan format YAML ataupun JSON untuk mengedit pesan Anda.

3. Klik Save.

Menguji pemanggilan utama di simulator

Konsol Actions menyediakan sebuah fitur web untuk menguji Action Anda yang disebut simulator. Antarmukanya menyimulasikan perangkat hardware dan setelannya, sehingga Anda dapat berkomunikasi dengan Action Anda seolah-olah sedang menjalankannya di Layar Smart, ponsel, speaker, atau KaiOS.

Catatan: Anda dapat menemukan informasi terbaru tentang penggunaan simulator Konsol Actions di Panduan simulator Action. Baca bagian tersebut jika Anda mengalami masalah setelah mengikuti langkah-langkah berikut.

Saat Anda memanggil Action, maka sekarang Action tersebut akan merespons dengan pesan kustom yang telah Anda tambahkan ("A wondrous greeting, adventurer!…" ("Salam sejahtera, petualang!…")

Untuk menguji pemanggilan utama Action Anda di simulator, ikuti langkah-langkah berikut:

1. Di menu navigasi atas, klik Test untuk membuka simulator.
2. Untuk memanggil Action di simulator, ketik Talk to my test app di kolom Input di kiri atas, lalu tekan Enter.

Tips: Anda juga dapat mengklik chip saran, Talk to my test app, atau mengklik ikon mikrofon dan mengucapkan "Talk to my test app" untuk memanggil Action.

Saat Anda memicu pemanggilan utama Action, Asisten akan merespons dengan pesan selamat datang yang telah disesuaikan. Pada tahap ini, percakapan akan berakhir setelah Asisten merespons dengan salam. Di bagian berikutnya, Anda akan mengubah Action sehingga percakapan berlanjut.

Melihat log aktivitas

Saat Anda berada di tab Test, panel di sebelah kanan menampilkan log aktivitas, yang menampilkan histori percakapan sebagai log aktivitas. Setiap log aktivitas menampilkan aktivitas yang terjadi selama percakapan tersebut

Action Anda saat ini memiliki satu log aktivitas, yang menampilkan input pengguna ("Talk to my test app") dan respons Action Anda. Screenshot berikut menunjukkan log aktivitas Action Anda:

Jika Anda mengklik panah bawah di log aktivitas, Anda dapat melihat aktivitas yang terjadi selama percakapan tersebut, tersusun secara kronologis:

• userInput: Merujuk pada input pengguna ("Talk to my test app").
• interactionMatch: Merujuk pada respons pemanggilan utama Actions Anda, yang dipicu oleh input pengguna. Jika Anda meluaskan baris ini dengan mengklik panahnya, Anda dapat melihat pesan yang ditambahkan untuk pemanggilan utama (A wondrous greeting, adventurer!...)
• endConversation: Merujuk pada transisi yang dipilih dalam intent Main invocation, yang saat ini mengakhiri percakapan. (Anda akan mempelajari transisi ini selengkapnya di bagian berikutnya dari codelab ini.)

Log aktivitas memberikan visibilitas tentang cara kerja Action Anda dan merupakan fitur yang berguna untuk men-debug Action jika Anda menemui masalah. Untuk melihat detail aktivitas, klik panah di sebelah nama aktivitas, seperti yang ditampilkan di screenshot berikut:

Kini, setelah Anda menentukan apa yang terjadi setelah pengguna memanggil Action, Anda dapat membuat bagian percakapan Action lainnya. Sebelum melanjutkan dengan codelab ini, biasakan diri Anda dengan istilah berikut untuk memahami cara kerja percakapan Action:

Istilah utama:

• Scene: Blok penyusun Action Anda yang memproses input pengguna dan biasanya menghasilkan respons kepada pengguna. Intent pengguna sering kali mengaktifkan scene lainnya, tetapi scene juga dapat diaktifkan dengan cara lain.
• Intent pengguna: Menentukan input pengguna yang dapat dipahami Action. Anda yang akan menentukan frasa pelatihan untuk intent ini. Saat pengguna mengucapkan sesuatu yang cocok atau mirip dengan frasa pelatihan, intent yang sesuai akan dicocokkan.
• Frasa pelatihan: Contoh-contoh apa yang mungkin pengguna ucapkan, yang cocok dengan sebuah intent. Mesin natural language understanding (NLU) Asisten secara alami memperluas frasa pelatihan ini untuk mencakup frasa lain yang serupa.
• Transisi: Menentukan scene yang menjadi tujuan transisi setelah kondisinya (condition) terpenuhi.

Action Anda dapat memiliki satu atau beberapa scene, dan Anda harus mengaktifkan setiap scene sebelum Action dapat berjalan. (Action yang Anda buat di codelab ini hanya memiliki satu scene bernama Start). Cara paling umum untuk mengaktifkan scene adalah dengan mengonfigurasi Action, sehingga saat input pengguna cocok dengan sebuah intent pengguna dalam scene, intent tersebut memicu transisi ke scene lain dan mengaktifkannya.

Misalnya, bayangkan ada contoh Action yang menceritakan fakta hewan kepada pengguna. Saat pengguna memanggil Action ini, intent Main invocation dicocokkan dan memicu transisi ke scene bernama Facts. Transisi ini mengaktifkan scene Facts, yang mengirimkan pesan berikut kepada pengguna: Would you like to hear a fact about cats or dogs? Dalam scene Facts terdapat intent pengguna yang disebut Cat, yang berisi frasa pelatihan yang mungkin diucapkan pengguna untuk mendengar fakta kucing, seperti "I want to hear a cat fact " ("Saya ingin mendengar fakta kucing") atau "cat". Saat pengguna meminta untuk mendengar fakta kucing, intent Cat dicocokkan, dan memicu transisi ke scene yang disebut Cat fact. Scene Cat fact akan mengaktifkan dan mengirimkan pesan ke pengguna yang menyertakan fakta kucing.

Gambar 1. Alur percakapan umum dalam sebuah Action yang dibuat dengan Action Builder.

Bersama-sama, scene, intent, dan transisi membentuk logika percakapan Anda dan menentukan berbagai jalur yang dapat diambil pengguna dalam percakapan Action Anda. Di bagian berikutnya, Anda akan membuat scene dan menentukan cara scene tersebut diaktifkan setelah pengguna memanggil Action Anda.

Melakukan transisi dari pemanggilan utama ke scene

Di bagian ini, Anda akan membuat scene baru bernama Start, yang mengirimkan pesan kepada pengguna yang menanyakan apakah mereka ingin diberi tahu ramalannya. Anda juga akan menambahkan transisi dari pemanggilan utama ke scene Start yang baru.

Untuk membuat scene ini dan menambahkan transisi ke scene tersebut, ikuti langkah-langkah berikut:

1. Klik Develop di navigasi atas. Kemudian, klik Main invocation di navigasi sebelah kiri.
2. Pada bagian Transition di sebelah kanan, klik menu drop-down dan ketik Start di kolom teks.

3. Klik Add. Tindakan ini akan membuat scene yang disebut Start, dan memberi tahu Action untuk bertransisi ke scene Start setelah Action mengirimkan pesan sambutan kepada pengguna.
4. Klik Scenes di navigasi kiri untuk menampilkan daftar scene.
5. Di bagian Scene, klik Start untuk melihat scene Start.
6. Klik + di bagian On enter pada scene Start.
7. Pilih Send prompts.
8. Ganti kalimat di kolom speech (Enter the response that users will see or hear...) dengan pertanyaan untuk diajukan kepada pengguna: Before you continue on your quest, would you like your fortune told?

9. Klik Save.

Asisten Google memberikan pesan ini (Before you continue on your quest...) kepada pengguna saat mereka memasuki scene Start.

Menambahkan chip saran

Chip saran menawarkan saran yang dapat diklik untuk pengguna. Chip ini kemudian akan diproses Action sebagai input pengguna. Di bagian ini, Anda akan menambahkan chip saran yang muncul di bawah pesan yang baru saja Anda konfigurasikan (Before you continue on your quest, would you like your fortune told?) untuk mendukung pengguna di perangkat berlayar.

Untuk menambahkan chip saran ke pesan scene Start, ikuti langkah-langkah berikut:

1. Di scene Start, klik suggestions di bawah editor kode. Tindakan ini menambahkan satu chip saran.
2. Di kolom title, ganti Suggested Response dengan 'Yes'.
3. Menggunakan format yang sama, tambahkan chip saran bernama 'No' secara manual. Kode Anda akan terlihat seperti cuplikan berikut:

    suggestions:
      - title: 'Yes'
      - title: 'No'

4. Klik Save.

Menguji Action Anda di simulator

Sampai di sini, Action Anda seharusnya bertransisi dari pemanggilan utama ke scene Start dan bertanya kepada pengguna apakah mereka ingin menerima ramalan. Chip saran juga akan muncul di tampilan simulasi.

Untuk menguji Action Anda di simulator, ikuti langkah-langkah berikut:

1. Di menu navigasi, klik Test untuk membuka simulator.
2. Untuk menguji Action Anda di simulator, ketik Talk to my test app di kolom Input.
3. Tekan Enter. Action Anda akan menanggapi dengan pesan Main invocation dan pesan scene Start yang ditambahkan, "Before you continue on your quest, would you like your fortune told?"("Sebelum melanjutkan misi, apakah Anda ingin mendengar ramalan?")

Screenshot berikut menunjukkan interaksi ini:

Catatan: Log aktivitas mencatat setiap interaksi simulator dalam sesi saat ini, sehingga log aktivitas dari pengujian Anda sebelumnya dalam codelab ini muncul sebagai log aktivitas pertama. Untuk menghapus log aktivitas, klik Reset Test.

4. Klik chip saran Yes atau No untuk merespons pesan. (Anda juga dapat mengucapkan "Yes" atau "No" atau masukkan Yes atau No di kolom Input.)

Saat Anda merespons pesan, Action merespons dengan pesan yang menunjukkan bahwa ia tidak dapat memahami input Anda: "Sorry, I didn't catch that. Can you try again?" ("Maaf, saya tidak mengerti. Boleh ucapkan lagi?") Karena Anda belum mengonfigurasi Action untuk memahami dan merespons input "Yes" atau "No", Action Anda akan mencocokkan input dengan intent NO_MATCH.

Istilah utama:

• NO_MATCH: Intent segala jenis yang akan dicocokkan saat pengguna mengucapkan sesuatu yang tidak dapat dicocokkan dengan intent lain di Action Anda.
• Intent sistem: Intent yang dikonfigurasi secara default dan menangani aktivitas sistem umum, seperti saat pengguna tidak memberikan masukan. NO_MATCH dan intent yang dikaitkan dengan pemanggilan utama adalah contoh intent sistem.

Secara default, intent sistem NO_MATCH memberikan respons generik, tetapi Anda dapat menyesuaikan respons ini untuk menunjukkan kepada pengguna bahwa Anda tidak memahami input mereka. Asisten mengakhiri percakapan pengguna dengan Action Anda setelah tidak bisa mencocokkan input pengguna sebanyak tiga kali.

Menambahkan intent yes dan no

Kini pengguna dapat merespons pertanyaan yang ada di Action, maka selanjutnya Anda dapat mengonfigurasi Action untuk memahami respons pengguna ("Yes" atau "No"). Di bagian berikut, Anda akan membuat intent pengguna yang dicocokkan saat pengguna mengatakan "Yes" atau "No" dan menambahkan intent ini ke scene Start.

Membuat intent yes

Untuk membuat intent yes, ikuti langkah-langkah berikut:

1. Klik Develop di navigasi.
2. Klik Intent di navigasi untuk membuka daftar intent.
3. Klik + (tanda plus) di akhir daftar intent. Beri nama untuk intent baru yes lalu tekan Enter.
4. Klik intent yes untuk membuka halaman intent yes.
5. Di bagian Add training phrases, klik kotak teks Enter Phrase dan masukkan frasa berikut:

• Yes
• Y
• I would
• Tell me

6. Klik Save.

Tambahkan intent yes ke scene Start

Sekarang, Action dapat memahami kapan pengguna menyatakan intent "yes". Anda dapat menambahkan intent pengguna yes ke scene Start, karena pengguna menanggapi pesan Start ("Before you continue on your quest, would you like your fortune told?") ("Sebelum melanjutkan misi, apakah Anda ingin mendengar ramalan?").

Untuk menambahkan intent pengguna ini ke scene Start, ikuti langkah-langkah berikut:

1. Klik scene Start di navigasi.
2. Klik + (tanda plus) di scene Start di samping User intent handling.
3. Pilih yes pada drop-down intent.

4. Klik Send prompts dan perbarui kolom speech dengan teks berikut: Your future depends on the aid you choose to use for your quest. Choose wisely! Farewell, stranger.

Kode di editor Anda akan terlihat seperti cuplikan berikut:

 candidates:
  - first_simple:
      variants:
        - speech: >-
            Your future depends on the aid you choose to use for your quest. Choose
            wisely! Farewell, stranger.

5. Di bagian Transition, klik drop-down dan pilih End conversation.
6. Klik Save.

Menguji intent yes di simulator

Pada tahap ini, Action Anda seharusnya paham saat pengguna ingin mendengarkan ramalan dan memberikan respons yang sesuai.

Untuk menguji intent ini di simulator, ikuti langkah-langkah berikut:

1. Di menu navigasi, klik Test.
2. Untuk menguji Action di simulator, ketik Talk to my test app di kolom Input, lalu tekan Enter.
3. Ketik Yes di kolom Input, lalu tekan Enter. Atau, klik chip saran Yes.

Action Anda merespons pengguna dan memberi tahu ramalan mereka tergantung bantuan yang mereka pilih. Action Anda lalu mengakhiri sesi karena Anda telah memilih transisi End conversation untuk intent yes.

Membuat intent no

Sekarang, Anda perlu membuat intent no untuk memahami dan merespons pengguna saat mereka tidak ingin mendengar ramalan. Untuk membuat intent ini, ikuti langkah-langkah berikut:

1. Klik Develop di navigasi.
2. Klik Intent di navigasi untuk membuka daftar intent.
3. Klik + (tanda plus) di akhir daftar intent. Beri nama untuk intent baru no lalu tekan Enter
4. Klik no untuk membuka halaman intent no.
5. Di bagian Add training phrases, klik kotak teks Enter Phrase dan masukkan frasa berikut:

• No
• N
• I don't want
• nope

6. Klik Save.

Tambahkan intent no ke scene Start

Sekarang, Action dapat memahami saat pengguna menyatakan "no" atau sesuatu yang mirip dengan "no", seperti "nope". Anda perlu menambahkan intent pengguna no ke scene Start karena pengguna merespons pesan Start ("Before you continue on your quest, would you like your fortune told?" ("Sebelum melanjutkan misi, apakah Anda ingin mendengar ramalan?").

Untuk menambahkan intent ini ke scene Start, ikuti langkah-langkah berikut:

1. Klik scene Start di navigasi.
2. Klik + (tanda plus) di scene Start di samping User intent handling.
3. Di bagian Intent, pilih no di drop-down.

4. Klik Send prompts dan perbarui kolom speech dengan teks berikut: I understand, stranger. Best of luck on your quest! Farewell.

Kode di editor Anda akan terlihat seperti cuplikan berikut:

 candidates:
  - first_simple:
      variants:
        - speech: >-
             I understand, stranger. Best of luck on your quest! Farewell.

5. Di bagian Transition, pilih End conversation dari drop-down.
6. Klik Save.

Menguji intent no di simulator

Pada tahap ini, Action Anda seharusnya paham ketika pengguna tidak ingin mendengar ramalan dan memberikan respons yang sesuai.

Untuk menguji intent ini di simulator, ikuti langkah-langkah berikut:

1. Di menu navigasi, klik Test.
2. Ketik Talk to my test app di kolom Input, lalu tekan Enter.
3. Ketik No di kolom Input, lalu tekan Enter. Atau, klik chip saran No.

Alih-alih memberikan ramalan kepada pengguna, Action Anda memberi ucapan semoga beruntung dalam perjalanan mereka. Action Anda lalu mengakhiri sesi karena Anda telah memilih transisi End conversation untuk intent no.

Saat ini, respons Action Anda statis; saat scene yang berisi pesan diaktifkan, Action Anda akan mengirim pesan yang sama setiap kali. Di bagian ini, Anda akan menerapkan fulfillment yang berisi logika untuk menyusun respons percakapan dinamis.

Istilah utama:

• Fulfillment: Kode yang berisi logika untuk Action Anda. Webhook memicu panggilan ke fulfillment Anda berdasarkan aktivitas yang terjadi dalam Action Anda.

Fulfillment Anda mengidentifikasi apakah pengguna adalah pengguna yang kembali atau pengguna baru dan mengubah pesan sambutan Action untuk pengguna yang kembali. Pesan sambutan dipersingkat bagi pengguna yang kembali dan memberi konfirmasi tentang kembalinya pengguna: "A wondrous greeting, Adventurer! Welcome back to the mythical land of Gryffinberg!" ("Salam sejahtera, Petualang! Selamat datang kembali di negeri dongeng Gryffinberg!")

Untuk codelab ini, gunakan editor Cloud Functions di Konsol Actions untuk mengedit dan men-deploy kode fulfillment Anda.

Istilah utama:

• Editor Cloud Functions: Editor bawaan di Konsol Actions, yang dapat Anda gunakan untuk mengedit dan men-deploy kode fulfillment Anda menggunakan Cloud Functions for Firebase.

Action Anda dapat memicu webhook yang memberitahukan fulfillment Anda atas aktivitas yang terjadi selama pemanggilan atau bagian tertentu dari eksekusi scene. Ketika webhook dipicu, Action Anda mengirimkan permintaan dengan payload JSON ke fulfillment Anda bersama dengan nama pengendali yang digunakan untuk memproses aktivitas. Pengendali ini menjalankan beberapa logika dan memberikan respons JSON yang sesuai.

Membuat fulfillment

Anda kini dapat mengubah fulfillment Anda di editor langsung untuk membuat pesan yang berbeda bagi pengguna yang kembali dan pengguna baru saat mereka memanggil Action Anda.

Untuk menambahkan logika ini ke fulfillment Anda, ikuti langkah-langkah berikut:

1. Klik Develop di navigasi.
2. Klik tab Webhook di navigasi.
3. Pilih Inline Cloud Functions dan klik Confirm. Kode boilerplate otomatis ditambahkan untuk file index.js dan package.json.

4. Ganti konten index.js dengan kode berikut:

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

const app = conversation({debug: true});

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});

exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

5. Klik Save Fulfillment.
6. Klik Deploy Fulfillment.

Tunggu beberapa menit untuk Cloud Functions melakukan penyediaan (provisioning) dan men-deploy fulfillment Anda. Anda akan melihat pesan Cloud Function deployment in progress... di atas editor kode. Jika kode berhasil di-deploy, pesan akan berubah menjadi Your Cloud Function deployment is up to date.

Memahami kode

Fulfillment Anda, yang menggunakan library Fulfillment Actions on Google untuk Node.js, merespons permintaan HTTP dari Asisten Google.

Pada cuplikan kode sebelumnya, Anda menentukan pengendali greeting, yang memeriksa apakah pengguna pernah mengunjungi Action sebelumnya dengan cara mengecek properti lastSeenTime. Jika lastSeenTime tidak ditetapkan, maka pengguna adalah pengguna baru, dan pengendali greeting memberikan sambutan pengguna baru.

Memperbarui pemanggilan utama untuk memicu webhook

Setelah Anda menentukan fungsi greeting, Anda dapat mengonfigurasi pengendali aktivitas greeting di intent pemanggilan utama, sehingga Action Anda tahu untuk memanggil fungsi ini saat pengguna memanggil Action.

Untuk mengonfigurasi Action untuk memanggil pengendali greeting baru, ikuti langkah-langkah berikut:

1. Klik Main invocation di navigasi.
2. Hapus Send prompts dan pilih Call your webhook.
3. Tambahkan greeting di kotak teks.

4. Klik Save.

Menguji pemanggilan utama yang diperbarui di simulator

Untuk menguji Action Anda di simulator, ikuti langkah-langkah berikut:

1. Di menu navigasi, klik Test untuk membuka simulator.
2. Untuk menguji Action dalam simulator, ketik Talk to my test app di kolom Input, lalu tekan Enter.

Karena sebelumnya Anda telah menguji Action di codelab ini, Anda bukan pengguna baru, jadi Anda akan menerima sambutan singkat berikut: "A wondrous greeting, Adventurer! Welcome back to the mythical land of Gryffinberg!…" ("Salam sejahtera, Petualang! Selamat datang kembali di negeri dongeng Gryffinberg!…")

Selamat!

Kini Anda telah mengetahui dasar-dasar membuat Action untuk Asisten Google.

Yang telah Anda pelajari

• Cara menyiapkan project Action di Konsol Actions
• Cara menambahkan pesan ke pemanggilan utama sehingga pengguna dapat memulai percakapan dengan Action Anda
• Cara membuat antarmuka percakapan dengan scene, intent, transisi, chip saran, dan fulfillment
• Cara menguji Action dengan simulator Action

Referensi pembelajaran tambahan

Jelajahi referensi berikut untuk mempelajari lebih lanjut cara membuat Action untuk Asisten Google:

• Membuat Action untuk Asisten Google menggunakan codelab Actions Builder (Level 2) untuk lanjut mengembangkan Action Percakapan dari codelab ini
• Situs dokumentasi resmi untuk mengembangkan Action untuk Asisten Google.
• Halaman GitHub Actions on Google untuk kode contoh dan library
• Komunitas Reddit resmi untuk developer yang menangani Asisten Google

Ikuti @ActionsOnGoogle di Twitter untuk mendapatkan pengumuman dan kirim tweet dengan tagar #AoGDevs untuk membagikan yang telah Anda buat!

Membersihkan project [disarankan]

Perhatian: Codelab Level 2, yaitu Membuat Action untuk Asisten Google menggunakan Action Builder (Level 2), dibuat dengan project yang Anda buat dalam codelab ini. Jika Anda berencana melakukan codelab Level 2, jangan hapus project Anda; sebagai gantinya, Anda dapat menghapusnya di bagian "Membersihkan project Anda" di bagian akhir codelab Level 2.

Untuk menghindari biaya yang mungkin dikenakan, sebaiknya hapus project yang tidak ingin Anda gunakan. Untuk menghapus project yang Anda buat di codelab ini, ikuti langkah-langkah berikut:

1. Untuk menghapus Project Cloud dan resource, selesaikan langkah-langkah yang tercantum di bagian Shutting down (deleting) projects.

Perhatian: Pastikan Anda memilih project yang benar untuk dihapus di halaman Setelan Google Cloud Platform.

2. Opsional: Untuk segera menghapus project Anda dari Konsol Actions, selesaikan langkah-langkah yang tercantum di bagian Deleting a project. Jika Anda tidak menyelesaikan langkah ini, project Anda akan dihapus secara otomatis setelah sekitar 30 hari.

Survei masukan

Sebelum pergi, isi survei singkat tentang pengalaman Anda.