Share via

Mengembangkan aplikasi Perintah Kustom

  • Artikel

Penting

Perintah Kustom akan dihentikan pada 30 April 2026. Mulai 30 Oktober 2023 Anda tidak dapat membuat aplikasi Perintah Kustom baru di Speech Studio. Terkait perubahan ini, LUIS akan dihentikan pada 1 Oktober 2025. Mulai 1 April 2023 Anda tidak dapat membuat sumber daya LUIS baru.

Dalam artikel cara ini, Anda mempelajari cara mengembangkan dan mengonfigurasi aplikasi Perintah Kustom. Fitur Perintah Kustom membantu Anda membangun aplikasi perintah suara kaya yang dioptimalkan untuk pengalaman interaksi voice-first. Fitur ini paling cocok untuk penyelesaian tugas atau skenario perintah dan kontrol. Ini sangat cocok untuk perangkat Internet of Things (IoT) dan untuk perangkat sekitar dan tanpa kepala.

Dalam artikel ini, Anda membuat aplikasi yang dapat menyalakan dan mematikan TV, mengatur suhu, dan mengatur alarm. Setelah membuat perintah dasar ini, Anda akan mempelajari tentang opsi berikut untuk mengkustomisasi perintah:

  • Menambahkan parameter ke perintah
  • Menambahkan konfigurasi ke parameter perintah
  • Membangun aturan interaksi
  • Membuat templat pembuatan bahasa untuk respons ucapan
  • Menggunakan alat suara kustom

Membuat aplikasi dengan menggunakan perintah sederhana

Mulailah dengan membuat aplikasi Perintah Kustom yang kosong. Untuk detailnya, lihat mulai cepat. Dalam aplikasi ini, alih-alih mengimpor proyek, Anda membuat proyek kosong.

  1. Dalam kotak Nama, masukkan nama proyek Smart-Room-Lite (atau nama lain pilihan Anda).

  2. Dalam daftar Bahasa, pilih Bahasa Inggris (Amerika Serikat).

  3. Pilih atau buat sumber daya LUIS.

    Screenshot showing the

Memperbarui sumber daya LUIS (opsional)

Anda dapat memperbarui sumber daya penulisan yang Anda pilih di jendela Proyek baru. Anda juga dapat mengatur sumber daya prediksi.

Sumber daya prediksi digunakan untuk pengenalan saat aplikasi Perintah Kustom Anda diterbitkan. Anda tidak memerlukan sumber daya prediksi selama fase pengembangan dan pengujian.

Menambahkan perintah TurnOn

Di aplikasi Perintah Kustom Smart-Room-Lite kosong yang Anda buat, tambahkan perintah. Perintah memproses ucapan, Turn on the tv. Ini merespons dengan pesan Ok, turning the tv on.

  1. Buat perintah baru dengan memilih perintah Baru di bagian atas panel kiri. Jendela perintah Baru terbuka.
  2. Untuk bidang Nama, berikan nilai TurnOn.
  3. Pilih Buat.

Panel tengah mencantumkan properti perintah.

Tabel berikut ini menjelaskan properti konfigurasi perintah. Untuk informasi selengkapnya, lihat Konsep dan definisi Perintah Kustom.

Konfigurasi Deskripsi
Contoh kalimat Contoh ucapan yang dapat dikatakan pengguna untuk memicu perintah ini.
Parameter Informasi yang diperlukan untuk menyelesaikan perintah.
Aturan penyelesaian Tindakan yang harus diambil untuk memenuhi perintah. Contoh: menanggapi pengguna atau berkomunikasi dengan layanan web.
Aturan interaksi Aturan lain untuk menangani situasi yang lebih spesifik atau kompleks.

Screenshot showing where to create a command.

Menambahkan contoh kalimat

Di bagian Contoh kalimat, Anda memberikan contoh apa yang bisa dikatakan pengguna.

  1. Di panel tengah, pilih Contoh kalimat.

  2. Di panel di sebelah kanan, tambahkan contoh:

    Turn on the tv

  3. Di bagian atas halaman, pilih Simpan.

Anda belum memiliki parameter, sehingga Anda dapat berpindah ke bagian Aturan penyelesaian.

Menambahkan aturan penyelesaian

Selanjutnya, perintah membutuhkan aturan penyelesaian. Aturan ini memberi tahu pengguna bahwa tindakan pemenuhan sedang diambil.

