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 köra ytterligare åtgärder med hjälp av 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 det angivna handtaget.

Parametrar

  • hreco Recognizer-handtag.

~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 har identifierats. Slutet på ett enskilt yttrande bestäms genom att lyssna efter tystnad i slutet eller tills högst cirka 30 sekunders ljud bearbetas. Uppgiften returnerar igenkänningstexten som resultat. Obs! Eftersom RecognizeOnceAsync() endast returnerar ett enda yttrande är det endast lämpligt för enkel bildigenkänning som kommando eller fråga. För långvarig igenkänning av flera yttranden använder du StartContinuousRecognitionAsync() i stället..

Returnerar

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

Returnerar

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 asynkront kontinuerlig avsiktsigenkänning.

Returnerar

En tom framtid.

StopContinuousRecognitionAsync

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

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

Returnerar

En tom framtid.

StartKeywordRecognitionAsync

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

Initierar asynkront nyckelordsigenkänning.

Parametrar

  • model Anger den nyckelordsmodell som ska användas.

Returnerar

En tom framtid.

StopKeywordRecognitionAsync

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

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

Returnerar

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 med och enititet omgiven av klammerparenteser. Till exempel "klicka på kryssrutan {checkboxName}".

Parametrar

  • simplePhrase Frasen som motsvarar avsikten.

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

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 med 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 anropet IntentResult–>GetEntities().

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 Språktolkningsmodellen som innehåller avsikten.

  • intentName Namnet på den enda avsikt som ska ingå i språktolkningsmodellen.

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 Språktolkningsmodellen som innehåller avsikten.

  • intentName Namnet på den enda avsikt som ska ingå i språktolkningsmodellen.

  • 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 Språktolkningsmodellen som innehåller avsikterna.

När avsikten har identifierats innehåller egenskapen IntentRecognitionResult egenskapen IntentId 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 Språktolkningsmodellen 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 settern med en ny giltig token. Annars kommer identifieraren att stöta på fel under igenkänningen.

Parametrar

  • token En sträng som representerar auktoriseringstoken.

GetAuthorizationToken

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

Hämtar auktoriseringstoken.

Returnerar

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 blir aktiva nästan omedelbart medan språktolkningsmodeller som använder LUIS blir aktiva vid nästa talsväng. Detta ersätter alla tidigare tillämpade modeller.

Parametrar

  • collection En vektor med delade pekare till LanguageUnderstandingModels.

Returnerar

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 Speech-konfiguration.

  • audioInput Ljudkonfiguration.

Returnerar

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.

Returnerar

Instans av avsiktsigenkänning.

BaseType

Syntax: typedef BaseType;