Delen via

klasse Intent::IntentRecognizer

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

Naast het uitvoeren van spraak-naar-tekstherkenning extraheert de IntentRecognizer gestructureerde informatie over de intentie van de spreker, die kan worden gebruikt voor verdere acties met behulp van toegewezen intentietriggers (zie IntentTrigger).

Leden

Eigenschappen

Syntaxis: public PropertyCollection & Properties;

Een verzameling eigenschappen en de bijbehorende waarden die zijn gedefinieerd voor deze IntentRecognizer.

IntentRecognizer

Syntaxis: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Interne constructor. Hiermee maakt u een nieuw exemplaar met behulp van de opgegeven ingang.

Parameters

  • hreco Recognizer-ingang.

~IntentRecognizer

Syntaxis: public inline ~IntentRecognizer ( );

destructor

RecognizeOnceAsync

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

Start intentieherkenning en wordt geretourneerd nadat één uiting is herkend. Het einde van één uiting wordt bepaald door te luisteren naar stilte aan het einde of totdat een maximum van ongeveer 30 seconden audio wordt verwerkt. De taak retourneert de herkenningstekst als resultaat. Opmerking: Aangezien RecognizeOnceAsync() slechts één uiting retourneert, is deze alleen geschikt voor eenmalige opnameherkenning, zoals opdracht of query. Gebruik in plaats daarvan StartContinuousRecognitionAsync() voor langdurige multi-utteranceherkenning.

Retourneert

De toekomst met resultaatwaarde (een gedeelde aanwijzer naar IntentRecognitionResult) van de asynchrone intentieherkenning.

RecognizeOnceAsync

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

Hiermee wordt intentieherkenning gestart en wordt een resultaat gegenereerd van de tekst die is doorgegeven. Dit is handig voor testen en andere tijden wanneer de spraakinvoer niet is gekoppeld aan de IntentRecognizer. Opmerking: De Intent Service biedt momenteel geen ondersteuning voor dit, zodat deze alleen geldig is voor het vergelijken van offlinepatronen of exacte overeenkomende intenties.

Parameters

  • text de tekst die moet worden geëvalueerd.

Retourneert

De toekomst met resultaatwaarde (een gedeelde aanwijzer naar IntentRecognitionResult) van de asynchrone intentieherkenning.

StartContinuousRecognitionAsync

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

Asynchroon initieert continue intentieherkenningsbewerking.

Retourneert

Een lege toekomst.

StopContinuousRecognitionAsync

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

Asynchroon beëindigt de doorlopende continue intentieherkenningsbewerking.

Retourneert

Een lege toekomst.

StartKeywordRecognitionAsync

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

Asynchroon start de bewerking voor het herkennen van trefwoorden.

Parameters

  • model Geeft het trefwoordmodel op dat moet worden gebruikt.

Retourneert

Een lege toekomst.

StopKeywordRecognitionAsync

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

Asynchroon beëindigt de bewerking voor het herkennen van trefwoorden.

Retourneert

Een lege toekomst.

AddIntent

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

Voegt een eenvoudige woordgroep toe die kan worden gesproken door de gebruiker, waarmee een specifieke gebruikersintentie wordt aangegeven. Deze eenvoudige woordgroep kan een patroon zijn, inclusief enititeit tussen accolades. Zoals 'klik op het selectievakje {checkboxName}'.

Parameters

  • simplePhrase de woordgroep die overeenkomt met de intentie.

Zodra de eigenschap IntentRecognitionResult van IntentRecognitionResult is herkend, komt deze overeen met de simplePhrase die hier is opgegeven. Als er entiteiten zijn opgegeven en overeenkomen, zijn deze beschikbaar in de aanroep IntentResult->GetEntities().

AddIntent

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

Voegt een eenvoudige woordgroep toe die kan worden gesproken door de gebruiker, waarmee een specifieke gebruikersintentie wordt aangegeven. Deze eenvoudige woordgroep kan een patroon zijn, inclusief enititeit tussen accolades. Zoals 'klik op het selectievakje {checkboxName}'.

Parameters

  • simplePhrase de woordgroep die overeenkomt met de intentie.

  • intentId een aangepaste id-tekenreeks die moet worden geretourneerd in de eigenschap IntentRecognitionResult van IntentId.

Nadat de intentie-id van het resultaat is herkend, komt deze overeen met de id die hier wordt opgegeven. Als er entiteiten zijn opgegeven en overeenkomen, zijn deze beschikbaar in de aanroep IntentResult->GetEntities().

