Bagikan melalui

class Intent::IntentRecognizer

  • Artikel 
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

Selain melakukan pengenalan ucapan ke teks, IntentRecognizer mengekstrak informasi terstruktur tentang niat pembicara, yang dapat digunakan untuk mendorong tindakan lebih lanjut menggunakan pemicu niat khusus (lihat IntentTrigger).

Anggota

Properti

Sitnaksis: public PropertyCollection & Properties;

Kumpulan properti dan nilainya yang ditentukan untuk IntentRecognizer ini.

IntentRecognizer

Sitnaksis: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Konstruktor internal. Membuat instans baru menggunakan handel yang disediakan.

Parameter

  • hreco Handel recognizer.

~IntentRecognizer

Sitnaksis: public inline ~IntentRecognizer ( );

destruktor

RecognizeOnceAsync

Sitnaksis: public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

Memulai pengenalan niat, dan kembali setelah satu ucapan dikenali. Akhir dari ujaran tunggal ditentukan dengan mendengarkan keheningan di akhir atau sampai maksimal 15 detik audio diproses. Tugas mengembalikan teks pengenalan sebagai hasilnya. Catatan: Karena RecognizeOnceAsync() hanya mengembalikan satu ucapan, hanya cocok untuk pengenalan bidikan tunggal seperti perintah atau kueri. Untuk pengenalan multi-ucapan yang berjalan lama, gunakan StartContinuousRecognitionAsync() sebagai gantinya..

Mengembalikan

Di masa mendatang yang berisi nilai hasil (pointer bersama ke IntentRecognitionResult) dari pengenalan niat asinkron.

RecognizeOnceAsync

Sitnaksis: public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

Memulai pengenalan niat, dan menghasilkan hasil dari teks yang diteruskan. Ini berguna untuk pengujian dan di lain waktu ketika input ucapan tidak terikat dengan IntentRecognizer. Catatan: Layanan Niat saat ini tidak mendukung ini sehingga hanya berlaku untuk pencocokan pola offline atau niat pencocokan yang tepat.

Parameter

  • text Teks yang akan dievaluasi.

Mengembalikan

Di masa mendatang yang berisi nilai hasil (pointer bersama ke IntentRecognitionResult) dari pengenalan niat asinkron.

StartContinuousRecognitionAsync

Sitnaksis: public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

Secara asinkron memulai operasi pengenalan niat berkelanjutan.

Mengembalikan

Masa depan yang kosong.

StopContinuousRecognitionAsync

Sitnaksis: public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

Secara asinkron mengakhiri operasi pengenalan niat berkelanjutan yang sedang berlangsung.

Mengembalikan

Masa depan yang kosong.

StartKeywordRecognitionAsync

Sitnaksis: public inline virtual std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Secara asinkron memulai operasi pengenalan kata kunci.

Parameter

  • model Menentukan model kata kunci yang akan digunakan.

Mengembalikan

Masa depan yang kosong.

StopKeywordRecognitionAsync

Sitnaksis: public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

Secara asinkron mengakhiri operasi pengenalan kata kunci.

Mengembalikan

Masa depan yang kosong.

AddIntent

Sitnaksis: public inline void AddIntent ( const std::string & simplePhrase );

Menambahkan frasa sederhana yang mungkin diucapkan oleh pengguna, menunjukkan niat pengguna tertentu. Frasa sederhana ini dapat menjadi pola termasuk dan enitas yang dikelilingi oleh kurung kurawal. Seperti "klik kotak centang {checkboxName}".

Parameter

  • simplePhrase Frasa yang sesuai dengan niat.

Setelah dikenali, properti IntentRecognitionResult's IntentId akan cocok dengan simplePhrase yang ditentukan di sini. Jika ada entitas yang ditentukan dan cocok, entitas tersebut akan tersedia dalam panggilan IntentResult-GetEntities>().

AddIntent

Sitnaksis: public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

Menambahkan frasa sederhana yang mungkin diucapkan oleh pengguna, menunjukkan niat pengguna tertentu. Frasa sederhana ini dapat menjadi pola termasuk dan enitas yang dikelilingi oleh kurung kurawal. Seperti "klik kotak centang {checkboxName}".

Parameter

  • simplePhrase Frasa yang sesuai dengan niat.

  • intentId String id kustom yang akan dikembalikan di properti IntentRecognitionResult IntentId.

Setelah dikenali, id niat hasil akan cocok dengan id yang disediakan di sini. Jika ada entitas yang ditentukan dan cocok, entitas tersebut akan tersedia dalam panggilan IntentResult-GetEntities>().

AddIntent

Sitnaksis: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );

