다음을 통해 공유

IntentRecognizer 클래스

  • 참조

IntentRecognizer는 음성 텍스트 변환 인식을 수행하는 것 외에도 화자의 의도에 대한 구조화된 정보를 추출합니다.

상속
Recognizer
IntentRecognizer

생성자

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

매개 변수

Name Description
speech_config
필수

음성 인식기 구성입니다.
audio_config

오디오 입력에 대한 구성입니다.

기본값: None
intents

인식할 (모델, intent_id) 또는 (simple_phrase, intent_id) 쌍을 반복할 수 있는 의도입니다.

기본값: None

메서드

add_all_intents

지정된 Language Understanding 모델의 모든 의도를 추가합니다.
add_intent

인식기에서 의도를 추가합니다. 이 작업을 수행하는 방법에는 여러 가지가 있습니다.

  • add_intent(simple_phrase): 특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다.

  • add_intent(simple_phrase, intent_id): 특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다. 인식되면 결과의 의도 ID가 여기에 제공된 ID와 일치합니다.

  • add_intent(model, intent_name): 지정된 LanguageUnderstandingModel의 이름으로 단일 의도를 추가합니다.

  • add_intent(model, intent_name, intent_id): 지정된 LanguageUnderstandingModel의 이름으로 단일 의도를 추가합니다.

  • add_intent(트리거, intent_id): 지정된 IntentTrigger를 추가합니다. IntentTrigger.
add_intents

(모델, intent_id) 또는 (simple_phrase, intent_id) 쌍을 통해 반복 가능한 에서 의도를 추가합니다.
recognize_once

차단(동기) 모드에서 인식을 수행합니다. 단일 발화가 인식된 후 반환합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 작업에서는 인식 텍스트를 결과로 반환합니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.
recognize_once_async

비차단(비동기) 모드에서 인식을 수행합니다. 단일 발화를 인식합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.
start_continuous_recognition

연속 인식 작업을 동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.
start_continuous_recognition_async

연속 인식 작업을 비동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.
start_keyword_recognition

지정된 키워드(keyword) 모델을 사용하여 인식기를 동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.
start_keyword_recognition_async

지정된 키워드(keyword) 모델을 사용하여 인식기를 비동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition_async()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.
stop_continuous_recognition

지속적인 지속적인 인식 작업을 동기적으로 종료합니다.
stop_continuous_recognition_async

지속적인 지속적인 인식 작업을 비동기적으로 종료합니다.
stop_keyword_recognition

키워드(keyword) 시작된 인식을 동기적으로 종료합니다.
stop_keyword_recognition_async

키워드(keyword) 시작된 인식을 비동기적으로 종료합니다.

add_all_intents

지정된 Language Understanding 모델의 모든 의도를 추가합니다.

add_all_intents(model: LanguageUnderstandingModel)

매개 변수

Name Description
model
필수

add_intent

인식기에서 의도를 추가합니다. 이 작업을 수행하는 방법에는 여러 가지가 있습니다.

  • add_intent(simple_phrase): 특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다.

  • add_intent(simple_phrase, intent_id): 특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다. 인식되면 결과의 의도 ID가 여기에 제공된 ID와 일치합니다.

  • add_intent(model, intent_name): 지정된 LanguageUnderstandingModel의 이름으로 단일 의도를 추가합니다.

  • add_intent(model, intent_name, intent_id): 지정된 LanguageUnderstandingModel의 이름으로 단일 의도를 추가합니다.

  • add_intent(트리거, intent_id): 지정된 IntentTrigger를 추가합니다. IntentTrigger.

add_intent(*args)

매개 변수

Name Description
model
필수

의도를 포함하는 언어 이해 모델입니다.
intent_name
필수

언어 이해 모델에서 포함할 단일 의도의 이름입니다.
simple_phrase
필수

의도에 해당하는 구입니다.
intent_id
필수

의 intent_id 속성에 IntentRecognitionResult반환할 사용자 지정 ID 문자열입니다.
trigger
필수

의도에 해당하는 IntentTrigger입니다.

add_intents