Untuk informasi selengkapnya tentang aturan dan aturan penyelesaian, lihat Konsep dan definisi Perintah Kustom.

  1. Pilih aturan penyelesaian default Selesai. Kemudian edit sebagai berikut:

    Pengaturan Nilai yang disarankan Deskripsi
    Nama ConfirmationResponse Nama yang menjelaskan tujuan aturan
    Kondisi Tidak Kondisi yang menentukan waktu aturan dapat berjalan
    Tindakan Kirim tanggapan ucapan>Penyunting sederhana>Ok, turning the tv on Tindakan yang harus diambil ketika kondisi aturan benar

    Screenshot showing where to create a speech response.

  2. Pilih Simpan untuk menyimpan tindakan.

  3. Kembali di bagian Aturan penyelesaian, pilih Simpan untuk menyimpan semua perubahan.

    Catatan

    Anda tidak perlu menggunakan aturan penyelesaian default yang memiliki perintah. Anda dapat menghapus aturan penyelesaian default dan menambahkan aturan Anda sendiri.

Menambahkan perintah SetTemperature

Sekarang tambahkan satu perintah lagi, SetTemperature. Perintah ini mengambil satu ucapan, Set the temperature to 40 degrees, dan merespons dengan pesan Ok, setting temperature to 40 degrees.

Untuk membuat perintah baru, ikuti langkah-langkah yang Anda gunakan untuk TurnOn perintah tersebut, tapi gunakan contoh kalimat Set the temperature to 40 degrees.

Lalu edit aturan penyelesaian Selesai yang ada sebagai berikut:

Pengaturan Nilai yang disarankan
Nama ConfirmationResponse
Kondisi Tidak
Tindakan Mengirim respons ucapan>Editor sederhana>Variasi pertama>Ok, setting temperature to 40 degrees

Pilih Simpan untuk menyimpan semua perubahan ke perintah.

Menambahkan perintah SetAlarm

Buat perintah baru SetAlarm. Gunakan contoh kalimat Set an alarm for 9 am tomorrow. Lalu edit aturan penyelesaian Selesai yang ada sebagai berikut:

Pengaturan Nilai yang disarankan
Nama ConfirmationResponse
Kondisi Tidak
Tindakan Mengirim respons ucapan>Editor sederhana>Variasi pertama>Ok, setting an alarm for 9 am tomorrow

Pilih Simpan untuk menyimpan semua perubahan ke perintah.

Cobalah

Uji perilaku aplikasi dengan menggunakan panel uji:

  1. Di sudut kanan atas panel, pilih ikon Kereta.
  2. Ketika pelatihan selesai, pilih Uji.

Cobalah contoh ucapan berikut dengan menggunakan suara atau teks:

  • Anda mengetik: atur suhu ke 40 derajat
  • Respon yang diharapkan: Ok, pengaturan suhu ke 40 derajat
  • Anda mengetik: nyalakan tv
  • Respons yang diharapkan: Ok, menyalakan tv
  • Anda mengetik: mengatur alarm untuk jam 9 pagi besok
  • Respon yang diharapkan: Ok, mengatur alarm untuk jam 9 pagi besok

Screenshot showing the test in a web-chat interface.

Tip

Di panel uji, Anda bisa memilih Putar detail untuk informasi tentang bagaimana input suara atau input teks ini diproses.

Menambahkan parameter ke perintah

Di bagian ini, Anda mempelajari cara menambahkan parameter ke perintah Anda. Perintah memerlukan parameter untuk menyelesaikan tugas. Dalam skenario kompleks, parameter dapat digunakan untuk menentukan kondisi yang memicu tindakan kustom.

Mengonfigurasi parameter untuk perintah TurnOn

