IntentRecognizer Osztály

A beszéd-szövegfelismerés mellett az IntentRecognizer strukturált információkat nyer ki a beszélő szándékáról.

Öröklődés

Recognizer

IntentRecognizer

Konstruktor

IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)

Paraméterek

Name	Description
speech_config Kötelező	A beszédfelismerő konfigurációja.
audio_config	A hangbemenet konfigurációja. alapértelmezett érték: None
intents	A felismerni kívánt (modell, intent_id) vagy (simple_phrase, intent_id) páron keresztüli iterálásból származó szándékok. alapértelmezett érték: None

Metódusok

add_all_intents	Hozzáadja a megadott Language Understanding modell összes szándékát.
add_intent	Szándék hozzáadása a felismerőhöz. Ennek többféle módja van: add_intent(simple_phrase): Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot. add_intent(simple_phrase, intent_id): Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot. A felismerés után az eredmény szándékazonosítója megegyezik az itt megadott azonosítóval. add_intent(modell, intent_name): Egyetlen szándékot ad hozzá név szerint a megadottból LanguageUnderstandingModel. add_intent(modell, intent_name, intent_id): Egyetlen szándékot ad hozzá a megadotttól LanguageUnderstandingModel. add_intent(trigger, intent_id): Hozzáadja a megadott IntentTriggert. IntentTrigger.
add_intents	Szándékok hozzáadása iterálási párokból (modell, intent_id) vagy (simple_phrase, intent_id).
recognize_once	Blokkoló (szinkron) módban végzi a felismerést. 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. Ha hosszabb, több szövegrészletből álló hanganyagot szeretne felismerni, használja a start_continuous_recognition_async elemet.
recognize_once_async	Nem blokkoló (aszinkron) módban végzi a felismerést. Ez egyetlen kimondott szöveget fog felismerni. 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. Ha hosszabb, több szövegrészletből álló hanganyagot szeretne felismerni, használja a start_continuous_recognition_async elemet.
start_continuous_recognition	Szinkron módon elindítja a folyamatos felismerési műveletet. A felhasználónak csatlakoznia kell az EventSignalhoz a felismerési eredmények fogadásához. Hívás stop_continuous_recognition_async a felismerés leállításához.
start_continuous_recognition_async	Aszinkron módon elindítja a folyamatos felismerési műveletet. A felhasználónak csatlakoznia kell az EventSignalhoz a felismerési eredmények fogadásához. Hívás stop_continuous_recognition_async a felismerés leállításához.
start_keyword_recognition	Szinkron módon konfigurálja a felismerőt a megadott kulcsszómodellel. A metódus meghívása után a felismerő a kulcsszót figyeli a felismerés elindításához. Hívja meg a stop_keyword_recognition() parancsot a kulcsszó által kezdeményezett felismerés befejezéséhez.
start_keyword_recognition_async	Aszinkron módon konfigurálja a felismerőt a megadott kulcsszómodellel. A metódus meghívása után a felismerő a kulcsszót figyeli a felismerés elindításához. Hívja meg stop_keyword_recognition_async() a kulcsszó által kezdeményezett felismerés befejezéséhez.
stop_continuous_recognition	Szinkron módon leállítja a folyamatos felismerési műveletet.
stop_continuous_recognition_async	Aszinkron módon leállítja a folyamatos felismerési műveletet.
stop_keyword_recognition	Szinkron módon véget vet a kulcsszó által kezdeményezett felismerésnek.
stop_keyword_recognition_async	Aszinkron módon véget ér a kulcsszó által kezdeményezett felismerés.

add_all_intents

Hozzáadja a megadott Language Understanding modell összes szándékát.

add_all_intents(model: LanguageUnderstandingModel)

Paraméterek

Name	Description
model Kötelező

add_intent

Szándék hozzáadása a felismerőhöz. Ennek többféle módja van:

• add_intent(simple_phrase): Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot.

• add_intent(simple_phrase, intent_id): Egy egyszerű kifejezést ad hozzá, amelyet a felhasználó kimondhat, jelezve egy adott felhasználói szándékot. A felismerés után az eredmény szándékazonosítója megegyezik az itt megadott azonosítóval.

• add_intent(modell, intent_name): Egyetlen szándékot ad hozzá név szerint a megadottból LanguageUnderstandingModel.

• add_intent(modell, intent_name, intent_id): Egyetlen szándékot ad hozzá a megadotttól LanguageUnderstandingModel.

• add_intent(trigger, intent_id): Hozzáadja a megadott IntentTriggert. IntentTrigger.

add_intent(*args)

Paraméterek

Name	Description
model Kötelező	A szándékot tartalmazó nyelvértési modell.
intent_name Kötelező	A nyelvfelismerési modellben szerepeltetni kívánt egyetlen szándék neve.
simple_phrase Kötelező	A szándéknak megfelelő kifejezés.
intent_id Kötelező	A 's intent_id tulajdonságban IntentRecognitionResultvisszaadandó egyéni azonosító sztring.
trigger Kötelező	A szándéknak megfelelő IntentTrigger.

add_intents

Szándékok hozzáadása iterálási párokból (modell, intent_id) vagy (simple_phrase, intent_id).

add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])

Paraméterek

Name	Description
intents Kötelező	A felismerni kívánt (modell, intent_id) vagy (simple_phrase, intent_id) páron keresztüli iterálásból származó szándékok.
intents_iter Kötelező

recognize_once

Blokkoló (szinkron) módban végzi a felismerést. 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. Ha hosszabb, több szövegrészletből álló hanganyagot szeretne felismerni, használja a start_continuous_recognition_async elemet.

