Dela via

class Intent::IntentRecognizer

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

Förutom att utföra tal-till-text-igenkänning extraherar IntentRecognizer strukturerad information om talarens avsikt, som kan användas för att driva ytterligare åtgärder med dedikerade avsiktsutlösare (se IntentTrigger).

Medlemmar

Egenskaper

Syntax: public PropertyCollection & Properties;

En samling egenskaper och deras värden som definierats för denna IntentRecognizer.

IntentRecognizer

Syntax: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Intern konstruktor. Skapar en ny instans med hjälp av den angivna referensen.

Parametrar

  • hreco Handtag för identifierare.

~IntentRecognizer

Syntax: public inline ~IntentRecognizer ( );

Destructor

RecognizeOnceAsync

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

Startar avsiktsigenkänning och returnerar när ett enda yttrande identifieras. Slutet på ett enda yttrande bestäms genom att lyssna efter tystnad i slutet eller tills högst 15 sekunders ljud bearbetas. Uppgiften returnerar igenkänningstexten som resultat. Obs! Eftersom RecognizeOnceAsync() endast returnerar ett enda yttrande är det endast lämpligt för enstaka igenkänning som kommando eller fråga. För långvarig igenkänning av flera yttranden använder du StartContinuousRecognitionAsync() i stället.

Returer

Framtida innehållande resultatvärde (en delad pekare till IntentRecognitionResult) för den asynkrona avsiktsigenkänningen.

RecognizeOnceAsync

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

Startar avsiktsigenkänning och genererar ett resultat från den text som skickas in. Detta är användbart för testning och andra gånger när talindata inte är knutna till IntentRecognizer. Obs! Avsiktstjänsten stöder för närvarande inte detta, så den är endast giltig för matchning av offlinemönster eller exakta matchande avsikter.

Parametrar

  • text Texten som ska utvärderas.

Returer

Framtida innehållande resultatvärde (en delad pekare till IntentRecognitionResult) för den asynkrona avsiktsigenkänningen.

StartContinuousRecognitionAsync

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

Initierar kontinuerlig avsiktsigenkänning asynkront.

Returer

En tom framtid.

StopContinuousRecognitionAsync

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

Asynkront avslutar pågående kontinuerlig avsiktsigenkänning.

Returer

En tom framtid.

StartKeywordRecognitionAsync

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

Initierar nyckelordsigenkänning asynkront.

Parametrar

  • model Anger den nyckelordsmodell som ska användas.

Returer

En tom framtid.

StopKeywordRecognitionAsync

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

Asynkront avslutar åtgärden för nyckelordsigenkänning.

Returer

En tom framtid.

Lägg tillIntent

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

Lägger till en enkel fras som kan talas av användaren, vilket anger en specifik användar avsikt. Den här enkla frasen kan vara ett mönster, inklusive och enititet omgiven av klammerparenteser. Till exempel "klicka på kryssrutan {checkboxName}".

Parametrar

  • simplePhrase Frasen som motsvarar avsikten.

När intentRecognitionResult har identifierats matchar egenskapen IntentId den simplePhrase som anges här. Om entiteter anges och matchas blir de tillgängliga i IntentResult-GetEntities()->anropet.

Lägg tillIntent

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

Lägger till en enkel fras som kan talas av användaren, vilket anger en specifik användar avsikt. Den här enkla frasen kan vara ett mönster, inklusive och enititet omgiven av klammerparenteser. Till exempel "klicka på kryssrutan {checkboxName}".

Parametrar

  • simplePhrase Frasen som motsvarar avsikten.

  • intentId En anpassad ID-sträng som ska returneras i IntentRecognitionResults IntentId-egenskap.

När det har identifierats matchar resultatets avsikts-ID det ID som anges här. Om entiteter anges och matchas blir de tillgängliga i IntentResult-GetEntities()->anropet.

Lägg tillIntent

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