Mulailah dengan mengedit perintah TurnOn yang ada untuk mengaktifkan dan menonaktifkan beberapa perangkat.

  1. Sekarang setelah perintah menangani skenario aktif dan nonaktif, ganti nama perintah sebagai TurnOnOff.

    1. Di panel di sebelah kiri, pilih perintah TurnOn. Kemudian di samping Perintah baru di bagian atas panel, pilih tombol edit.

    2. Di jendela perintah Rename, ubah nama menjadi TurnOnOff.

  2. Tambahkan parameter baru ke perintah. Parameter menunjukkan apakah pengguna ingin mengaktifkan atau menonaktifkan perangkat.

    1. Di bagian atas panel tengah, pilih Tambahkan. Dari menu drop-down, pilih Parameter.

    2. Di panel di sebelah kanan, di bagian Parameter, dalam kotak Nama, tambahkan OnOff.

    3. Pilih Diperlukan. Di jendela Tambahkan respons untuk parameter yang diperlukan, pilih Editor sederhana. Di bidang Variasi pertama, tambahkan Aktif atau Nonaktif.

    4. Pilih Perbarui.

      Screenshot that shows the 'Add response for a required parameter' section with the 'Simple editor' tab selected.

    5. Konfigurasikan properti parameter dengan menggunakan tabel berikut. Untuk informasi tentang semua properti konfigurasi perintah, lihat Konsep dan definisi Perintah Kustom.

      Konfigurasi Nilai yang disarankan Deskripsi
      Nama OnOff Nama deskriptif untuk parameter
      Diperlukan Dipilih Kotak centang menunjukkan apakah nilai untuk parameter ini diperlukan sebelum perintah selesai.
      Respons untuk parameter yang diperlukan Editor sederhana>On or Off? Perintah yang meminta nilai parameter ini saat tidak diketahui.
      Jenis String Jenis parameter, seperti Angka, String, Tanggal Waktu, atau Geografi.
      Konfigurasi Menerima nilai input yang sudah ditentukan sebelumnya dari katalog internal Untuk string, pengaturan ini membatasi input ke sekumpulan nilai yang mungkin.
      Nilai input yang sudah ditentukan sebelumnya on, off Sekumpulan nilai yang mungkin dan aliasnya.

    6. Untuk menambahkan nilai input yang sudah ditentukan sebelumnya, pilih Tambahkan input yang sudah ditentukan sebelumnya. Di jendela Item Baru, ketik Nama seperti yang ditampilkan dalam tabel sebelumnya. Dalam hal ini, Anda tidak menggunakan alias, sehingga Anda dapat membiarkan bidang ini kosong.

      Screenshot showing how to create a parameter.

    7. Pilih Simpan untuk menyimpan semua konfigurasi parameter.

Menambahkan parameter SubjectDevice

  1. Untuk menambahkan parameter kedua untuk mewakili nama perangkat yang dapat dikontrol dengan menggunakan perintah ini, pilih Tambahkan. Gunakan pengaturan konfigurasi berikut.

    Pengaturan Nilai yang disarankan
    Nama SubjectDevice
    Diperlukan Dipilih
    Respons untuk parameter yang diperlukan Editor sederhana>Which device do you want to control?
    Jenis String
    Konfigurasi Menerima nilai input yang sudah ditentukan sebelumnya dari katalog internal
    Nilai input yang sudah ditentukan sebelumnya tv, fan
    Alias (tv) television, telly

  2. Pilih Simpan.

Menambahkan contoh kalimat

Untuk perintah yang menggunakan parameter, sangat berguna untuk menambahkan contoh kalimat yang mencakup semua kombinasi yang mungkin. Misalnya:

  • Informasi parameter lengkap: turn {OnOff} the {SubjectDevice}
  • Informasi parameter parsial: turn it {OnOff}
  • Tidak Ada Informasi parameter: turn something

Contoh kalimat yang menggunakan berbagai tingkat informasi memungkinkan aplikasi Perintah Kustom untuk menyelesaikan resolusi satu bidikan dan resolusi beberapa giliran dengan menggunakan informasi parsial.

Dengan diingat informasi tersebut, edit contoh kalimat untuk menggunakan parameter yang disarankan ini:

turn {OnOff} the {SubjectDevice}
{SubjectDevice} {OnOff}
turn it {OnOff}
turn something {OnOff}
turn something

Pilih Simpan.

Tip

Di editor contoh kalimat, gunakan kurung kurawal untuk merujuk ke parameter Anda. Contohnya, turn {OnOff} the {SubjectDevice}. Gunakan tab untuk penyelesaian otomatis yang didukung oleh parameter yang dibuat sebelumnya.

Mengubah aturan penyelesaian untuk menyertakan parameter