recognize_once() -> IntentRecognitionResult

Válaszok

Típus	Description
	A szinkron felismerés eredményértéke.

recognize_once_async

Nem blokkoló (aszinkron) módban végzi a felismerést. Ez egyetlen kimondott szöveget fog felismerni. 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. Ha hosszabb, több szövegrészletből álló hanganyagot szeretne felismerni, használja a start_continuous_recognition_async elemet.

recognize_once_async() -> ResultFuture

Válaszok

Típus	Description
	Az aszinkron felismerés eredményértékét tartalmazó jövő.

start_continuous_recognition

Szinkron módon elindítja a folyamatos felismerési műveletet. A felhasználónak csatlakoznia kell az EventSignalhoz a felismerési eredmények fogadásához. Hívás stop_continuous_recognition_async a felismerés leállításához.

start_continuous_recognition()

start_continuous_recognition_async

Aszinkron módon elindítja a folyamatos felismerési műveletet. A felhasználónak csatlakoznia kell az EventSignalhoz a felismerési eredmények fogadásához. Hívás stop_continuous_recognition_async a felismerés leállításához.

start_continuous_recognition_async() -> ResultFuture

Válaszok

Típus	Description
	A felismerés inicializálása után teljesülő jövő.

start_keyword_recognition

Szinkron módon konfigurálja a felismerőt a megadott kulcsszómodellel. A metódus meghívása után a felismerő a kulcsszót figyeli a felismerés elindításához. Hívja meg a stop_keyword_recognition() parancsot a kulcsszó által kezdeményezett felismerés befejezéséhez.

start_keyword_recognition(model: KeywordRecognitionModel)

Paraméterek

Name	Description
model Kötelező	a felismerni kívánt kulcsszót meghatározó kulcsszófelismerő modell.

start_keyword_recognition_async

Aszinkron módon konfigurálja a felismerőt a megadott kulcsszómodellel. A metódus meghívása után a felismerő a kulcsszót figyeli a felismerés elindításához. Hívja meg stop_keyword_recognition_async() a kulcsszó által kezdeményezett felismerés befejezéséhez.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Paraméterek

Name	Description
model Kötelező	a felismerni kívánt kulcsszót meghatározó kulcsszófelismerő modell.

Válaszok

Típus	Description
	A felismerés inicializálása után teljesülő jövő.

stop_continuous_recognition

Szinkron módon leállítja a folyamatos felismerési műveletet.

stop_continuous_recognition()

stop_continuous_recognition_async

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

stop_continuous_recognition_async()

Válaszok

Típus	Description
	Egy olyan jövő, amely a felismerés leállítása után teljesül.

stop_keyword_recognition

Szinkron módon véget vet a kulcsszó által kezdeményezett felismerésnek.

stop_keyword_recognition()

stop_keyword_recognition_async

Aszinkron módon véget ér a kulcsszó által kezdeményezett felismerés.

stop_keyword_recognition_async()

Válaszok

Típus	Description
	Egy olyan jövő, amely a felismerés leállítása után teljesül.

Attribútumok

authorization_token

A szolgáltatáshoz való csatlakozáshoz használt engedélyezési jogkivonat.

Megjegyzés

A hívónak gondoskodnia kell arról, hogy az engedélyezési jogkivonat érvényes legyen. A

az engedélyezési jogkivonat lejár, a hívónak frissítenie kell, ha meghívja ezt a beállítót egy

új érvényes jogkivonat. Ellenkező esetben a felismerő hibákat fog tapasztalni a felismerés során.

canceled

A megszakított felismerési eredményeket tartalmazó események jelzése (olyan felismerési kísérlet, amely az eredményként vagy közvetlen lemondási kérelemként, vagy másik lehetőségként átviteli vagy protokollhibaként lett megszakítva).

Az ehhez a jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy IntentRecognitionCanceledEventArgspéldány hívja meg.

endpoint_id

A felismeréshez használt testreszabott beszédmodell végpontazonosítója vagy a beszédszintézishez használt egyéni hangmodell.

properties

A Recognizerhez definiált tulajdonságok és azok értékeinek gyűjteménye.

recognized

A végleges felismerési eredményeket tartalmazó események jelzése (a sikeres felismerési kísérlet jelzése).

A jelhez csatlakoztatott visszahívásokat a rendszer egyetlen argumentumként hívja meg egy IntentRecognitionEventArgs példánysal, amely a felismerő típusától függ.

recognizing

A köztes felismerési eredményeket tartalmazó események jelzése.

A jelhez csatlakoztatott visszahívásokat egyetlen argumentumként egy IntentRecognitionEventArgs példány hívja meg.

session_started

A felismerési munkamenet (művelet) kezdetét jelző események jelzése.

A jelhez csatlakoztatott visszahívásokat egyetlen argumentumként egy SessionEventArgs példány hívja meg.

session_stopped

A felismerési munkamenet (művelet) végét jelző események jelzése.

A jelhez csatlakoztatott visszahívásokat egyetlen argumentumként egy SessionEventArgs példány hívja meg.

speech_end_detected

A beszéd végét jelző események jelzése.

A jelhez csatlakoztatott visszahívásokat egyetlen argumentumként egy RecognitionEventArgs példány hívja meg.

speech_start_detected

A beszéd kezdetét jelző események jelzése.

A jelhez csatlakoztatott visszahívásokat egyetlen argumentumként egy RecognitionEventArgs példány hívja meg.