Lägger till en enda avsikt efter namn från den angivna Language Understanding-modellen. För typerna PatternMatchingModel och ConversationalLanguageUnderstandingModel rensas alla befintliga modeller innan de aktiveras. För dessa typer ignoreras intentName.

Parametrar

  • model Modellen för språktolkning som innehåller avsikten.

  • intentName Namnet på den enda avsikt som ska ingå i modellen för språktolkning.

När intentRecognitionResults IntentId-egenskap har identifierats innehåller den intentName som anges här.

Lägg tillIntent

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

Lägger till en enda avsikt efter namn från den angivna Language Understanding-modellen. För typerna PatternMatchingModel och ConversationalLanguageUnderstandingModel rensas alla befintliga modeller innan de aktiveras. För dessa typer ignoreras intentName och intentId.

Parametrar

  • model Modellen för språktolkning som innehåller avsikten.

  • intentName Namnet på den enda avsikt som ska ingå i modellen för språktolkning.

  • intentId En anpassad ID-sträng som ska returneras i IntentRecognitionResults IntentId-egenskap.

AddAllIntents

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

Lägger till alla avsikter från den angivna Language Understanding-modellen. För typerna PatternMatchingModel och ConversationalLanguageUnderstandingModel rensas alla befintliga modeller innan de aktiveras.

Parametrar

  • model Modellen för språktolkning som innehåller avsikterna.

När avsikten har identifierats innehåller IntentRecognitionResults intentId-egenskap namnet på den identifierade avsikten.

AddAllIntents

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

Lägger till alla avsikter från den angivna Language Understanding-modellen. För typerna PatternMatchingModel och ConversationalLanguageUnderstandingModel rensas alla befintliga modeller innan de aktiveras.

Parametrar

  • model Modellen för språktolkning som innehåller avsikterna.

  • intentId Ett anpassat sträng-ID som ska returneras i intentRecognitionResults IntentId-egenskap.

Lägg tillIntent

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

Lägger till den intentTrigger som angetts.

Parametrar

  • trigger IntentTrigger som motsvarar avsikten.

  • intentId Ett anpassat sträng-ID som ska returneras i intentRecognitionResults IntentId-egenskap.

SetAuthorizationToken

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

Anger den auktoriseringstoken som ska användas för att ansluta till tjänsten. Obs! Anroparen måste se till att auktoriseringstoken är giltig. Innan auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här inställningen med en ny giltig token. Annars uppstår fel i igenkänningen under igenkänningen.

Parametrar

  • token En sträng som representerar auktoriseringstoken.

GetAuthorizationToken

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

Hämtar auktoriseringstoken.

Returer

Auktoriseringstoken

ApplyLanguageModels

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

Tar en samling modeller för språktolkning, gör en kopia av dem och tillämpar dem på identifieraren. Det här programmet inträffar vid olika tidpunkter beroende på modelltypen för språktolkning. Enkla språkmodeller aktiveras nästan omedelbart medan modeller för språktolkning som använder LUIS blir aktiva vid nästa talvändning. Detta ersätter alla tidigare tillämpade modeller.

Parametrar

  • collection En vektor med delade pekare till LanguageUnderstandingModels.

Returer

Sant om tillämpningen av modellerna börjar gälla omedelbart. Annars falskt.

FromConfig

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

Skapar en avsiktsigenkänning från en talkonfiguration och en ljudkonfiguration. Användare bör använda den här funktionen för att skapa en ny instans av en avsiktsigenkänning.

Parametrar

  • speechConfig Talkonfiguration.

  • audioInput Ljudkonfiguration.

Returer

Instans av avsiktsigenkänning.

FromConfig

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

Skapar en avsiktsigenkänning från en inbäddad talkonfiguration och en ljudkonfiguration. Användare bör använda den här funktionen för att skapa en ny instans av en avsiktsigenkänning. Har lagts till i version 1.19.0.

Parametrar

  • speechConfig Inbäddad talkonfiguration.

  • audioInput Ljudkonfiguration.

Returer

Instans av avsiktsigenkänning.

BaseType

Syntax: typedef BaseType;