Bagikan melalui

Konsep dan definisi 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.

Artikel ini berfungsi sebagai referensi untuk konsep dan definisi untuk aplikasi Perintah Kustom.

Konfigurasi perintah

Perintah adalah blok penyusun dasar aplikasi Perintah Kustom. Perintah adalah sekumpulan konfigurasi yang diperlukan untuk menyelesaikan tugas tertentu yang ditentukan oleh pengguna.

Contoh kalimat

Contoh ungkapan adalah contoh yang ditetapkan yang dapat dikatakan pengguna untuk memicu perintah tertentu. Anda hanya perlu memberikan sampel ungkapan dan bukan daftar lengkap.

Parameter

Parameter adalah informasi yang diperlukan oleh perintah untuk menyelesaikan tugas. Dalam skenario kompleks, parameter dapat digunakan untuk menentukan kondisi yang memicu tindakan kustom.

Aturan penyelesaian

Aturan penyelesaian adalah serangkaian aturan yang akan dijalankan setelah perintah siap untuk dipenuhi, misalnya, ketika semua kondisi aturan terpenuhi.

Aturan interaksi

Aturan interaksi adalah aturan tambahan untuk menangani situasi yang lebih spesifik atau kompleks. Anda dapat menambahkan lebih banyak validasi atau mengonfigurasi fitur lanjutan seperti konfirmasi atau koreksi satu langkah. Anda juga dapat membuat aturan interaksi kustom Anda sendiri.

Konfigurasi parameter

Parameter adalah informasi yang diperlukan oleh perintah untuk menyelesaikan tugas. Dalam skenario kompleks, parameter dapat digunakan untuk menentukan kondisi yang memicu tindakan kustom.

Nama

Parameter diidentifikasi dengan properti nama. Anda harus selalu memberikan nama deskriptif ke parameter. Parameter dapat dirujuk di berbagai bagian, misalnya, saat Anda membuat persyaratan respons ucapan, atau tindakan lainnya.

Wajib

Kotak centang ini menunjukkan apakah nilai untuk parameter ini diperlukan untuk pemenuhan atau penyelesaian perintah. Anda harus mengonfigurasikan respons untuk meminta pengguna memberikan nilai jika parameter ditandai sebagaimana diperlukan.

Jika Anda mengonfigurasi parameter yang diperlukan untuk memiliki nilai Default, sistem masih meminta nilai parameter.

Jenis

Perintah Kustom mendukung jenis parameter berikut:

  • Usia
  • Mata uang
  • DateTime
  • Dimensi
  • email
  • Geografi
  • Angka
  • Urut
  • Persentase
  • PersonName
  • PhoneNumber
  • String
  • Suhu
  • URL

Setiap lokal mendukung jenis parameter "String", namun ketersediaan semua jenis lainnya berbeda menurut lokal. Perintah Kustom menggunakan resolusi entitas LUIS yang dibangun sebelumnya, sehingga ketersediaan jenis parameter di lokal tergantung pada dukungan entitas LUIS yang dibangun sebelumnya di lokal tersebut. Anda dapat menemukan detail lebih lanjut tentang dukungan entitas LUIS yang dibangun sebelumnya per lokal. Entitas LUIS kustom (seperti entitas yang dipelajari mesin) saat ini tidak didukung.

Beberapa tipe parameter seperti Number, String dan DateTime mendukung konfigurasi nilai default, yang dapat dikonfigurasi dari portal.

Konfigurasi

Konfigurasi adalah properti parameter yang hanya didefinisikan untuk tipe Untai. Nilai berikut ini didukung:

  • Tidak ada.
  • Terima input lengkap: Saat diaktifkan, parameter akan menerima ucapan input apa pun. Opsi ini berguna ketika pengguna membutuhkan parameter dengan ucapan penuh. Contohnya adalah alamat pos.
  • Menerima nilai input yang telah ditentukan sebelumnya dari katalog eksternal: Nilai ini digunakan untuk mengonfigurasikan parameter yang dapat mengasumsikan berbagai nilai. Contohnya adalah katalog penjualan. Dalam hal ini, katalog dihosting di titik akhir web eksternal dan dapat dikonfigurasikan secara independen.
  • Menerima nilai input yang telah ditentukan sebelumnya dari katalog eksternal: Nilai ini digunakan untuk mengonfigurasikan parameter yang dapat mengasumsikan berbagai nilai. Dalam hal ini, nilai harus dikonfigurasikan di Speech Studio.

