IntentRecognizer Classe

En plus d’effectuer la reconnaissance vocale, IntentRecognizer extrait des informations structurées sur l’intention de l’orateur.

Héritage

Recognizer

IntentRecognizer

Constructeur

IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)

Paramètres

Nom	Description
speech_config Obligatoire	Configuration du module de reconnaissance vocale.
audio_config	Configuration de l’entrée audio. valeur par défaut: None
intents	Intentions d’une itérable sur des paires de (modèle, intent_id) ou (simple_phrase, intent_id) à reconnaître. valeur par défaut: None

Méthodes

add_all_intents	Ajoute toutes les intentions du modèle Language Understanding spécifié.
add_intent	Ajoutez une intention au module de reconnaissance. Il existe différentes façons de procéder : add_intent(simple_phrase) : ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. add_intent(simple_phrase, intent_id) : ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Une fois reconnu, l’ID d’intention du résultat correspond à l’ID fourni ici. add_intent(model, intent_name) : ajoute une intention unique par nom à partir du spécifié LanguageUnderstandingModel. add_intent(model, intent_name, intent_id) : ajoute une intention unique par nom à partir du spécifié LanguageUnderstandingModel. add_intent(trigger, intent_id) : ajoute le IntentTrigger spécifié. IntentTrigger.
add_intents	Ajoutez des intentions à partir d’une itérable sur des paires de (modèle, intent_id) ou (simple_phrase, intent_id).
recognize_once	Effectue la reconnaissance en mode bloquant (synchrone). Retourne après la reconnaissance d’un énoncé unique. La fin d’un énoncé unique est déterminée par la détection du silence à la fin, ou après que 15 secondes d’audio ont été traitées. La tâche retourne le texte de reconnaissance comme résultat. Pour une reconnaissance à plusieurs énoncés de longue durée, utilisez start_continuous_recognition_async à la place.
recognize_once_async	Effectue la reconnaissance en mode non bloquant (asynchrone). Cela permet de reconnaître un énoncé unique. La fin d’un énoncé unique est déterminée par la détection du silence à la fin, ou après que 15 secondes d’audio ont été traitées. Pour une reconnaissance à plusieurs énoncés de longue durée, utilisez start_continuous_recognition_async à la place.
start_continuous_recognition	Lance de manière synchrone une opération de reconnaissance continue. L’utilisateur doit se connecter à EventSignal pour recevoir les résultats de la reconnaissance. Appelez stop_continuous_recognition_async pour arrêter la reconnaissance.
start_continuous_recognition_async	Lance de manière asynchrone l’opération de reconnaissance continue. L’utilisateur doit se connecter à EventSignal pour recevoir les résultats de la reconnaissance. Appelez stop_continuous_recognition_async pour arrêter la reconnaissance.
start_keyword_recognition	Configure de façon synchrone le module de reconnaissance avec le modèle mot clé donné. Après avoir appelé cette méthode, le module de reconnaissance est à l’écoute de la mot clé pour démarrer la reconnaissance. Appelez stop_keyword_recognition() pour mettre fin à la reconnaissance mot clé initiée.
start_keyword_recognition_async	Configure de façon asynchrone le module de reconnaissance avec le modèle de mot clé donné. Après avoir appelé cette méthode, le module de reconnaissance est à l’écoute de la mot clé pour démarrer la reconnaissance. Appelez stop_keyword_recognition_async() pour mettre fin à la reconnaissance mot clé lancée.
stop_continuous_recognition	Met fin de façon synchrone à l’opération de reconnaissance continue en cours.
stop_continuous_recognition_async	Arrête de façon asynchrone l’opération de reconnaissance continue en cours.
stop_keyword_recognition	Termine de façon synchrone la reconnaissance mot clé lancée.
stop_keyword_recognition_async	Met fin de façon asynchrone à la reconnaissance mot clé lancée.

add_all_intents

Ajoute toutes les intentions du modèle Language Understanding spécifié.

add_all_intents(model: LanguageUnderstandingModel)

Paramètres

Nom	Description
model Obligatoire

add_intent

Ajoutez une intention au module de reconnaissance. Il existe différentes façons de procéder :

• add_intent(simple_phrase) : ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur.

• add_intent(simple_phrase, intent_id) : ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Une fois reconnu, l’ID d’intention du résultat correspond à l’ID fourni ici.

• add_intent(model, intent_name) : ajoute une intention unique par nom à partir du spécifié LanguageUnderstandingModel.

• add_intent(model, intent_name, intent_id) : ajoute une intention unique par nom à partir du spécifié LanguageUnderstandingModel.

• add_intent(trigger, intent_id) : ajoute le IntentTrigger spécifié. IntentTrigger.

add_intent(*args)

Paramètres

Nom	Description
model Obligatoire	Modèle de compréhension du langage contenant l’intention.
intent_name Obligatoire	Nom de l’intention unique à inclure à partir du modèle de compréhension du langage.
simple_phrase Obligatoire	Expression correspondant à l’intention.
intent_id Obligatoire	Chaîne d’ID personnalisée à retourner dans la IntentRecognitionResultpropriété de intent_id .
trigger Obligatoire	IntentTrigger correspondant à l’intention.

add_intents

Ajoutez des intentions à partir d’une itérable sur des paires de (modèle, intent_id) ou (simple_phrase, intent_id).

add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])

Paramètres

Nom	Description
intents Obligatoire	Intentions d’une itérable sur des paires de (modèle, intent_id) ou (simple_phrase, intent_id) à reconnaître.
intents_iter Obligatoire

recognize_once