AddIntent

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

Hiermee voegt u één intentie toe op naam van het opgegeven Language Understanding-model. Voor de typen PatternMatchingModel en ConversationalLanguageUnderstandingModel worden alle bestaande modellen gewist voordat u deze inschakelt. Voor deze typen wordt de intentName genegeerd.

Parameters

  • model Het taalkennismodel met de intentie.

  • intentName de naam van de intentie die moet worden opgenomen in het language understanding-model.

Zodra de eigenschap IntentRecognitionResult van IntentRecognitionResult is herkend, bevat deze de intentName die hier is opgegeven.

AddIntent

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

Hiermee voegt u één intentie toe op naam van het opgegeven Language Understanding-model. Voor de typen PatternMatchingModel en ConversationalLanguageUnderstandingModel worden alle bestaande modellen gewist voordat u deze inschakelt. Voor deze typen worden de intentName en intentId genegeerd.

Parameters

  • model Het taalkennismodel met de intentie.

  • intentName de naam van de intentie die moet worden opgenomen in het language understanding-model.

  • intentId een aangepaste id-tekenreeks die moet worden geretourneerd in de eigenschap IntentRecognitionResult van IntentId.

AddAllIntents

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

Hiermee worden alle intenties van het opgegeven Language Understanding-model toegevoegd. Voor de typen PatternMatchingModel en ConversationalLanguageUnderstandingModel worden alle bestaande modellen gewist voordat u deze inschakelt.

Parameters

  • model Het taalkennismodel met de intenties.

Nadat de intentie is herkend, bevat de eigenschap IntentRecognitionResult van intentId de naam van de herkende intentie.

AddAllIntents

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

Hiermee worden alle intenties van het opgegeven Language Understanding-model toegevoegd. Voor de typen PatternMatchingModel en ConversationalLanguageUnderstandingModel worden alle bestaande modellen gewist voordat u deze inschakelt.

Parameters

  • model Het taalkennismodel met de intenties.

  • intentId Een aangepaste tekenreeks-id die moet worden geretourneerd in de intentRecognitionResult-eigenschap IntentId.

AddIntent

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

Hiermee voegt u de opgegeven IntentTrigger toe.

Parameters

  • trigger IntentTrigger die overeenkomt met de intentie.

  • intentId Een aangepaste tekenreeks-id die moet worden geretourneerd in de intentRecognitionResult-eigenschap IntentId.

SetAuthorizationToken

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

Hiermee stelt u het autorisatietoken in dat wordt gebruikt om verbinding te maken met de service. Opmerking: De aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door deze setter aan te roepen met een nieuw geldig token. Anders ondervindt de recognizer fouten tijdens de herkenning.

Parameters

  • token een tekenreeks die het autorisatietoken vertegenwoordigt.

GetAuthorizationToken

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

Hiermee haalt u het autorisatietoken op.

Retourneert

Autorisatietoken

ApplyLanguageModels

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

Neemt een verzameling taalkennismodellen, maakt er een kopie van en past deze toe op de recognizer. Deze toepassing vindt op verschillende tijdstippen plaats, afhankelijk van het modeltype language understanding. Eenvoudige taalmodellen worden vrijwel onmiddellijk actief, terwijl taalkennismodellen die gebruikmaken van LUIS, actief worden op de volgende spraakdraai. Hiermee worden eerder toegepaste modellen vervangen.

Parameters

  • collection A vector van gedeelde aanwijzers naar LanguageUnderstandingModels.

Retourneert

Is waar als de toepassing van de modellen onmiddellijk van kracht wordt. Anders onwaar.

FromConfig

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

Hiermee maakt u een intentieherkenning op basis van een spraakconfiguratie en een audioconfiguratie. Gebruikers moeten deze functie gebruiken om een nieuw exemplaar van een intentieherkenning te maken.

Parameters

  • speechConfig Speech-configuratie.

  • audioInput audioconfiguratie.

Retourneert

Instantie van intent recognizer.

FromConfig

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

Hiermee maakt u een intentieherkenning op basis van een ingesloten spraakconfiguratie en een audioconfiguratie. Gebruikers moeten deze functie gebruiken om een nieuw exemplaar van een intentieherkenning te maken. Toegevoegd in versie 1.19.0.

Parameters

  • speechConfig ingesloten spraakconfiguratie.

  • audioInput audioconfiguratie.

Retourneert

Instantie van intent recognizer.

BaseType

Syntaxis: typedef BaseType;