Mengubah aturan penyelesaian yang ada ConfirmationResponse.

  1. Di bagian Kondisi, pilih Tambahkan kondisi.

  2. Di jendela Kondisi Baru, di daftar Jenis, pilih Parameter yang diperlukan. Dalam daftar yang berikut, pilih OnOff dan SubjectDevice.

  3. Pilih Buat.

  4. Di bagian Tindakan, edit tindakan Kirim respons ucapan dengan mengarahkan kursor ke atasnya dan memilih tombol edit. Kali ini, gunakan parameter OnOff dan SubjectDevice yang baru dibuat:

    Ok, turning the {SubjectDevice} {OnOff}

  5. Pilih Simpan.

Cobalah perubahan dengan memilih ikon Kereta di bagian atas panel di sebelah kanan.

Ketika pelatihan selesai, pilih Uji. Jendela Uji aplikasi Anda muncul. Cobalah interaksi berikut:

  • Input: matikan tv
  • Output: Ok, matikan tv
  • Input: matikan televisi
  • Output: Ok, matikan tv
  • Input: matikan
  • Output: Perangkat mana yang ingin Anda kontrol?
  • Input: tv
  • Output: Ok, matikan tv

Mengonfigurasi parameter untuk perintah SetTemperature

Ubah perintah SetTemperature untuk mengaktifkannya untuk mengatur suhu sebagai pengguna mengarahkan.

Tambahkan parameter TemperatureValue. Gunakan pengaturan konfigurasi berikut:

Konfigurasi Nilai yang disarankan
Nama TemperatureValue
Diperlukan Dipilih
Respons untuk parameter yang diperlukan Editor sederhana>What temperature would you like?
Jenis Number

Edit contoh ucapan untuk menggunakan nilai berikut.

set the temperature to {TemperatureValue} degrees
change the temperature to {TemperatureValue}
set the temperature
change the temperature

Mengubah aturan penyelesaian yang ada. Gunakan pengaturan konfigurasi berikut.

Konfigurasi Nilai yang disarankan
Kondisi Parameter yang diperlukan>TemperatureValue
Tindakan Mengirim respons ucapan>Ok, setting temperature to {TemperatureValue} degrees

Mengonfigurasi parameter untuk perintah SetAlarm

Tambahkan parameter yang disebut DateTime. Gunakan pengaturan konfigurasi berikut.

Pengaturan Nilai yang disarankan
Nama DateTime
Diperlukan Dipilih
Respons untuk parameter yang diperlukan Editor sederhana>For what time?
Jenis DateTime
Tanggal Default Jika tanggal hilang, gunakan hari ini.
Waktu Default Jika waktunya hilang, gunakan awal hari.

Catatan

Artikel ini sebagian besar menggunakan jenis parameter String, Angka, dan TanggalWaktu. Untuk daftar semua tipe parameter yang didukung dan propertinya, lihat Konsep dan definisi Perintah Kustom.

Edit contoh ucapan. Gunakan nilai-nilai berikut.

set an alarm for {DateTime}
set alarm {DateTime}
alarm for {DateTime}

Mengubah aturan penyelesaian yang ada. Gunakan pengaturan konfigurasi berikut.

Pengaturan Nilai yang disarankan
Tindakan Mengirim respons ucapan>Ok, alarm set for {DateTime}

Uji tiga perintah bersama dengan menggunakan ucapan yang terkait dengan perintah yang berbeda. (Anda dapat beralih di antara perintah yang berbeda.)

  • Input: Mengatur alarm
  • Output: Untuk jam berapa?
  • Input: Nyalakan tv
  • Output: Ok, menyalakan tv
  • Input: Mengatur alarm
  • Output: Untuk jam berapa?
  • Masukan: 5 sore
  • Output: Ok, alarm diatur untuk 2020-05-01 17:00:00

Menambahkan konfigurasi ke parameter perintah

Di bagian ini, Anda mempelajari selengkapnya tentang konfigurasi parameter tingkat lanjut, termasuk:

  • Bagaimana nilai parameter dapat termasuk dalam set yang ditentukan di luar aplikasi Perintah Kustom.
  • Cara menambahkan klausa validasi pada nilai parameter.

Mengonfigurasi parameter sebagai entitas katalog eksternal

Fitur Perintah Kustom memungkinkan Anda mengonfigurasi parameter jenis string untuk merujuk ke katalog eksternal yang dihosting melalui titik akhir web. Jadi Anda dapat memperbarui katalog eksternal secara independen tanpa mengedit aplikasi Perintah Kustom. Pendekatan ini berguna dalam kasus banyaknya entri katalog.

