classe Intent ::IntentRecognizer

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

En plus d’effectuer la reconnaissance vocale, l’objet IntentRecognizer extrait des informations structurées sur l’intention de l’orateur, qui peuvent être utilisées pour générer d’autres actions à l’aide de déclencheurs d’intention dédiés (voir IntentTrigger).

Membres

Propriétés

Syntaxe : public PropertyCollection & Properties;

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

IntentRecognizer

Syntaxe : public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Constructeur interne. Crée un instance à l’aide du handle fourni.

Paramètres

  • hreco Handle recognizer.

~IntentRecognizer

Syntaxe : public inline ~IntentRecognizer ( );

destructeur

RecognizeOnceAsync

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

Démarre la reconnaissance de l’intention et retourne une fois qu’un seul énoncé est reconnu. 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. Remarque : Étant donné que RecognizeOnceAsync() ne retourne qu’un seul énoncé, il ne convient qu’à la reconnaissance d’un seul coup comme une commande ou une requête. Pour la reconnaissance multi-énoncé de longue durée, utilisez à la place StartContinuousRecognitionAsync().

Retours

Valeur de résultat future (pointeur partagé vers IntentRecognitionResult) de la reconnaissance d’intention asynchrone.

RecognizeOnceAsync

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

Démarre la reconnaissance des intentions et génère un résultat à partir du texte transmis. Cela est utile pour les tests et d’autres fois où l’entrée vocale n’est pas liée à IntentRecognizer. Remarque : Le service Intention ne prend actuellement pas en charge cette fonctionnalité. Elle est donc uniquement valide pour les intentions de correspondance de modèle hors connexion ou exactes.

Paramètres

  • text Texte à évaluer.

Retours

Valeur de résultat future (pointeur partagé vers IntentRecognitionResult) de la reconnaissance d’intention asynchrone.

StartContinuousRecognitionAsync

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

Lance de manière asynchrone l’opération de reconnaissance d’intention continue.

Retours

Un avenir vide.

StopContinuousRecognitionAsync

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

Met fin de manière asynchrone à l’opération de reconnaissance continue d’intention.

Retours

Un avenir vide.

StartKeywordRecognitionAsync

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

Lance de manière asynchrone mot clé opération de reconnaissance.

Paramètres

  • modelSpécifie le modèle mot clé à utiliser.

Retours

Un avenir vide.

StopKeywordRecognitionAsync

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

Arrête de manière asynchrone mot clé opération de reconnaissance.

Retours

Un avenir vide.

AddIntent

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

Ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Cette expression simple peut être un modèle incluant et l’enitité entouré d’accolades. Par exemple, « cliquez sur la case {case à cocherName} ».

Paramètres

  • simplePhrase Expression correspondant à l’intention.

Une fois reconnue, la propriété IntentId de IntentRecognitionResult correspondra à la simplePhrase spécifiée ici. Si des entités sont spécifiées et mises en correspondance, elles seront disponibles dans l’appel IntentResult-GetEntities>().

AddIntent

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

Ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Cette expression simple peut être un modèle incluant et l’enitité entouré d’accolades. Par exemple, « cliquez sur la case {case à cocherName} ».

Paramètres

  • simplePhrase Expression correspondant à l’intention.

  • intentId Chaîne d’ID personnalisée à retourner dans la propriété IntentId de IntentRecognitionResult.

Une fois reconnu, l’ID d’intention du résultat correspondra à l’ID fourni ici. Si des entités sont spécifiées et mises en correspondance, elles seront disponibles dans l’appel IntentResult-GetEntities>().

AddIntent

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

Ajoute une intention unique par nom à partir du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer. Pour ces types, l’objet intentName est ignoré.

Paramètres

  • model Modèle de compréhension du langage contenant l’intention.

  • intentName Nom de l’intention unique à inclure à partir du modèle de compréhension du langage.

Une fois reconnue, la propriété IntentId de IntentRecognitionResult contiendra le intentName spécifié ici.

AddIntent

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

Ajoute une intention unique par nom à partir du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer. Pour ces types, les intentName et intentId sont ignorés.

Paramètres

  • model Modèle de compréhension du langage contenant l’intention.

  • intentName Nom de l’intention unique à inclure à partir du modèle de compréhension du langage.

  • intentId Chaîne d’ID personnalisée à retourner dans la propriété IntentId de IntentRecognitionResult.

AddAllIntents

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

Ajoute toutes les intentions du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer.

Paramètres

  • model Modèle de compréhension du langage contenant les intentions.

Une fois reconnue, la propriété IntentId de IntentRecognitionResult contient le nom de l’intention reconnue.

AddAllIntents

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

Ajoute toutes les intentions du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants sont effacés avant de les activer.

Paramètres

  • model Modèle de compréhension du langage contenant les intentions.

  • intentId ID de chaîne personnalisé à retourner dans la propriété IntentRecognitionResult.

AddIntent

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

Ajoute l’objet IntentTrigger spécifié.

Paramètres

  • trigger IntentTrigger correspondant à l’intention.

  • intentId ID de chaîne personnalisé à retourner dans la propriété IntentRecognitionResult.

SetAuthorizationToken

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

Définit le jeton d’autorisation qui sera utilisé pour la connexion au service. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode setter avec un nouveau jeton valide. Sinon, le module de reconnaissance rencontrera des erreurs lors de la reconnaissance.

Paramètres

  • token Chaîne qui représente le jeton d’autorisation.

GetAuthorizationToken

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

Obtient le jeton d’autorisation.

Retours

Jeton d’autorisation

ApplyLanguageModels

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

Prend une collection de modèles de compréhension du langage, en fait une copie et les applique au module de reconnaissance. Cette application se produit à différents moments selon le type de modèle de compréhension du langage. Les modèles de langage simple deviendront actifs presque immédiatement, tandis que les modèles de compréhension du langage utilisant LUIS deviendront actifs au prochain tour de reconnaissance vocale. Cela remplace tous les modèles précédemment appliqués.

Paramètres

  • collection Vecteur de pointeurs partagés vers LanguageUnderstandingModels.

Retours

True si l’application des modèles prend effet immédiatement. Sinon, false.

FromConfig

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

Crée un module de reconnaissance d’intention à partir d’une configuration vocale et d’une configuration audio. Les utilisateurs doivent utiliser cette fonction pour créer un instance d’un module de reconnaissance d’intention.

Paramètres

  • speechConfig Configuration vocale.

  • audioInput Configuration audio.

Retours

Instance du module de reconnaissance d’intention.

FromConfig

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

Crée un module de reconnaissance d’intention à partir d’une configuration vocale incorporée et d’une configuration audio. Les utilisateurs doivent utiliser cette fonction pour créer un instance d’un module de reconnaissance d’intention. Ajouté dans la version 1.19.0.

Paramètres

  • speechConfig Configuration vocale incorporée.

  • audioInput Configuration audio.

Retours

Instance du module de reconnaissance d’intention.

BaseType

Syntaxe : typedef BaseType;