Udostępnij za pośrednictwem

class Intent::IntentRecognizer

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

Oprócz rozpoznawania mowy na tekst funkcja IntentRecognizer wyodrębnia ustrukturyzowane informacje o intencji osoby mówiącej, które mogą służyć do kierowania dalszymi akcjami przy użyciu dedykowanych wyzwalaczy intencji (zobacz IntentTrigger).

Członków

Właściwości

Składnia: public PropertyCollection & Properties;

Kolekcja właściwości i ich wartości zdefiniowanych dla tej intencjiRecognizer.

IntentRecognizer

Składnia: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Konstruktor wewnętrzny. Tworzy nowe wystąpienie przy użyciu podanego dojścia.

Parametry

  • hreco uchwyt rozpoznawania.

~IntentRecognizer

Składnia: public inline ~IntentRecognizer ( );

destruktor

RecognizeOnceAsync

Składnia: public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

Uruchamia rozpoznawanie intencji i zwraca wartość po rozpoznaniu pojedynczej wypowiedzi. Koniec jednej wypowiedzi zależy od nasłuchiwania ciszy na końcu lub do czasu przetworzenia maksymalnie 30 sekund dźwięku. Zadanie zwraca tekst rozpoznawania w wyniku. Uwaga: Ponieważ funkcja RecognizeOnceAsync() zwraca tylko jedną wypowiedź, nadaje się tylko do rozpoznawania pojedynczego strzału, takiego jak polecenie lub zapytanie. W przypadku długotrwałego rozpoznawania wielu wypowiedzi zamiast tego użyj polecenia StartContinuousRecognitionAsync().

Zwraca

Przyszłość zawierająca wartość wyniku (współużytkowany wskaźnik na IntentRecognitionResult) rozpoznawania intencji asynchronicznej.

RecognizeOnceAsync

Składnia: public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

Uruchamia rozpoznawanie intencji i generuje wynik z przekazanego tekstu. Jest to przydatne w przypadku testowania i innych przypadków, gdy dane wejściowe mowy nie są powiązane z intencjąRecognizer. Uwaga: Usługa Intent Service nie obsługuje obecnie tej funkcji, dlatego jest ona prawidłowa tylko w przypadku dopasowywania wzorca w trybie offline lub dokładnego dopasowania intencji.

Parametry

  • text Tekst, który ma zostać oceniony.

Zwraca

Przyszłość zawierająca wartość wyniku (współużytkowany wskaźnik na IntentRecognitionResult) rozpoznawania intencji asynchronicznej.

StartContinuousRecognitionAsync

Składnia: public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

Asynchronicznie inicjuje operację ciągłego rozpoznawania intencji.

Zwraca

Pusta przyszłość.

StopContinuousRecognitionAsync

Składnia: public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

Asynchronicznie kończy ciągłą operację rozpoznawania intencji.

Zwraca

Pusta przyszłość.

StartKeywordRecognitionAsync

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

Asynchronicznie inicjuje operację rozpoznawania słów kluczowych.

Parametry

  • model Określa model słów kluczowych do użycia.

Zwraca

Pusta przyszłość.

StopKeywordRecognitionAsync

Składnia: public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

Asynchronicznie kończy operację rozpoznawania słów kluczowych.

Zwraca

Pusta przyszłość.

AddIntent

Składnia: public inline void AddIntent ( const std::string & simplePhrase );

Dodaje prostą frazę, która może być wypowiadana przez użytkownika, wskazująca konkretną intencję użytkownika. Ta prosta fraza może być wzorcem obejmującym i enitity otoczonym nawiasami klamrowymi. Na przykład "kliknij pole wyboru {checkboxName}".

Parametry

  • simplePhrase Fraza odpowiadająca intencji.

Po rozpoznaniu właściwość IntentRecognitionResult's IntentId będzie zgodna z wartością simplePhrase określoną tutaj. Jeśli jakiekolwiek jednostki są określone i dopasowane, będą one dostępne w wywołaniu IntentResult->GetEntities().

AddIntent

Składnia: public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

Dodaje prostą frazę, która może być wypowiadana przez użytkownika, wskazująca konkretną intencję użytkownika. Ta prosta fraza może być wzorcem obejmującym i enitity otoczonym nawiasami klamrowymi. Na przykład "kliknij pole wyboru {checkboxName}".

Parametry

  • simplePhrase Fraza odpowiadająca intencji.

  • intentId Ciąg identyfikatora niestandardowego, który ma zostać zwrócony we właściwości IntentRecognitionResult's IntentId.

Po rozpoznaniu identyfikator intencji wyniku będzie zgodny z identyfikatorem podanym tutaj. Jeśli jakiekolwiek jednostki są określone i dopasowane, będą one dostępne w wywołaniu IntentResult->GetEntities().

AddIntent

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

