Share via

class Intent::IntentRecognizer

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

A beszéd-szövegfelismerés mellett az IntentRecognizer strukturált információkat nyer ki a beszélő szándékáról, amelyekkel további műveleteket hajthat végre dedikált szándék-eseményindítók használatával (lásd : IntentTrigger).

Tagok

Tulajdonságok

Szintaxis: public PropertyCollection & Properties;

Az IntentRecognizerhez definiált tulajdonságok és azok értékeinek gyűjteménye.

IntentRecognizer

Szintaxis: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Belső konstruktor. Létrehoz egy új példányt a megadott leíróval.

Paraméterek

  • hreco Recognizer leíró.

~IntentRecognizer

Szintaxis: public inline ~IntentRecognizer ( );

Destruktor

RecognizeOnceAsync

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

Elindítja a szándékfelismerést, és egyetlen kimondott szöveg felismerése után ad vissza. Egyetlen kimondott szöveg végét a csend hallgatása határozza meg a végén, vagy legfeljebb 15 másodpercnyi hang feldolgozásáig. A feladat ennek eredményeként visszaadja a felismerési szöveget. Megjegyzés: Mivel a RecognizeOnceAsync() csak egyetlen kimondott szöveget ad vissza, csak egyetlen lövéses felismeréshez, például parancshoz vagy lekérdezéshez alkalmas. A hosszan futó több kimondott szöveg felismeréséhez használja helyette a StartContinuousRecognitionAsync() parancsot.

Válaszok

Az aszinkron szándékfelismerés eredményértékét (az IntentRecognitionResult elemhez tartozó megosztott mutatót) tartalmazó jövő.

RecognizeOnceAsync

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

Elindítja a szándékfelismerést, és létrehoz egy eredményt a megadott szövegből. Ez teszteléshez és más olyan esetekben hasznos, amikor a beszédbevitel nincs az IntentRecognizerhez kötve. Megjegyzés: Az Intent Service jelenleg nem támogatja ezt, ezért csak offline mintaegyeztetéshez vagy pontos egyező szándékokhoz érvényes.

Paraméterek

  • text A kiértékelendő szöveg.

Válaszok

Az aszinkron szándékfelismerés eredményértékét (az IntentRecognitionResult elemhez tartozó megosztott mutatót) tartalmazó jövő.

StartContinuousRecognitionAsync

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

Aszinkron módon elindítja a folyamatos szándékfelismerési műveletet.

Válaszok

Üres jövő.

StopContinuousRecognitionAsync

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

Aszinkron módon leállítja a folyamatos szándékfelismerési műveletet.

Válaszok

Üres jövő.

StartKeywordRecognitionAsync

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

Aszinkron módon elindítja a kulcsszófelismerési műveletet.

Paraméterek

  • model Megadja a használni kívánt kulcsszómodellt.

Válaszok

Üres jövő.

StopKeywordRecognitionAsync

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

Aszinkron módon leállítja a kulcsszófelismerési műveletet.

Válaszok

Üres jövő.

AddIntent

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

Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot. Ez az egyszerű kifejezés lehet egy minta, beleértve és az irigység körül kapcsos zárójelek. Például: "kattintson a {checkboxName} jelölőnégyzetre".

Paraméterek

  • simplePhrase A szándéknak megfelelő kifejezés.

A felismerés után az IntentRecognitionResult IntentId tulajdonsága megegyezik az itt megadott simplePhrase értékével. Ha bármely entitás meg van adva és megfeleltetve van, azok elérhetők lesznek az IntentResult-GetEntities>() hívásban.

AddIntent

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

Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot. Ez az egyszerű kifejezés lehet egy minta, beleértve és az irigység körül kapcsos zárójelek. Például: "kattintson a {checkboxName} jelölőnégyzetre".

Paraméterek

  • simplePhrase A szándéknak megfelelő kifejezés.

  • intentId Az IntentRecognitionResult IntentId tulajdonságában visszaadandó egyéni azonosító sztring.

A felismerés után az eredmény szándékazonosítója megegyezik az itt megadott azonosítóval. Ha bármely entitás meg van adva és megfeleltetve van, azok elérhetők lesznek az IntentResult-GetEntities>() hívásban.

AddIntent

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

Egyetlen szándékot ad hozzá név szerint a megadott Language Understanding modellből. A PatternMatchingModel és a ConversationalLanguageUnderstandingModel típusok esetében ez az engedélyezés előtt törli a meglévő modelleket. Ilyen típusok esetén a rendszer figyelmen kívül hagyja az intentName tulajdonságot.

