Windows.ApplicationModel.ConversationalAgent 네임스페이스

Windows 대화 에이전트 플랫폼에서 지원하는 디지털 도우미 통해 기능을 노출하는 기능을 애플리케이션에 제공합니다.

중요

Windows.ApplicationModel.ConversationalAgent API는 제한된 액세스 기능의 일부입니다( LimitedAccessFeatures 클래스 참조). 자세한 내용을 확인하거나 잠금 해제 토큰을 요청하려면 LAF 액세스 토큰 요청 양식을 사용하세요.

클래스

ActivationSignalDetectionConfiguration	활성화 신호 탐지기에서 지원하는 단일 신호에 대한 구성 세부 정보를 제공합니다. 예를 들어 키워드(keyword) "Hey Cortana"는 미국 영어로 제공됩니다.
ActivationSignalDetectionConfigurationCreationResult	ActivationSignalDetector가 ActivationSignalDetectionConfiguration을 만들 때 결과를 제공합니다.
ActivationSignalDetector	음성 키워드(keyword), 소리 감지 또는 단추 누르기와 같은 사용자 환경의 입력에 따라 활성화 신호를 생성할 수 있는 하드웨어 및 소프트웨어 구성 요소를 나타냅니다.
ConversationalAgentDetectorManager	디지털 도우미 기존 신호 탐지기 및 구성 정의에 대한 액세스를 제공합니다.
ConversationalAgentSession	디지털 도우미 Windows 대화 에이전트 플랫폼 간의 통신 채널입니다.
ConversationalAgentSessionInterruptedEventArgs	SessionInterrupted 이벤트에 대한 이벤트 데이터를 제공합니다.
ConversationalAgentSignal	ActivationSignalDetectionConfiguration에 해당하는 에이전트에서 감지한 신호입니다. 이 신호는 상호 작용을 처리하기 위해 일치하는 에이전트를 활성화해야 했음을 나타냅니다.
ConversationalAgentSignalDetectedEventArgs	SignalDetected 이벤트에 대한 이벤트 데이터를 제공합니다.
ConversationalAgentSystemStateChangedEventArgs	SystemStateChanged 이벤트에 대한 이벤트 데이터를 제공합니다.
DetectionConfigurationAvailabilityChangedEventArgs	ActivationSignalDetectionConfiguration.AvailabilityChanged 이벤트에 대한 이벤트 데이터를 제공합니다.
DetectionConfigurationAvailabilityInfo	ActivationSignalDetector에 대한 가용성 세부 정보를 제공합니다.

열거형

ActivationSignalDetectionConfigurationCreationStatus	디지털 도우미 대한 ActivationSignalDetectionConfiguration을 만들 때 가능한 결과를 지정합니다.
ActivationSignalDetectionConfigurationRemovalResult	디지털 도우미 ActivationSignalDetectionConfiguration을 제거할 때 가능한 결과를 지정합니다.
ActivationSignalDetectionConfigurationSetModelDataResult	디지털 도우미 대한 ActivationSignalDetectionConfiguration의 모델 구성 데이터를 설정할 때 반환되는 가능한 결과를 지정합니다.
ActivationSignalDetectionConfigurationStateChangeResult	디지털 도우미 대해 ActivationSignalDetectionConfiguration을 사용하거나 사용하지 않도록 설정할 때 반환되는 가능한 결과를 지정합니다.
ActivationSignalDetectionTrainingDataFormat	디지털 도우미 대한 ActivationSignalDetector에서 지원하는 활성화 신호 학습 데이터 형식을 지정합니다.
ActivationSignalDetectorKind	지원되는 ActivationSignalDetector 형식을 지정합니다.
ActivationSignalDetectorPowerState	Detector 작동이 허용되는 전원 관련 조건을 설명하는 ActivationSignalDetector에서 지원하는 전원 모드를 지정합니다.
ConversationalAgentActivationKind	지원되는 에이전트 활성화 유형을 지정합니다.
ConversationalAgentActivationResult	지원되는 에이전트 활성화 요청 결과 값을 지정합니다.
ConversationalAgentSessionUpdateResponse	ConversationalAgentSession 업데이트에 대해 가능한 각 응답을 지정합니다.
ConversationalAgentState	디지털 도우미 대해 가능한 각 AgentState를 지정합니다.
ConversationalAgentSystemStateChangeType	SystemStateChanged 이벤트에 대한 가능한 상태 변경을 지정합니다.
ConversationalAgentVoiceActivationPrerequisiteKind	음성 활성화가 작동하는 데 필요한 가능한 설정을 지정합니다.
DetectionConfigurationAvailabilityChangeKind	사용자가 ActivationSignalDetector의 각 ActivationSignalDetectionConfiguration 에 부여한 사용 권한 수준을 지정 합니다.
DetectionConfigurationTrainingStatus	디지털 도우미 대한 ActivationSignalDetector에서 인식하는 음성 학습 데이터 상태를 지정합니다. 참고 이러한 결정은 개별 신호 탐지기의 학습 알고리즘에 의해 이루어지며 탐지기의 하드웨어 또는 소프트웨어 구현과 관련이 있을 수 있습니다.
SignalDetectorResourceKind	ActivationSignalDetectionConfiguration에 사용할 수 없는 것으로 보고될 수 있는 시스템 리소스 유형을 지정합니다.

설명

사용자는 설정에서 대화형 에이전트에 대해 플랫폼 수준 검색 신호를 사용하도록 설정할 수 있습니다. 이 신호에는 키워드(keyword) 발화, Bluetooth 전송, 시스템 키보드 가속기, 앱 내 음성 인식 또는 기타 소리(도어 슬램, 스모크 감지기)가 포함될 수 있습니다. 예를 들어 Cortana와의 음성 상호 작용을 시작하는 "Hey Cortana" 키워드(keyword).

플랫폼 수준 신호 탐지기는 "첫 번째 패스" 필터 역할을 하며 의도하지 않은 활성화가 너무 많을 수 있습니다. 이러한 이유로 에이전트 애플리케이션의 컨텍스트에서 보다 엄격한 키워드(keyword) 감지기를 사용하는 등 활성화 신호에 대한 추가 확인을 고려하는 것이 좋습니다.

애플리케이션이 실행되고 있지 않거나 ConversationalAgentSession.SignalDetected 이벤트에 응답할 수 없는 경우 ConversationalAgentTrigger에 등록된 작업을 사용하여 백그라운드에서 애플리케이션이 활성화됩니다.

애플리케이션이 ConversationalAgentSession.SignalDetected 이벤트에 응답할 수 있는 동안 ConversationalAgentSignal이 검색되면(ConversationalAgentSession.RequestAgentStateChangeAsync를 호출하여) 신호가 이미 처리되었으므로 백그라운드 활성화가 발생하지 않습니다.

인터럽트 가능한 세션(RequestInterruptableAsync 참조)이 이미 활성 상태인 동안 ConversationalAgentSignal이 대화 에이전트에 대해 검색되면 세션은 ConversationalAgentSession.SessionInterrupted 이벤트를 수신하여 새 신호 이벤트가 발생했음을 나타냅니다.

참고

일부 디지털 도우미 세션은 다른 신호에 의해 중단될 수 없습니다. 예를 들어 Cortana는 사용자가 현재 세션을 종료하기 위해 취소 또는 중지 명령을 실행하도록 요구합니다(사용자는 Cortana 세션에 있을 수 없으며 Alexa에 명령을 실행할 수 없음).