다음을 통해 공유

클래스 의도::IntentRecognizer

  • 아티클
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

IntentRecognizer는 음성 텍스트 변환 인식을 수행하는 것 외에도 전용 의도 트리거를 사용하여 추가 작업을 구동하는 데 사용할 수 있는 화자의 의도에 대한 구조화된 정보를 추출합니다( IntentTrigger 참조).

멤버

속성

구문: public PropertyCollection & Properties;

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

IntentRecognizer

구문: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

내부 생성자입니다. 제공된 핸들을 사용하여 새 instance 만듭니다.

매개 변수

  • hreco 인식기 핸들입니다.

~IntentRecognizer

구문: public inline ~IntentRecognizer ( );

소멸자

RecognizeOnceAsync

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

의도 인식을 시작하고 단일 발화가 인식된 후 를 반환합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 작업에서는 인식 텍스트를 결과로 반환합니다. 참고: RecognizeOnceAsync()는 단일 발화만 반환하므로 명령 또는 쿼리와 같은 단일 샷 인식에만 적합합니다. 장기 실행 다중 발화 인식의 경우 대신 StartContinuousRecognitionAsync()를 사용합니다.

반환

비동기 의도 인식의 결과 값(IntentRecognitionResult에 대한 공유 포인터)이 포함된 미래입니다.

RecognizeOnceAsync

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

의도 인식을 시작하고 전달된 텍스트에서 결과를 생성합니다. 이는 음성 입력이 IntentRecognizer에 연결되지 않은 테스트 및 다른 시간에 유용합니다. 참고: 의도 서비스는 현재 이를 지원하지 않으므로 오프라인 패턴 일치 또는 정확한 일치 의도에 대해서만 유효합니다.

매개 변수

  • text 평가할 텍스트입니다.

반환

비동기 의도 인식의 결과 값(IntentRecognitionResult에 대한 공유 포인터)이 포함된 미래입니다.

StartContinuousRecognitionAsync

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

연속 의도 인식 작업을 비동기적으로 시작합니다.

반환

빈 미래.

StopContinuousRecognitionAsync

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

진행 중인 지속적인 의도 인식 작업을 비동기적으로 종료합니다.

반환

빈 미래.

StartKeywordRecognitionAsync

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

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

매개 변수

  • model사용할 키워드(keyword) 모델을 지정합니다.

반환

빈 미래.

StopKeywordRecognitionAsync

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

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

반환

빈 미래.

AddIntent

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

특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다. 이 간단한 구는 중괄호로 둘러싸인 및 적대감을 포함하는 패턴일 수 있습니다. "{checkboxName} 확인란 클릭"과 같습니다.

매개 변수

  • simplePhrase 의도에 해당하는 구입니다.

인식되면 IntentRecognitionResult의 IntentId 속성이 여기에 지정된 simplePhrase와 일치합니다. 엔터티가 지정되고 일치하는 경우 IntentResult-GetEntities>() 호출에서 사용할 수 있습니다.

AddIntent

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

특정 사용자 의도를 나타내는 사용자가 말할 수 있는 간단한 구를 추가합니다. 이 간단한 구는 중괄호로 둘러싸인 및 적대감을 포함하는 패턴일 수 있습니다. "{checkboxName} 확인란 클릭"과 같습니다.

매개 변수

  • simplePhrase 의도에 해당하는 구입니다.

  • intentId IntentRecognitionResult의 IntentId 속성에 반환할 사용자 지정 ID 문자열입니다.

인식되면 결과의 의도 ID가 여기에 제공된 ID와 일치합니다. 엔터티가 지정되고 일치하는 경우 IntentResult-GetEntities>() 호출에서 사용할 수 있습니다.

AddIntent

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

지정된 Language Understanding 모델에서 이름으로 단일 의도를 추가합니다. PatternMatchingModel 및 ConversationalLanguageUnderstandingModel 형식의 경우 사용하도록 설정하기 전에 기존 모델이 지워지게 됩니다. 이러한 형식의 경우 intentName은 무시됩니다.

