Delen via

class Intent::IntentRecognizer

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

Naast het uitvoeren van spraak-naar-tekstherkenning, extraheert intentRecognizer gestructureerde informatie over de intentie van de spreker, die kan worden gebruikt om verdere acties te stimuleren 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 retourneert nadat één uiting is herkend. Het einde van één uiting wordt bepaald door te luisteren naar stilte aan het einde of tot een maximum van 15 seconden audio is verwerkt. De taak retourneert de herkenningstekst als resultaat. Opmerking: Omdat RecognizeOnceAsync() slechts één utterance retourneert, is het alleen geschikt voor single shot-herkenning, zoals een opdracht of query. Voor langdurige herkenning van meerdere uitingen gebruikt u in plaats daarvan StartContinuousRecognitionAsync().

Retouren

Future met resultaatwaarde (een gedeelde pointer naar IntentRecognitionResult) van de asynchrone intentieherkenning.

RecognizeOnceAsync

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

Start intentieherkenning en genereert een resultaat van de doorgegeven tekst. Dit is handig voor het testen en op andere momenten wanneer de spraakinvoer niet is gekoppeld aan de IntentRecognizer. Opmerking: de Intent-service ondersteunt dit momenteel niet, dus is deze alleen geldig voor offlinepatroonovereenkomsten of exacte overeenkomende intenties.

Parameters

  • text De tekst die moet worden geëvalueerd.

Retouren

Future met resultaatwaarde (een gedeelde pointer naar IntentRecognitionResult) van de asynchrone intentieherkenning.

StartContinuousRecognitionAsync

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

Asynchroon initieert continue intentieherkenningsbewerking.

Retouren

Een lege toekomst.

StopContinuousRecognitionAsync

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

Asynchroon beëindigt doorlopende bewerking voor het herkennen van intenties.

Retouren

Een lege toekomst.

StartKeywordRecognitionAsync

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

Asynchroon initieert de bewerking voor het herkennen van trefwoorden.

Parameters

  • model Hiermee geeft u het trefwoordmodel dat moet worden gebruikt.

Retouren

Een lege toekomst.

StopKeywordRecognitionAsync

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

Hiermee wordt de bewerking voor trefwoordherkenning asynchroon beëindigd.

Retouren

Een lege toekomst.

AddIntent

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

Voegt een eenvoudige woordgroep toe die door de gebruiker kan worden uitgesproken, waarmee een specifieke gebruikersintentie wordt aangegeven. Deze eenvoudige zin 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 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 door de gebruiker kan worden uitgesproken, waarmee een specifieke gebruikersintentie wordt aangegeven. Deze eenvoudige zin 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 intentRecognitionResult-eigenschap IntentId.

Zodra deze is herkend, komt de intentie-id van het resultaat overeen met de id 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 ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );

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

Parameters

  • model Het language understanding-model met de intentie.

  • intentName De naam van de intentie die moet worden opgenomen in het taalkennismodel.

Zodra de eigenschap IntentRecognitionResult is herkend, bevat de intentId die hier is opgegeven.

AddIntent

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

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

Parameters

  • model Het language understanding-model met de intentie.

  • intentName De naam van de intentie die moet worden opgenomen in het taalkennismodel.

  • intentId Een aangepaste id-tekenreeks die moet worden geretourneerd in de intentRecognitionResult-eigenschap 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 deze worden ingeschakeld.

Parameters

  • model Het taalkennismodel met de intenties.

Zodra de eigenschap IntentRecognitionResult is herkend, bevat de eigenschap 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 deze worden ingeschakeld.

Parameters

  • model Het taalkennismodel met de intenties.

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

AddIntent

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

Voegt de IntentTrigger opgegeven toe.

Parameters

  • trigger De IntentTrigger die overeenkomt met de intentie.

  • intentId Een aangepaste tekenreeks-id die moet worden geretourneerd in de eigenschap IntentRecognitionResult van de 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 treedt de herkenning op 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.

Retouren

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 herkenningsfunctie. Deze toepassing vindt op verschillende tijdstippen plaats, afhankelijk van het modeltype voor taalkennis. Eenvoudige taalmodellen worden vrijwel onmiddellijk actief, terwijl taalverstaanmodellen die gebruikmaken van LUIS, actief worden bij de volgende Spraak-beurt. Dit vervangt alle eerder toegepaste modellen.

Parameters

  • collection Een vector van gedeelde pointers naar LanguageUnderstandingModels.

Retouren

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 Spraakconfiguratie.

  • audioInput Audioconfiguratie.

Retouren

Exemplaar van intentieherkenning.

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 Configuratie van ingesloten spraak.

  • audioInput Audioconfiguratie.

Retouren

Exemplaar van intentieherkenning.

BaseType

Syntaxis: typedef BaseType;