Gunakan kembali parameter SubjectDevice dari perintah TurnOnOff. Konfigurasi saat ini untuk parameter ini adalah Terima input yang telah ditentukan sebelumnya dari katalog internal. Konfigurasi ini mengacu pada daftar statik perangkat dalam konfigurasi parameter. Pindahkan konten ini ke sumber data eksternal yang dapat diperbarui secara independen.

Untuk memindahkan konten, mulailah dengan menambahkan titik akhir web baru. Di panel di sebelah kiri, masuk ke bagian Titik akhir Web. Tambahkan URL titik akhir web baru. Gunakan pengaturan konfigurasi berikut.

Pengaturan Nilai yang disarankan
Nama getDevices
URL <Your endpoint of getDevices.json>
Metode DAPATKAN

Kemudian, konfigurasi dan hosting titik akhir web yang mengembalikan file JSON yang mencantumkan perangkat yang dapat dikontrol. Titik akhir web harus mengembalikan file JSON yang diformat seperti contoh ini:

{
    "fan" : [],
    "refrigerator" : [
        "fridge"
    ],
    "lights" : [
        "bulb",
        "bulbs",
        "light",
        "light bulb"
    ],
    "tv" : [
        "telly",
        "television"
        ]
}

Selanjutnya buka halaman Pengaturan parameter SubjectDevice. Atur properti berikut ini.

Pengaturan Nilai yang disarankan
Konfigurasi Menerima input yang sudah ditentukan sebelumnya dari katalog eksternal
Titik akhir katalog getDevices
Metode DAPATKAN

Kemudian pilih Simpan.

Penting

Anda tidak akan melihat opsi untuk mengonfigurasi parameter untuk menerima input dari katalog eksternal kecuali Anda memiliki set titik akhir web di bagian Titik akhir web di panel di sebelah kiri.

Cobalah dengan memilih Kereta Api. Setelah pelatihan selesai, pilih Uji dan coba beberapa interaksi.

  • Input: aktifkan
  • Output: Perangkat mana yang ingin Anda kontrol?
  • Masukan: lampu
  • Output: Ok, menyalakan lampu

Catatan

Anda sekarang dapat mengontrol semua perangkat yang dihosting di titik akhir web. Tetapi Anda masih perlu melatih aplikasi untuk menguji perubahan baru dan kemudian menerbitkan ulang aplikasi.

Menambahkan validasi ke parameter

Validasi adalah konstruksi yang berlaku untuk jenis parameter tertentu yang memungkinkan Anda mengonfigurasi batasan pada nilai parameter. Mereka meminta Anda untuk koreksi jika nilai tidak termasuk dalam batasan. Untuk daftar jenis parameter yang memperluas konstruksi validasi, lihat Konsep dan definisi Perintah Kustom.

Uji validasi dengan menggunakan perintah SetTemperature. Gunakan langkah-langkah berikut untuk menambahkan validasi untuk Temperature parameter.

  1. Di panel di sebelah kiri, pilih perintah SetTemperature.

  2. Di panel tengah, pilih Suhu.

  3. Di panel sebelah kanan, pilih Tambahkan Validasi.

  4. Di jendela validasi baru, konfigurasikan validasi seperti yang diperlihatkan dalam tabel berikut ini. Lalu pilih Buat.

    Konfigurasi Parameter Nilai yang disarankan Deskripsi
    Nilai minimum 60 Untuk parameter Angka, nilai minimum parameter ini dapat diperkirakan
    Nilai Maksimum 80 Untuk parameter Angka, nilai maksimum parameter ini dapat diperkirakan
    Respons kegagalan Editor sederhana>Variasi pertama>Sorry, I can only set temperature between 60 and 80 degrees. What temperature do you want? Perintah untuk meminta nilai baru jika validasi gagal

    Screenshot showing how to add a range validation.

Cobalah dengan memilih ikon Kereta di bagian atas panel di sebelah kanan. Ketika pelatihan selesai, pilih Uji. Cobalah beberapa interaksi:

  • Input: atur suhu ke 72 derajat
  • Output: Ok, mengatur suhu ke 72 derajat
  • Input: atur suhu ke 45 derajat
  • Output: Maaf, saya hanya dapat mengatur suhu antara 60 derajat dan 80 derajat
  • Input: jadikan 72 derajat sebagai gantinya
  • Output: Ok, mengatur suhu ke 72 derajat

