IntentRecognizer Classe
Oltre a eseguire il riconoscimento vocale, IntentRecognizer estrae informazioni strutturate sulla finalità dell'altoparlante.
- Ereditarietà
-
IntentRecognizer
Costruttore
IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)
Parametri
Nome | Descrizione |
---|---|
speech_config
Necessario
|
Configurazione per il riconoscimento vocale. |
audio_config
|
Configurazione per l'input audio. valore predefinito: None
|
intents
|
Finalità da un'iterabile su coppie di (modello, intent_id) o (simple_phrase, intent_id) da riconoscere. valore predefinito: None
|
Metodi
add_all_intents |
Aggiunge tutte le finalità dal modello di Language Understanding specificato. |
add_intent |
Aggiungere una finalità al riconoscitore. Esistono diversi modi per eseguire questa operazione:
|
add_intents |
Aggiungere finalità da coppie iterabili di (modello, intent_id) o (simple_phrase, intent_id). |
recognize_once |
Esegue il riconoscimento in modalità di blocco (sincrona). Restituisce il risultato dopo il riconoscimento di 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. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async. |
recognize_once_async |
Esegue il riconoscimento in modalità non di blocco (asincrona). Verrà 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. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async. |
start_continuous_recognition |
Avvia in modo sincrono l'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento. |
start_continuous_recognition_async |
Avvia in modo asincrono un'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento. |
start_keyword_recognition |
Configura in modo sincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition() per terminare il riconoscimento avviato dalla parola chiave. |
start_keyword_recognition_async |
Configura in modo asincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition_async() per terminare il riconoscimento avviato dalla parola chiave. |
stop_continuous_recognition |
Termina in modo sincrono l'operazione di riconoscimento continuo. |
stop_continuous_recognition_async |
Termina in modo asincrono l'operazione di riconoscimento continuo. |
stop_keyword_recognition |
Termina in modo sincrono il riconoscimento avviato dalla parola chiave. |
stop_keyword_recognition_async |
Termina in modo asincrono il riconoscimento avviato dalla parola chiave. |
add_all_intents
Aggiunge tutte le finalità dal modello di Language Understanding specificato.
add_all_intents(model: LanguageUnderstandingModel)
Parametri
Nome | Descrizione |
---|---|
model
Necessario
|
|
add_intent
Aggiungere una finalità al riconoscitore. Esistono diversi modi per eseguire questa operazione:
add_intent(simple_phrase): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica.
add_intent(simple_phrase, intent_id): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica. Una volta riconosciuto, l'ID finalità del risultato corrisponderà all'ID fornito qui.
add_intent(model, intent_name): aggiunge una singola finalità in base al nome dall'oggetto specificato LanguageUnderstandingModel.
add_intent(model, intent_name, intent_id): aggiunge una singola finalità per nome dall'oggetto specificato LanguageUnderstandingModel.
add_intent(trigger, intent_id): aggiunge l'oggetto IntentTrigger specificato. IntentTrigger.
add_intent(*args)
Parametri
Nome | Descrizione |
---|---|
model
Necessario
|
Modello di comprensione del linguaggio contenente la finalità. |
intent_name
Necessario
|
Nome della singola finalità da includere nel modello di comprensione del linguaggio. |
simple_phrase
Necessario
|
Frase corrispondente alla finalità. |
intent_id
Necessario
|
Stringa ID personalizzata da restituire nella proprietà intent_id dell'oggetto IntentRecognitionResult. |
trigger
Necessario
|
IntentTrigger corrispondente alla finalità. |
add_intents
Aggiungere finalità da coppie iterabili di (modello, intent_id) o (simple_phrase, intent_id).
add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])
Parametri
Nome | Descrizione |
---|---|
intents
Necessario
|
Finalità da un'iterabile su coppie di (modello, intent_id) o (simple_phrase, intent_id) da riconoscere. |
intents_iter
Necessario
|
|
recognize_once
Esegue il riconoscimento in modalità di blocco (sincrona). Restituisce il risultato dopo il riconoscimento di 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. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.
recognize_once() -> IntentRecognitionResult
Restituisce
Tipo | Descrizione |
---|---|
Valore del risultato del riconoscimento sincrono. |
recognize_once_async
Esegue il riconoscimento in modalità non di blocco (asincrona). Verrà 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. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.
recognize_once_async() -> ResultFuture
Restituisce
Tipo | Descrizione |
---|---|
Valore futuro contenente il valore del risultato del riconoscimento asincrono. |
start_continuous_recognition
Avvia in modo sincrono l'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.
start_continuous_recognition()
start_continuous_recognition_async
Avvia in modo asincrono un'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.
start_continuous_recognition_async() -> ResultFuture
Restituisce
Tipo | Descrizione |
---|---|
Un futuro che viene soddisfatto dopo l'inizializzazione del riconoscimento. |
start_keyword_recognition
Configura in modo sincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition() per terminare il riconoscimento avviato dalla parola chiave.
start_keyword_recognition(model: KeywordRecognitionModel)
Parametri
Nome | Descrizione |
---|---|
model
Necessario
|
modello di riconoscimento delle parole chiave che specifica la parola chiave da riconoscere. |
start_keyword_recognition_async
Configura in modo asincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition_async() per terminare il riconoscimento avviato dalla parola chiave.
start_keyword_recognition_async(model: KeywordRecognitionModel)
Parametri
Nome | Descrizione |
---|---|
model
Necessario
|
modello di riconoscimento delle parole chiave che specifica la parola chiave da riconoscere. |
Restituisce
Tipo | Descrizione |
---|---|
Un futuro che viene soddisfatto dopo l'inizializzazione del riconoscimento. |
stop_continuous_recognition
Termina in modo sincrono l'operazione di riconoscimento continuo.
stop_continuous_recognition()
stop_continuous_recognition_async
Termina in modo asincrono l'operazione di riconoscimento continuo.
stop_continuous_recognition_async()
Restituisce
Tipo | Descrizione |
---|---|
Un futuro che viene soddisfatto dopo che il riconoscimento è stato arrestato. |
stop_keyword_recognition
Termina in modo sincrono il riconoscimento avviato dalla parola chiave.
stop_keyword_recognition()
stop_keyword_recognition_async
Termina in modo asincrono il riconoscimento avviato dalla parola chiave.
stop_keyword_recognition_async()
Restituisce
Tipo | Descrizione |
---|---|
Un futuro che viene soddisfatto dopo che il riconoscimento è stato arrestato. |
Attributi
authorization_token
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
il token di autorizzazione scade, il chiamante deve aggiornarlo chiamando questo setter con un
nuovo token valido. In caso contrario, il riconoscitore rileva errori durante il riconoscimento.
canceled
Segnalare gli eventi contenenti risultati di riconoscimento annullati (indicante un tentativo di riconoscimento annullato come risultato o una richiesta di annullamento diretta o, in alternativa, un errore di trasporto o protocollo).
I callback connessi a questo segnale vengono chiamati con un'istanza IntentRecognitionCanceledEventArgsdi , come singolo argomento.
endpoint_id
ID endpoint di un modello di riconoscimento vocale personalizzato usato per il riconoscimento o un modello di voce personalizzato per la sintesi vocale.
properties
Raccolta di proprietà e relativi valori definiti per questo strumento di riconoscimento.
recognized
Segnale per gli eventi contenenti i risultati finali del riconoscimento (che indica un tentativo di riconoscimento riuscito).
I callback connessi a questo segnale vengono chiamati con un'istanza IntentRecognitionEventArgs come singolo argomento, dipendente dal tipo di riconoscitore.
recognizing
Segnalare gli eventi contenenti risultati intermedi del riconoscimento.
I callback connessi a questo segnale vengono chiamati con un'istanza IntentRecognitionEventArgs come singolo argomento.
session_started
Segnale per gli eventi che indicano l'inizio di una sessione di riconoscimento (operazione).
I callback connessi a questo segnale vengono chiamati con un'istanza SessionEventArgs come singolo argomento.
session_stopped
Segnale per gli eventi che indicano la fine di una sessione di riconoscimento (operazione).
I callback connessi a questo segnale vengono chiamati con un'istanza SessionEventArgs come singolo argomento.
speech_end_detected
Segnale per gli eventi che indicano la fine del parlato.
I callback connessi a questo segnale vengono chiamati con un'istanza RecognitionEventArgs come singolo argomento.
speech_start_detected
Segnale per gli eventi che indicano l'inizio del parlato.
I callback connessi a questo segnale vengono chiamati con un'istanza RecognitionEventArgs come singolo argomento.
Azure SDK for Python