매개 변수

  • model 의도를 포함하는 언어 이해 모델입니다.

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

인식되면 IntentRecognitionResult의 IntentId 속성에 여기에 지정된 intentName이 포함됩니다.

AddIntent

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

지정된 Language Understanding 모델에서 이름으로 단일 의도를 추가합니다. PatternMatchingModel 및 ConversationalLanguageUnderstandingModel 형식의 경우 사용하도록 설정하기 전에 기존 모델이 지워지게 됩니다. 이러한 형식의 경우 intentName 및 intentId는 무시됩니다.

매개 변수

  • model 의도를 포함하는 언어 이해 모델입니다.

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

  • intentId IntentRecognitionResult의 IntentId 속성에 반환할 사용자 지정 ID 문자열입니다.

AddAllIntents

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

지정된 Language Understanding 모델의 모든 의도를 추가합니다. PatternMatchingModel 및 ConversationalLanguageUnderstandingModel 형식의 경우 사용하도록 설정하기 전에 기존 모델이 지워지게 됩니다.

매개 변수

  • model 의도를 포함하는 언어 이해 모델입니다.

인식되면 IntentRecognitionResult의 IntentId 속성에 인식된 의도의 이름이 포함됩니다.

AddAllIntents

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

지정된 Language Understanding 모델의 모든 의도를 추가합니다. PatternMatchingModel 및 ConversationalLanguageUnderstandingModel 형식의 경우 사용하도록 설정하기 전에 기존 모델이 지워지게 됩니다.

매개 변수

  • model 의도를 포함하는 언어 이해 모델입니다.

  • intentId IntentRecognitionResult의 IntentId 속성에 반환될 사용자 지정 문자열 ID입니다.

AddIntent

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

지정한 IntentTrigger를 추가합니다.

매개 변수

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

  • intentId IntentRecognitionResult의 IntentId 속성에 반환될 사용자 지정 문자열 ID입니다.

SetAuthorizationToken

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

서비스에 연결하는 데 사용할 권한 부여 토큰을 설정합니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.

매개 변수

  • token 권한 부여 토큰을 나타내는 문자열입니다.

GetAuthorizationToken

구문: public inline std::string GetAuthorizationToken ( );

권한 부여 토큰을 가져옵니다.

반환

권한 부여 토큰

ApplyLanguageModels

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

언어 이해 모델의 컬렉션을 가져와서 복사본을 만들고 인식기에서 적용합니다. 이 애플리케이션은 언어 이해 모델 유형에 따라 서로 다른 시간에 발생합니다. 간단한 언어 모델은 거의 즉시 활성화되는 반면 LUIS를 활용하는 언어 이해 모델은 다음 음성 턴에서 활성화됩니다. 이렇게 하면 이전에 적용된 모든 모델이 대체됩니다.

매개 변수

  • collection LanguageUnderstandingModels에 대한 공유 포인터의 벡터입니다.

반환

True이면 모델의 애플리케이션이 즉시 적용됩니다. 그렇지 않으면 false입니다.

FromConfig

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

음성 구성 및 오디오 구성에서 의도 인식기를 만듭니다. 사용자는 이 함수를 사용하여 의도 인식기의 새 instance 만들어야 합니다.

매개 변수

  • speechConfig 음성 구성.

  • audioInput 오디오 구성.

반환

의도 인식기의 인스턴스입니다.

FromConfig

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

포함된 음성 구성 및 오디오 구성에서 의도 인식기를 만듭니다. 사용자는 이 함수를 사용하여 의도 인식기의 새 instance 만들어야 합니다. 버전 1.19.0에 추가되었습니다.

매개 변수

  • speechConfig 포함된 음성 구성.

  • audioInput 오디오 구성.

반환

의도 인식기의 인스턴스입니다.

BaseType

구문: typedef BaseType;