Tambahkan aturan interaksi

Aturan interaksi adalah aturan tambahan yang menangani situasi tertentu atau kompleks. Meskipun Anda bebas untuk menulis aturan interaksi Anda sendiri, dalam contoh ini Anda menggunakan aturan interaksi untuk skenario berikut:

  • Mengonfirmasi perintah
  • Menambahkan koreksi satu langkah ke perintah

Untuk informasi selengkapnya tentang aturan interaksi, lihat Konsep dan definisi Perintah Kustom.

Menambahkan konfirmasi ke perintah

Untuk menambahkan konfirmasi, Anda menggunakan perintah SetTemperature. Untuk mencapai konfirmasi, buat aturan interaksi dengan menggunakan langkah-langkah berikut:

  1. Di panel di sebelah kiri, pilih perintah SetTemperature.

  2. Di panel tengah, tambahkan aturan interaksi dengan memilih Tambahkan. Lalu pilih Aturan interaksi>Konfirmasi perintah.

    Tindakan ini menambahkan tiga aturan interaksi. Aturan meminta pengguna untuk mengonfirmasi tanggal dan waktu alarm. Mereka mengharapkan konfirmasi (ya atau tidak) untuk giliran berikutnya.

    1. Ubah aturan interaksi Konfirmasi perintah dengan menggunakan konfigurasi berikut ini:

      1. Ubah nama menjadi Konfirmasi suhu.
      2. Kondisi Semua parameter yang diperlukan sudah diatur.
      3. Tambahkan tindakan baru: Ketik>Kirim respons>ucapan Apakah Anda yakin ingin mengatur suhu sebagai {TemperatureValue} derajat?
      4. Di bagian Harapan, tinggalkan nilai default Mengharapkan konfirmasi dari pengguna.

      Screenshot showing how to create the required parameter response.

    2. Ubah aturan interaksi konfirmasi berhasil untuk menangani konfirmasi yang berhasil (pengguna mengatakan ya).

      1. Ubah nama menjadi Konfirmasi suhu berhasil.
      2. Biarkan kondisi Konfirmasi berhasil yang ada.
      3. Tambahkan kondisi baru: Ketik>Parameter yang diperlukan>TemperatureValue.
      4. Biarkan nilai default status pasca eksekusi sebagai Aturan penyelesaian eksekusi.

    3. Ubah aturan interaksi Konfirmasi yang ditolak untuk menangani skenario ketika konfirmasi ditolak (lalu pengguna mengatakan tidak).

      1. Ubah nama menjadi Konfirmasi suhu ditolak.
      2. Biarkan kondisi Konfirmasi ditolak yang ada.
      3. Tambahkan kondisi baru: Ketik>Parameter yang diperlukan>TemperatureValue.
      4. Menambahkan tindakan baru: Ketik>Kirim respons ucapan>Tidak masalah. Lalu berapa suhunya?.
      5. Ubah nilai default Status pasca eksekusi menjadi Tunggu input pengguna.

Penting

Dalam artikel ini, Anda menggunakan kemampuan konfirmasi bawaan. Anda juga dapat menambahkan aturan interaksi secara manual satu per satu.

Cobalah perubahan dengan memilih Latih. Ketika pelatihan selesai, pilih Uji.

  • Input: Atur suhu ke 80 derajat
  • Output: apakah Anda yakin ingin mengatur suhu sebagai 80 derajat?
  • Input: Tidak
  • Output: Tidak masalah. Lalu, berapa suhunya?
  • Input: 72 derajat
  • Output: apakah Anda yakin ingin mengatur suhu sebagai 72 derajat?
  • Input: Ya
  • Output: Ok, mengatur suhu ke 72 derajat

Menerapkan koreksi dalam perintah

Di bagian ini, Anda mengonfigurasi koreksi satu langkah. Koreksi ini digunakan setelah tindakan pemenuhan berjalan. Anda juga akan melihat contoh bagaimana koreksi diaktifkan secara default jika perintah belum terpenuhi. Untuk menambahkan koreksi saat perintah belum selesai, tambahkan parameter baru AlarmTone.