Validasi

Validasi adalah konstruksi yang berlaku untuk jenis parameter tertentu yang memungkinkan Anda mengonfigurasikan batasan pada nilai parameter. Saat ini, Perintah Kustom mendukung validasi pada jenis parameter berikut:

  • DateTime
  • Angka

Konfigurasi aturan

Aturan dalam Perintah Kustom ditentukan oleh serangkaian kondisi yang saat terpenuhi, menjalankan serangkaian tindakan. Aturan juga memungkinkan Anda mengonfigurasikan status pasca-eksekusi dan harapan untuk giliran berikutnya.

Jenis

Perintah Kustom mendukung kategori aturan berikut ini:

  • Aturan penyelesaian: Aturan ini harus dijalankan setelah pemenuhan perintah. Semua aturan yang dikonfigurasikan di bagian ini yang kondisinya benar akan dijalankan.
  • Aturan interaksi: Aturan ini dapat digunakan untuk mengonfigurasi validasi kustom tambahan, konfirmasi, dan koreksi satu langkah, atau untuk menyelesaikan logika dialog kustom lainnya. Aturan interaksi dievaluasi pada setiap giliran dalam pemrosesan dan dapat digunakan untuk memicu aturan penyelesaian.

Berbagai tindakan yang dikonfigurasikan sebagai bagian dari aturan dijalankan dalam urutan munculnya mereka di portal penulisan.

Kondisi

Kondisi adalah persyaratan yang harus dipenuhi agar aturan dijalankan. Kondisi aturan bisa dari jenis berikut:

  • Nilai parameter sama:Nilai parameter yang dikonfigurasikan sama dengan nilai tertentu.
  • Tidak ada nilai parameter:Parameter yang dikonfigurasi seharusnya tidak memiliki nilai apa pun.
  • Parameter yang diperlukan:Parameter yang dikonfigurasikan memiliki nilai.
  • Semua parameter yang diperlukan: Semua parameter yang ditandai sebagaimana diperlukan memiliki nilai.
  • Parameter yang diperbarui: Satu atau beberapa nilai parameter diperbarui sebagai hasil dari pemrosesan input saat ini (ucapan atau aktivitas).
  • Konfirmasi berhasil: Ucapan atau aktivitas input adalah konfirmasi yang berhasil (ya).
  • Konfirmasi ditolak: Ucapan atau aktivitas input bukan konfirmasi yang berhasil (tidak).
  • Perintah sebelumnya perlu diperbarui:Kondisi ini digunakan dalam contoh ketika Anda ingin menangkap konfirmasi yang dinegasikan bersama dengan pembaruan. Di balik layar, kondisi ini dikonfigurasi ketika mesin dialog mendeteksi konfirmasi negatif yang niatnya sama dengan giliran sebelumnya, dan pengguna telah merespons dengan pembaruan.

Tindakan

  • Kirim respons ucapan: Kirim respons ucapan kembali ke klien.
  • Memperbarui nilai parameter: Perbarui nilai parameter perintah ke nilai yang ditentukan.
  • Menghapus nilai parameter: Hapus nilai parameter perintah.
  • Panggilan titik akhir web: Melakukan panggilan ke titik akhir web.
  • Mengirim aktivitas ke klien:Kirim aktivitas kustom ke klien.

Ekspektasi

Ekspektasi digunakan untuk mengonfigurasikan petunjuk untuk pemrosesan input pengguna berikutnya. Jenis file berikut ini didukung:

  • Konfirmasi yang diharapkan dari pengguna: Harapan ini menentukan bahwa aplikasi mengharapkan konfirmasi (ya/tidak) untuk input pengguna berikutnya.
  • Mengharapkan parameter dari pengguna: Harapan ini menentukan satu atau lebih parameter perintah yang diharapkan aplikasi dari input pengguna.

Status pasca-eksekusi

Status pasca eksekusi adalah status dialog setelah memproses input saat ini (ucapan atau aktivitas). Ini dari jenis berikut:

  • Pertahankan status saat ini: Pertahankan status saat ini saja.
  • Selesaikan perintah: Selesaikan perintah dan tidak ada lagi aturan perintah yang diproses.
  • Jalankan aturan penyelesaian: Jalankan semua aturan penyelesaian yang valid.
  • Tunggu masukan pengguna: Tunggu input pengguna berikutnya.

Langkah berikutnya

Lihat contoh di GitHub