Condividi tramite

class Intent::IntentRecognizer

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

Oltre a eseguire il riconoscimento vocale a testo, IntentRecognizer estrae informazioni strutturate sulla finalità dell'altoparlante, che può essere usata per guidare ulteriori azioni usando trigger finalità dedicati (vedere IntentTrigger).

Membri

Proprietà

Sintassi: public PropertyCollection & Properties;

Raccolta di proprietà e relativi valori definiti per questo IntentRecognizer.

IntentRecognizer

Sintassi: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Costruttore interno. Crea una nuova istanza usando l'handle fornito.

Parametri

  • hreco Handle di riconoscimento.

~IntentRecognizer

Sintassi: public inline ~IntentRecognizer ( );

distruttore

RecognizeOnceAsync

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

Avvia il riconoscimento delle finalità e restituisce dopo che viene riconosciuta una singola espressione. La fine di una singola espressione viene determinata restando in ascolto del silenzio al termine o finché non vengono elaborati al massimo 15 secondi di audio. L'attività restituisce il testo di riconoscimento come risultato. Nota: poiché RecognizeOnceAsync() restituisce solo un'unica espressione, è adatta solo per il riconoscimento di un singolo colpo, ad esempio il comando o la query. Per il riconoscimento a più espressioni in esecuzione prolungata, usare invece StartContinuousRecognitionAsync().

Restituisce

Futuro contenente il valore del risultato (puntatore condiviso a IntentRecognitionResult) del riconoscimento della finalità asincrona.

RecognizeOnceAsync

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

Avvia il riconoscimento delle finalità e genera un risultato dal testo passato. Questo è utile per il test e altre volte quando l'input vocale non è collegato a IntentRecognizer. Nota: il servizio finalità non supporta attualmente questa operazione in modo che sia valida solo per la corrispondenza del modello offline o per le finalità esatte di corrispondenza.

Parametri

  • text Testo da valutare.

Restituisce

Futuro contenente il valore del risultato (puntatore condiviso a IntentRecognitionResult) del riconoscimento della finalità asincrona.

StartContinuousRecognitionAsync

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

Avvia in modo asincrono l'operazione di riconoscimento delle finalità continue.

Restituisce

Un futuro vuoto.

StopContinuousRecognitionAsync

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

Termina in modo asincrono l'operazione di riconoscimento continuo delle finalità.

Restituisce

Un futuro vuoto.

StartKeywordRecognitionAsync

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

Avvia in modo asincrono l'operazione di riconoscimento delle parole chiave.

Parametri

  • model Specifica il modello di parola chiave da usare.

Restituisce

Un futuro vuoto.

StopKeywordRecognitionAsync

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

Termina in modo asincrono l'operazione di riconoscimento delle parole chiave.

Restituisce

Un futuro vuoto.

AddIntent

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

Aggiunge una semplice frase che può essere pronunciata dall'utente, che indica una finalità utente specifica. Questa frase semplice può essere un modello che include ed enitity circondato da parentesi graffe. Ad esempio, "fare clic sulla casella di controllo {checkboxName}".

Parametri

  • simplePhrase Frase corrispondente alla finalità.

Dopo aver riconosciuto, la proprietà IntentRecognitionResult corrisponderà alla proprietà SimplePhrase specificata qui. Se le entità sono specificate e corrispondenti, saranno disponibili nella chiamata IntentResult-GetEntities>().

AddIntent

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

Aggiunge una semplice frase che può essere pronunciata dall'utente, che indica una finalità utente specifica. Questa frase semplice può essere un modello che include ed enitity circondato da parentesi graffe. Ad esempio, "fare clic sulla casella di controllo {checkboxName}".

Parametri

  • simplePhrase Frase corrispondente alla finalità.

  • intentId Stringa id personalizzata da restituire nella proprietà IntentRecognitionResult.

Una volta riconosciuto, l'ID finalità del risultato corrisponderà all'ID specificato qui. Se le entità sono specificate e corrispondenti, saranno disponibili nella chiamata IntentResult-GetEntities>().

AddIntent

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

Aggiunge una singola finalità per nome dal modello di Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo. Per questi tipi, l'intentName viene ignorato.

Parametri

  • model Modello di comprensione della lingua contenente la finalità.

  • intentName Nome della singola finalità da includere nel modello di comprensione del linguaggio.

Una volta riconosciuto, la proprietà IntentRecognitionResult conterrà il nome intento specificato qui.

AddIntent

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

Aggiunge una singola finalità per nome dal modello di Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo. Per questi tipi, l'intentName e l'intentId vengono ignorati.

Parametri

  • model Modello di comprensione della lingua contenente la finalità.

  • intentName Nome della singola finalità da includere nel modello di comprensione del linguaggio.

  • intentId Stringa id personalizzata da restituire nella proprietà IntentRecognitionResult.

AddAllIntents

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

Aggiunge tutte le finalità dal modello di Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo.

Parametri

  • model Modello di comprensione della lingua contenente le finalità.

Dopo aver riconosciuto, la proprietà IntentRecognitionResult di IntentId conterrà il nome della finalità riconosciuta.

AddAllIntents

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

Aggiunge tutte le finalità dal modello di Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo.

Parametri

  • model Modello di comprensione del linguaggio contenente le finalità.

  • intentId ID stringa personalizzato da restituire nella proprietà IntentRecognitionResult di IntentId.

AddIntent

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

Aggiunge l'oggetto IntentTrigger specificato.

Parametri

  • trigger IntentTrigger corrispondente alla finalità.

  • intentId ID stringa personalizzato da restituire nella proprietà IntentRecognitionResult di IntentId.

SetAuthorizationToken

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

Imposta il token di autorizzazione che verrà usato per la connessione al servizio. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido. In caso contrario, il riconoscitore rileva errori durante il riconoscimento.

Parametri

  • token Stringa che rappresenta il token di autorizzazione.

GetAuthorizationToken

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

Ottiene il token di autorizzazione.

Restituisce

Token di autorizzazione

ApplyLanguageModels

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

Accetta una raccolta di modelli di comprensione del linguaggio, li crea una copia e li applica al riconoscitore. Questa applicazione viene eseguita in momenti diversi a seconda del tipo di modello di comprensione del linguaggio. I modelli linguistici semplici diventeranno attivi quasi immediatamente, mentre i modelli di comprensione del linguaggio che usano LUIS diventeranno attivi al successivo turno di riconoscimento vocale. In questo modo vengono sostituiti tutti i modelli applicati in precedenza.

Parametri

  • collection Vettore di puntatori condivisi a LanguageUnderstandingModels.

Restituisce

True se l'applicazione dei modelli diventa effettiva immediatamente. In caso contrario, false.

FromConfig

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

Crea un riconoscitore finalità da una configurazione del riconoscimento vocale e una configurazione audio. Gli utenti devono usare questa funzione per creare una nuova istanza di un riconoscitore di finalità.

Parametri

  • speechConfig Configurazione del riconoscimento vocale.

  • audioInput Configurazione audio.

Restituisce

Istanza del sistema di riconoscimento delle finalità.

FromConfig

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

Crea un riconoscitore finalità da una configurazione vocale incorporata e una configurazione audio. Gli utenti devono usare questa funzione per creare una nuova istanza di un riconoscitore di finalità. Aggiunta nella versione 1.19.0.

Parametri

  • speechConfig Configurazione del riconoscimento vocale incorporata.

  • audioInput Configurazione audio.

Restituisce

Istanza del sistema di riconoscimento delle finalità.

BaseType

Sintassi: typedef BaseType;