Paraméterek

  • model A szándékot tartalmazó nyelvfelismerési modell.

  • intentName A nyelvfelismerési modellben szerepeltetni kívánt egyetlen szándék neve.

A felismerése után az IntentRecognitionResult IntentId tulajdonsága tartalmazni fogja az itt megadott intentName tulajdonságot.

AddIntent

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

Egyetlen szándékot ad hozzá név szerint a megadott Language Understanding modellből. A PatternMatchingModel és a ConversationalLanguageUnderstandingModel típusok esetében ez az engedélyezés előtt törli a meglévő modelleket. Ilyen típusok esetén a rendszer figyelmen kívül hagyja az intentName és az intentId azonosítót.

Paraméterek

  • model A szándékot tartalmazó nyelvfelismerési modell.

  • intentName A nyelvfelismerési modellben szerepeltetni kívánt egyetlen szándék neve.

  • intentId Az IntentRecognitionResult IntentId tulajdonságában visszaadandó egyéni azonosító sztring.

AddAllIntents

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

Hozzáadja a megadott Language Understanding modell összes szándékát. A PatternMatchingModel és a ConversationalLanguageUnderstandingModel típusok esetében ez az engedélyezés előtt törli a meglévő modelleket.

Paraméterek

  • model A szándékokat tartalmazó nyelvfelismerési modell.

A felismerés után az IntentRecognitionResult IntentId tulajdonsága tartalmazni fogja a felismert szándék nevét.

AddAllIntents

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

Hozzáadja a megadott Language Understanding modell összes szándékát. A PatternMatchingModel és a ConversationalLanguageUnderstandingModel típusok esetében ez az engedélyezés előtt törli a meglévő modelleket.

Paraméterek

  • model A szándékokat tartalmazó nyelvfelismerési modell.

  • intentId Az IntentRecognitionResult IntentId tulajdonságában visszaadandó egyéni sztringazonosító.

AddIntent

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

Hozzáadja a megadott IntentTriggert.

Paraméterek

  • trigger A szándéknak megfelelő IntentTrigger.

  • intentId Az IntentRecognitionResult IntentId tulajdonságában visszaadandó egyéni sztringazonosító.

SetAuthorizationToken

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

Beállítja a szolgáltatáshoz való csatlakozáshoz használni kívánt engedélyezési jogkivonatot. Megjegyzés: A hívónak meg kell győződnie arról, hogy az engedélyezési jogkivonat érvényes. Az engedélyezési jogkivonat lejárata előtt a hívónak frissítenie kell azt úgy, hogy meghívja ezt a beállítót egy új érvényes jogkivonattal. Ellenkező esetben a felismerő hibákat fog tapasztalni a felismerés során.

Paraméterek

  • token Az engedélyezési jogkivonatot jelölő sztring.

GetAuthorizationToken

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

Lekéri az engedélyezési jogkivonatot.

Válaszok

Engedélyezési jogkivonat

ApplyLanguageModels

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

Nyelvfelismerési modellek gyűjteményét használja, másolatot készít róluk, és alkalmazza őket a felismerőre. Ez az alkalmazás a nyelvfelismerési modell típusától függően különböző időpontokban történik. Az egyszerű nyelvi modellek szinte azonnal aktívvá válnak, míg a LUIS-t használó nyelvfelismerési modellek a következő Beszédforduló során válnak aktívvá. Ez lecseréli a korábban alkalmazott modelleket.

Paraméterek

  • collection A LanguageUnderstandingModels közös mutatóinak vektora.

Válaszok

Igaz, ha a modellek alkalmazása azonnal érvénybe lép. Egyéb esetben hamis.

FromConfig

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

Szándékfelismerőt hoz létre egy beszédkonfigurálásból és egy hangkonfigurálásból. A felhasználóknak ezt a függvényt kell használniuk egy szándék felismerő új példányának létrehozásához.

Paraméterek

  • speechConfig Beszédkonfiguráció.

  • audioInput Hangkonfiguráció.

Válaszok

Szándék felismerőjének példánya.

FromConfig

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

Szándékfelismerőt hoz létre egy beágyazott beszédkonfigurálásból és egy hangkonfigurálásból. A felhasználóknak ezt a függvényt kell használniuk egy szándék felismerő új példányának létrehozásához. Hozzáadva az 1.19.0-s verzióhoz.

Paraméterek

  • speechConfig Beágyazott beszédkonfiguráció.

  • audioInput Hangkonfiguráció.

Válaszok

Szándék felismerőjének példánya.

Alaptípus

Szintaxis: typedef BaseType;