Di panel kiri, pilih perintah SetAlarm. Kemudian dan tambahkan parameter baru AlarmTone.

  • Nama>AlarmTone
  • Ketik>String
  • Nilai Default>Lonceng
  • Konfigurasi>Menerima nilai input yang sudah ditentukan sebelumnya dari katalog internal
  • Nilai input yang sudah ditentukan sebelumnya>Lonceng, Jingle, dan Echo (Nilai-nilai ini adalah input individual yang telah ditentukan sebelumnya.)

Selanjutnya, perbarui respons untuk parameter DateTime ke Siap mengatur alarm dengan nada sebagai {AlarmTone}. Untuk jam berapa?. Kemudian ubah aturan penyelesaian sebagai berikut:

  1. Pilih aturan penyelesaian yang ada ConfirmationResponse.
  2. Di panel di sebelah kanan, arahkan mouse ke atas tindakan yang sudah ada dan pilih Edit.
  3. Perbarui respons ucapan ke OK, alarm set for {DateTime}. The alarm tone is {AlarmTone}.

Penting

Nada alarm dapat berubah tanpa konfigurasi eksplisit dalam perintah yang sedang berlangsung. Misalnya, dapat berubah ketika perintah belum selesai. Koreksi diaktifkan secara default untuk semua parameter perintah, terlepas dari nomor belokan, jika perintah belum terpenuhi.

Menerapkan koreksi ketika perintah selesai

Platform Perintah Kustom memungkinkan koreksi satu langkah bahkan ketika perintah selesai. Fitur ini tidak diaktifkan secara default. Ini harus dikonfigurasi secara eksplisit.

Gunakan langkah-langkah berikut untuk mengonfigurasi koreksi satu langkah:

  1. Di perintah SetAlarm, tambahkan aturan interaksi dari jenis Perbarui perintah sebelumnya untuk memperbarui alarm yang ditetapkan sebelumnya. Ganti nama aturan interaksi sebagai Perbarui alarm sebelumnya.
  2. Tinggalkan kondisi default: Perintah sebelumnya perlu diperbarui.
  3. Tambahkan kondisi baru: Ketik>Parameter yang diperlukan>Tanggal Waktu.
  4. Menambahkan tindakan baru: Ketik>Kirim respons ucapan>Editor sederhana> Memperbarui waktu alarm sebelumnya ke {DateTime}.
  5. Biarkan nilai default Status pasca eksekusi sebagai Perintah selesai.

Cobalah perubahan dengan memilih Latih. Tunggu hingga pelatihan selesai, lalu pilih Uji.

  • Input: Mengatur alarm.
  • Output: Siap untuk mengatur alarm dengan nada Chimes. Untuk jam berapa?
  • Input: Atur alarm dengan nada sebagai Jingle untuk jam 9 pagi besok.
  • Output: OK, alarm diatur untuk 2020-05-21 09:00:00. Nada alarmnya adalah Jingle.
  • Input: Tidak, jam 8 pagi.
  • Output: Memperbarui waktu alarm sebelumnya ke 2020-05-29 08:00.

Catatan

Dalam aplikasi nyata, di bagian Tindakan dari aturan koreksi ini, Anda juga harus mengirim kembali aktivitas ke klien atau memanggil titik akhir HTTP untuk memperbarui waktu alarm di sistem Anda. Tindakan ini harus bertanggung jawab sepenuhnya untuk memperbarui waktu alarm. Seharusnya tidak bertanggung jawab atas atribut lain dari perintah. Dalam hal ini, atribut itu akan menjadi nada alarm.

Menambahkan templat pembuatan bahasa untuk respons ucapan

Templat pembuatan bahasa (LG) memungkinkan Anda untuk menyesuaikan respons yang dikirim ke klien. Mereka memperkenalkan varian ke dalam tanggapan. Anda dapat mencapai pembuatan bahasa dengan menggunakan:

  • Templat pembuatan bahasa.
  • Ekspresi adaptif.

Templat Perintah Kustom didasarkan pada templat LG Bot Framework. Karena fitur Perintah Kustom membuat template LG baru saat diperlukan (untuk respons ucapan dalam parameter atau tindakan), Anda tidak perlu menentukan nama templat LG.