Dodaje pojedynczą intencję według nazwy z określonego modelu usługi Language Understanding. W przypadku typów PatternMatchingModel i ConversationalLanguageUnderstandingModel spowoduje to wyczyszczenie wszystkich istniejących modeli przed jego włączeniem. W przypadku tych typów intencjaName jest ignorowana.

Parametry

  • model Model interpretacji języka zawierający intencję.

  • intentName Nazwa pojedynczej intencji, która ma zostać uwzględniona w modelu interpretacji języka.

Po rozpoznaniu właściwość IntentRecognitionResult IntentId będzie zawierać wartość intentName określoną tutaj.

AddIntent

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

Dodaje pojedynczą intencję według nazwy z określonego modelu usługi Language Understanding. W przypadku typów PatternMatchingModel i ConversationalLanguageUnderstandingModel spowoduje to wyczyszczenie wszystkich istniejących modeli przed jego włączeniem. W przypadku tych typów intencjaName i intentId są ignorowane.

Parametry

  • model Model interpretacji języka zawierający intencję.

  • intentName Nazwa pojedynczej intencji, która ma zostać uwzględniona w modelu interpretacji języka.

  • intentId Ciąg identyfikatora niestandardowego, który ma zostać zwrócony we właściwości IntentRecognitionResult's IntentId.

AddAllIntents

Składnia: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

Dodaje wszystkie intencje z określonego modelu usługi Language Understanding. W przypadku typów PatternMatchingModel i ConversationalLanguageUnderstandingModel spowoduje to wyczyszczenie wszystkich istniejących modeli przed jego włączeniem.

Parametry

  • model Model interpretacji języka zawierający intencje.

Po rozpoznaniu właściwość IntentRecognitionResult's IntentId będzie zawierać nazwę rozpoznanej intencji.

AddAllIntents

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

Dodaje wszystkie intencje z określonego modelu usługi Language Understanding. W przypadku typów PatternMatchingModel i ConversationalLanguageUnderstandingModel spowoduje to wyczyszczenie wszystkich istniejących modeli przed jego włączeniem.

Parametry

  • model Model interpretacji języka zawierający intencje.

  • intentId Identyfikator ciągu niestandardowego, który ma zostać zwrócony we właściwości IntentRecognitionResult's IntentId.

AddIntent

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

Dodaje określony element IntentTrigger.

Parametry

  • trigger IntencjaTrigger odpowiadająca intencji.

  • intentId Identyfikator ciągu niestandardowego, który ma zostać zwrócony we właściwości IntentRecognitionResult's IntentId.

SetAuthorizationToken

Składnia: public inline void SetAuthorizationToken ( const std::string & token );

Ustawia token autoryzacji, który będzie używany do nawiązywania połączenia z usługą. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Zanim token autoryzacji wygaśnie, obiekt wywołujący musi go odświeżyć, wywołując ten setter z nowym prawidłowym tokenem. W przeciwnym razie rozpoznawanie napotka błędy podczas rozpoznawania.

Parametry

  • token Ciąg reprezentujący token autoryzacji.

GetAuthorizationToken

Składnia: public inline std::string GetAuthorizationToken ( );

Pobiera token autoryzacji.

Zwraca

Token autoryzacji

ApplyLanguageModels

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

Pobiera kolekcję modeli interpretacji języka, tworzy ich kopię i stosuje je do rozpoznawania. Ta aplikacja jest wykonywana w różnych momentach w zależności od typu modelu interpretacji języka. Proste modele językowe staną się aktywne niemal natychmiast, podczas gdy modele interpretacji języka korzystające z usługi LUIS staną się aktywne w następnym kolei rozpoznawania mowy. Zastępuje to wszystkie wcześniej zastosowane modele.

Parametry

  • collection Wektor współużytkowanych wskaźników do languageUnderstandingModels.

Zwraca

Wartość true, jeśli zastosowanie modeli zostanie zastosowane natychmiast. W przeciwnym razie wartość false.

Z konfiguracji

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

Tworzy rozpoznawanie intencji na podstawie konfiguracji mowy i konfiguracji audio. Użytkownicy powinni użyć tej funkcji, aby utworzyć nowe wystąpienie rozpoznawania intencji.

Parametry

  • speechConfig konfiguracja usługi Mowa.

  • audioInput konfiguracja audio.

Zwraca

Wystąpienie rozpoznawania intencji.

Z konfiguracji

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

Tworzy rozpoznawanie intencji na podstawie osadzonej konfiguracji mowy i konfiguracji audio. Użytkownicy powinni użyć tej funkcji, aby utworzyć nowe wystąpienie rozpoznawania intencji. Dodano element w wersji 1.19.0.

Parametry

  • speechConfig Konfiguracja mowy osadzonej.

  • audioInput konfiguracja audio.

Zwraca

Wystąpienie rozpoznawania intencji.

Typ podstawowy

Składnia: typedef BaseType;