(모델, intent_id) 또는 (simple_phrase, intent_id) 쌍을 통해 반복 가능한 에서 의도를 추가합니다.

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

매개 변수

Name Description
intents
필수

인식할 (모델, intent_id) 또는 (simple_phrase, intent_id) 쌍을 반복할 수 있는 의도입니다.
intents_iter
필수

recognize_once

차단(동기) 모드에서 인식을 수행합니다. 단일 발화가 인식된 후 반환합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 작업에서는 인식 텍스트를 결과로 반환합니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

recognize_once() -> IntentRecognitionResult

반환

형식 Description

동기 인식의 결과 값입니다.

recognize_once_async

비차단(비동기) 모드에서 인식을 수행합니다. 단일 발화를 인식합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

recognize_once_async() -> ResultFuture

반환

형식 Description

비동기 인식의 결과 값을 포함하는 미래입니다.

start_continuous_recognition

연속 인식 작업을 동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_continuous_recognition()

start_continuous_recognition_async

연속 인식 작업을 비동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_continuous_recognition_async() -> ResultFuture

반환

형식 Description

인식이 초기화되면 수행되는 미래입니다.

start_keyword_recognition

지정된 키워드(keyword) 모델을 사용하여 인식기를 동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

start_keyword_recognition(model: KeywordRecognitionModel)

매개 변수

Name Description
model
필수

인식할 키워드(keyword) 지정하는 키워드(keyword) 인식 모델입니다.

start_keyword_recognition_async

지정된 키워드(keyword) 모델을 사용하여 인식기를 비동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition_async()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

start_keyword_recognition_async(model: KeywordRecognitionModel)

매개 변수

Name Description
model
필수

인식할 키워드(keyword) 지정하는 키워드(keyword) 인식 모델입니다.

반환

형식 Description

인식이 초기화되면 수행되는 미래입니다.

stop_continuous_recognition

지속적인 지속적인 인식 작업을 동기적으로 종료합니다.

stop_continuous_recognition()

stop_continuous_recognition_async

지속적인 지속적인 인식 작업을 비동기적으로 종료합니다.

stop_continuous_recognition_async()

반환

형식 Description

인식이 중지되면 수행되는 미래입니다.

stop_keyword_recognition

키워드(keyword) 시작된 인식을 동기적으로 종료합니다.

stop_keyword_recognition()

stop_keyword_recognition_async

키워드(keyword) 시작된 인식을 비동기적으로 종료합니다.

stop_keyword_recognition_async()

반환

형식 Description

인식이 중지되면 수행되는 미래입니다.

특성

authorization_token

서비스에 연결하는 데 사용할 권한 부여 토큰입니다.

참고

호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 이전의

권한 부여 토큰이 만료되면 호출자는 이 setter를 로 호출하여 새로 고쳐야 합니다.

새 유효한 토큰입니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.

canceled

취소된 인식 결과가 포함된 이벤트에 대한 신호입니다(결과로 취소된 인식 시도 또는 직접 취소 요청 또는 전송 또는 프로토콜 실패를 나타냅니다).

이 신호에 연결된 콜백은 단일 인수로 IntentRecognitionCanceledEventArgsinstance 를 사용하여 호출됩니다.

endpoint_id

인식에 사용되는 사용자 지정 음성 모델의 엔드포인트 ID 또는 음성 합성을 위한 사용자 지정 음성 모델입니다.

properties

이 Recognizer에 대해 정의된 속성 및 해당 값의 컬렉션입니다.

recognized

최종 인식 결과를 포함하는 이벤트에 대한 신호입니다(성공적인 인식 시도를 나타낸다).

이 신호에 연결된 콜백은 인식기 유형에 따라 instance 단일 인수로 호출 IntentRecognitionEventArgs 됩니다.

recognizing

중간 인식 결과를 포함하는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 IntentRecognitionEventArgs 됩니다.

session_started

인식 세션(작업)의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 SessionEventArgs 됩니다.

session_stopped

인식 세션(작업)의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 SessionEventArgs 됩니다.

speech_end_detected

음성의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 RecognitionEventArgs 됩니다.

speech_start_detected

음성의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 RecognitionEventArgs 됩니다.