Jadi Anda tidak perlu mendefinisikan templat Anda seperti ini:

   # CompletionAction
   - Ok, turning {OnOff} the {SubjectDevice}
   - Done, turning {OnOff} the {SubjectDevice}
   - Proceeding to turn {OnOff} {SubjectDevice}

Sebaliknya, Anda dapat menentukan badan templat tanpa nama, seperti ini:

Screenshot showing a template editor example.

Perubahan ini memperkenalkan variasi ke dalam respons ucapan yang dikirim ke klien. Untuk ucapan, respons ucapan yang sesuai dipilih secara acak dari opsi yang disediakan.

Dengan memanfaatkan template LG, Anda juga dapat menentukan respons ucapan yang kompleks untuk perintah dengan menggunakan ekspresi adaptif. Untuk informasi selengkapnya, lihat format templat LG.

Secara default, fitur Perintah Kustom mendukung semua kapabilitas, dengan perbedaan kecil berikut:

  • Dalam template LG, entitas diwakili sebagai ${entityName}. Fitur Perintah Kustom tidak menggunakan entitas. Tetapi Anda dapat menggunakan parameter sebagai variabel dengan representasi ${parameterName} atau representasi {parameterName}.
  • Fitur Perintah Kustom tidak mendukung komposisi dan ekspansi template, karena Anda tidak pernah mengedit file .lg secara langsung. Anda hanya mengedit respons templat yang dibuat secara otomatis.
  • Fitur Perintah Kustom tidak mendukung fungsi kustom yang disuntikkan LG. Fungsi yang sudah ditentukan sebelumnya didukung.
  • Fitur Perintah Kustom tidak mendukung opsi, seperti strict, replaceNull, dan lineBreakStyle.

Menambahkan respons templat ke perintah TurnOnOff

Ubah perintah TurnOnOff untuk menambahkan parameter baru. Gunakan pengaturan konfigurasi berikut.

Pengaturan Nilai yang disarankan
Nama SubjectContext
Diperlukan Tidak dipilih
Jenis String
Nilai default all
Konfigurasi Menerima nilai input yang sudah ditentukan sebelumnya dari katalog internal
Nilai input yang sudah ditentukan sebelumnya room, , bathroomall

Mengubah aturan penyelesaian

Edit bagian Tindakan dari aturan penyelesaian yang ada ConfirmationResponse. Di jendela Edit tindakan, beralihlah ke Editor Templat. Kemudian ganti teks dengan contoh berikut.

- IF: @{SubjectContext == "all" && SubjectDevice == "lights"}
    - Ok, turning all the lights {OnOff}
- ELSEIF: @{SubjectDevice == "lights"}
    - Ok, turning {OnOff} the {SubjectContext} {SubjectDevice}
- ELSE:
    - Ok, turning the {SubjectDevice} {OnOff}
    - Done, turning {OnOff} the {SubjectDevice}

Latih dan uji aplikasi Anda dengan menggunakan input dan output berikut. Perhatikan variasi respons. Variasi dibuat oleh beberapa alternatif dari nilai templat dan juga dengan menggunakan ekspresi adaptif.

  • Input: nyalakan tv
  • Output: Ok, menyalakan tv
  • Input: nyalakan tv
  • Output: Selesai, menyalakan tv
  • Input: matikan lampu
  • Output: Ok, mematikan semua lampu
  • Input: matikan lampu kamar
  • Output: Ok, matikan lampu kamar

Menggunakan suara kustom

Cara lain untuk menyesuaikan respons Custom Commands adalah dengan memilih suara output. Gunakan langkah-langkah berikut untuk mengalihkan suara default ke suara kustom:

  1. Di aplikasi Perintah Kustom Anda, di panel di sebelah kiri, pilih Pengaturan.
  2. Di panel tengah, pilih Suara kustom.
  3. Dalam tabel, pilih suara khusus atau suara publik.
  4. Pilih Simpan.

Screenshot showing sample sentences and parameters.

Catatan

Untuk suara publik, jenis saraf hanya tersedia untuk wilayah tertentu. Untuk informasi selengkapnya, lihat Wilayah yang didukung layanan ucapan.

Anda dapat membuat suara kustom di halaman Proyek suara kustom. Untuk informasi selengkapnya, lihat Mulai menggunakan suara kustom.

Sekarang aplikasi merespons dalam suara yang dipilih, bukan suara default.

Langkah berikutnya