Condividi tramite

Class Intent::IntentRecognizer

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

Oltre a eseguire il riconoscimento vocale, IntentRecognizer estrae informazioni strutturate sulla finalità del parlante, che può essere usato per eseguire altre azioni usando trigger di finalità dedicati (vedere IntentTrigger).

Membri

Proprietà

Sintassi: public PropertyCollection & Properties;

Raccolta di proprietà e dei 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 recognizer.

~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 è determinata dall'ascolto del silenzio alla fine o fino a quando non viene elaborato un massimo di circa 30 secondi di audio. L'attività restituisce il testo di riconoscimento come risultato. Nota: poiché RecognizeOnceAsync() restituisce solo una singola espressione, è adatta solo per il riconoscimento di singoli scatti, ad esempio comando o query. Per il riconoscimento a più espressioni a esecuzione prolungata, usare invece StartContinuousRecognitionAsync().

Rendiconto

Valore del risultato contenente in futuro (un 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. Ciò è utile per il test e altre volte in cui l'input vocale non è associato a IntentRecognizer. Nota: il servizio intento attualmente non supporta questa operazione, pertanto è valida solo per i criteri di ricerca offline o per le finalità esatte di corrispondenza.

Parametri

  • text Il testo da valutare.

Rendiconto

Valore del risultato contenente in futuro (un puntatore condiviso a IntentRecognitionResult) del riconoscimento della finalità asincrona.

StartContinuousRecognitionAsync

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

Avvia in modo asincrono un'operazione di riconoscimento continuo delle finalità.

Rendiconto

Un futuro vuoto.

StopContinuousRecognitionAsync

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

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

Rendiconto

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.

Rendiconto

Un futuro vuoto.

StopKeywordRecognitionAsync

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

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

Rendiconto

Un futuro vuoto.

AddIntent

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

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

Parametri

  • simplePhrase La frase corrispondente alla finalità.

Una volta riconosciuta, la proprietà IntentRecognitionResult di IntentId corrisponderà alla simplePhrase specificata qui. Se vengono specificate e abbinate entità, saranno disponibili nella chiamata IntentResult->GetEntities().

AddIntent

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

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

Parametri

  • simplePhrase La frase corrispondente alla finalità.

  • intentId Stringa ID personalizzata da restituire nella proprietà IntentRecognitionResult di IntentId.

Una volta riconosciuto, l'ID finalità del risultato corrisponderà all'ID fornito qui. Se vengono specificate e abbinate entità, 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 Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo. Per questi tipi, intentName viene ignorato.

Parametri

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

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

Una volta riconosciuto, la proprietà IntentRecognitionResult di IntentId conterrà il valore intentName 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 Language Understanding specificato. Per i tipi PatternMatchingModel e ConversationalLanguageUnderstandingModel, verranno cancellati tutti i modelli esistenti prima di abilitarlo. Per questi tipi, intentName e intentId vengono ignorati.

Parametri

  • model Modello di comprensione del linguaggio 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 di IntentId.

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 del linguaggio contenente le finalità.

Una volta 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.

Rendiconto

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 si verifica 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.

Rendiconto

True se l'applicazione dei modelli ha effetto 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 sistema di riconoscimento finalità da una configurazione vocale e una configurazione audio. Gli utenti devono usare questa funzione per creare una nuova istanza di un sistema di riconoscimento finalità.

Parametri

  • speechConfig configurazione voce.

  • audioInput configurazione audio.

Rendiconto

Istanza del sistema di riconoscimento 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 di riconoscimento vocale incorporata e una configurazione audio. Gli utenti devono usare questa funzione per creare una nuova istanza di un sistema di riconoscimento finalità. Aggiunta nella versione 1.19.0.

Parametri

  • speechConfig configurazione del riconoscimento vocale incorporato.

  • audioInput configurazione audio.

Rendiconto

Istanza del sistema di riconoscimento finalità.

BaseType

Sintassi: typedef BaseType;