Menambahkan satu niat berdasarkan nama dari Model Pemahaman Bahasa yang ditentukan. Untuk jenis PatternMatchingModel dan ConversationalLanguageUnderstandingModel, ini akan menghapus model yang ada sebelum mengaktifkannya. Untuk jenis ini, intentName diabaikan.

Parameter

  • model Model pemahaman bahasa yang berisi niat.

  • intentName Nama niat tunggal yang akan disertakan dari model pemahaman bahasa.

Setelah dikenali, properti IntentRecognitionResult's IntentId akan berisi intentName yang ditentukan di sini.

AddIntent

Sitnaksis: public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName , const std::string & intentId );

Menambahkan satu niat berdasarkan nama dari Model Pemahaman Bahasa yang ditentukan. Untuk jenis PatternMatchingModel dan ConversationalLanguageUnderstandingModel, ini akan menghapus model yang ada sebelum mengaktifkannya. Untuk jenis ini, intentName dan intentId diabaikan.

Parameter

  • model Model pemahaman bahasa yang berisi niat.

  • intentName Nama niat tunggal yang akan disertakan dari model pemahaman bahasa.

  • intentId String id kustom yang akan dikembalikan di properti IntentRecognitionResult IntentId.

AddAllIntents

Sitnaksis: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

Menambahkan semua niat dari Model LUIS yang ditentukan. Untuk jenis PatternMatchingModel dan ConversationalLanguageUnderstandingModel, ini akan menghapus model yang ada sebelum mengaktifkannya.

Parameter

  • model Model pemahaman bahasa yang berisi niat.

Setelah dikenali, properti IntentRecognitionResult's IntentId akan berisi nama niat yang dikenali.

AddAllIntents

Sitnaksis: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentId );

Menambahkan semua niat dari Model LUIS yang ditentukan. Untuk jenis PatternMatchingModel dan ConversationalLanguageUnderstandingModel, ini akan menghapus model yang ada sebelum mengaktifkannya.

Parameter

  • model Model pemahaman bahasa yang berisi niat.

  • intentId Id string kustom yang akan dikembalikan di properti IntentRecognitionResult IntentId.

AddIntent

Sitnaksis: public inline void AddIntent ( std::shared_ptr< IntentTrigger > trigger , const std::string & intentId );

Menambahkan IntentTrigger yang ditentukan.

Parameter

  • trigger IntentTrigger yang sesuai dengan niat.

  • intentId Id string kustom yang akan dikembalikan di properti IntentRecognitionResult IntentId.

SetAuthorizationToken

Sitnaksis: public inline void SetAuthorizationToken ( const std::string & token );

Mengatur token otorisasi yang akan digunakan untuk menyambungkan ke layanan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid. Jika tidak, recognizer akan mengalami kesalahan selama pengenalan.

Parameter

  • token String yang mewakili token otorisasi.

GetAuthorizationToken

Sitnaksis: public inline std::string GetAuthorizationToken ( );

Mendapatkan token otorisasi.

Mengembalikan

Token otorisasi

ApplyLanguageModels

Sitnaksis: public inline bool ApplyLanguageModels ( const std::vector< std::shared_ptr< LanguageUnderstandingModel > > & collection );

Mengambil kumpulan model pemahaman bahasa, membuat salinannya, dan menerapkannya ke pengenal. Aplikasi ini terjadi pada waktu yang berbeda tergantung pada jenis model pemahaman bahasa. Model Bahasa Sederhana akan segera aktif sedangkan model pemahaman bahasa yang menggunakan LUIS akan menjadi aktif pada giliran Ucapan berikutnya. Ini menggantikan model yang diterapkan sebelumnya.

Parameter

  • collection Vektor pointer bersama ke LanguageUnderstandingModels.

Mengembalikan

True jika penerapan model segera berlaku. Jika tidak salah.

FromConfig

Sitnaksis: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< SpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Membuat pengenal niat dari konfigurasi ucapan dan konfigurasi audio. Pengguna harus menggunakan fungsi ini untuk membuat instans baru pengenal niat.

Parameter

  • speechConfig Konfigurasi ucapan.

  • audioInput Konfigurasi audio.

Mengembalikan

Contoh pengenal niat.

FromConfig

Sitnaksis: public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

Membuat pengenal niat dari konfigurasi ucapan yang disematkan dan konfigurasi audio. Pengguna harus menggunakan fungsi ini untuk membuat instans baru pengenal niat. Ditambahkan dalam versi 1.19.0.

Parameter

  • speechConfig Konfigurasi ucapan yang disematkan.

  • audioInput Konfigurasi audio.

Mengembalikan

Contoh pengenal niat.

BaseType

Sitnaksis: typedef BaseType;