Effectue la reconnaissance en mode bloquant (synchrone). Retourne après la reconnaissance d’un énoncé unique. La fin d’un énoncé unique est déterminée par la détection du silence à la fin, ou après que 15 secondes d’audio ont été traitées. La tâche retourne le texte de reconnaissance comme résultat. Pour une reconnaissance à plusieurs énoncés de longue durée, utilisez start_continuous_recognition_async à la place.

recognize_once() -> IntentRecognitionResult

Retours

Type	Description
	Valeur de résultat de la reconnaissance synchrone.

recognize_once_async

Effectue la reconnaissance en mode non bloquant (asynchrone). Cela permet de reconnaître un énoncé unique. La fin d’un énoncé unique est déterminée par la détection du silence à la fin, ou après que 15 secondes d’audio ont été traitées. Pour une reconnaissance à plusieurs énoncés de longue durée, utilisez start_continuous_recognition_async à la place.

recognize_once_async() -> ResultFuture

Retours

Type	Description
	Futur contenant la valeur de résultat de la reconnaissance asynchrone.

start_continuous_recognition

Lance de manière synchrone une opération de reconnaissance continue. L’utilisateur doit se connecter à EventSignal pour recevoir les résultats de la reconnaissance. Appelez stop_continuous_recognition_async pour arrêter la reconnaissance.

start_continuous_recognition()

start_continuous_recognition_async

Lance de manière asynchrone l’opération de reconnaissance continue. L’utilisateur doit se connecter à EventSignal pour recevoir les résultats de la reconnaissance. Appelez stop_continuous_recognition_async pour arrêter la reconnaissance.

start_continuous_recognition_async() -> ResultFuture

Retours

Type	Description
	Un avenir qui s’accomplit une fois la reconnaissance initialisée.

start_keyword_recognition

Configure de façon synchrone le module de reconnaissance avec le modèle mot clé donné. Après avoir appelé cette méthode, le module de reconnaissance est à l’écoute de la mot clé pour démarrer la reconnaissance. Appelez stop_keyword_recognition() pour mettre fin à la reconnaissance mot clé initiée.

start_keyword_recognition(model: KeywordRecognitionModel)

Paramètres

Nom	Description
model Obligatoire	le modèle de reconnaissance mot clé qui spécifie le mot clé à reconnaître.

start_keyword_recognition_async

Configure de façon asynchrone le module de reconnaissance avec le modèle de mot clé donné. Après avoir appelé cette méthode, le module de reconnaissance est à l’écoute de la mot clé pour démarrer la reconnaissance. Appelez stop_keyword_recognition_async() pour mettre fin à la reconnaissance mot clé lancée.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Paramètres

Nom	Description
model Obligatoire	le modèle de reconnaissance mot clé qui spécifie le mot clé à reconnaître.

Retours

Type	Description
	Un avenir qui s’accomplit une fois la reconnaissance initialisée.

stop_continuous_recognition

Met fin de façon synchrone à l’opération de reconnaissance continue en cours.

stop_continuous_recognition()

stop_continuous_recognition_async

Arrête de façon asynchrone l’opération de reconnaissance continue en cours.

stop_continuous_recognition_async()

Retours

Type	Description
	Un avenir qui s’accomplit une fois que la reconnaissance a été arrêtée.

stop_keyword_recognition

Termine de façon synchrone la reconnaissance mot clé lancée.

stop_keyword_recognition()

stop_keyword_recognition_async

Met fin de façon asynchrone à la reconnaissance mot clé lancée.

stop_keyword_recognition_async()

Retours

Type	Description
	Un avenir qui s’accomplit une fois que la reconnaissance a été arrêtée.

Attributs

authorization_token

Jeton d’autorisation qui sera utilisé pour la connexion au service.

Notes

L’appelant doit s’assurer que le jeton d’autorisation est valide. Avant le

le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant ce setter avec un

nouveau jeton valide. Sinon, le module de reconnaissance rencontrera des erreurs lors de la reconnaissance.

canceled

Signal pour les événements contenant des résultats de reconnaissance annulés (indiquant une tentative de reconnaissance qui a été annulée en tant que résultat ou une demande d’annulation directe ou, alternativement, un échec de transport ou de protocole).

Les rappels connectés à ce signal sont appelés avec un IntentRecognitionCanceledEventArgs, instance comme argument unique.

endpoint_id

ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance ou d’un modèle vocal personnalisé pour la synthèse vocale.

properties

Collection de propriétés et leurs valeurs définies pour ce module de reconnaissance.

recognized

Signal pour les événements contenant les résultats de la reconnaissance finale (indiquant une tentative de reconnaissance réussie).

Les rappels connectés à ce signal sont appelés avec un IntentRecognitionEventArgs instance comme argument unique, en fonction du type de module de reconnaissance.

recognizing

Signal pour les événements contenant des résultats de reconnaissance intermédiaires.

Les rappels connectés à ce signal sont appelés avec un IntentRecognitionEventArgs instance comme argument unique.

session_started

Signal pour les événements indiquant le début d’une session de reconnaissance (opération).

Les rappels connectés à ce signal sont appelés avec un SessionEventArgs instance comme argument unique.

session_stopped

Signal pour les événements indiquant la fin d’une session de reconnaissance (opération).

Les rappels connectés à ce signal sont appelés avec un SessionEventArgs instance comme argument unique.

speech_end_detected

Signal pour les événements indiquant la fin de la parole.

Les rappels connectés à ce signal sont appelés avec un RecognitionEventArgs instance comme argument unique.

speech_start_detected

Signal pour les événements indiquant le début de la parole.

Les rappels connectés à ce signal sont appelés avec un RecognitionEventArgs instance comme argument unique.