Поделиться через


Windows.ApplicationModel.ConversationalAgent Пространство имен

Предоставляет приложениям возможность предоставлять функциональные возможности с помощью любых цифровых помощник поддерживаемых платформой Windows Conversational Agent.

Важно!

API-интерфейсы Windows.ApplicationModel.ConversationalAgent являются частью функции ограниченного доступа (см. класс LimitedAccessFeatures). Для получения дополнительных сведений или запроса маркера разблокировки используйте форму запроса маркера доступа LAF.

Классы

ActivationSignalDetectionConfiguration

Предоставляет сведения о конфигурации для одного сигнала, поддерживаемого детектором сигналов активации. Например, ключевое слово "Привет, Кортана" на английском языке (США).

ActivationSignalDetectionConfigurationCreationResult

Предоставляет результаты, когда ActivationSignalDetector создает ActivationSignalDetectionConfiguration.

ActivationSignalDetector

Представляет аппаратные и программные компоненты, которые могут генерировать сигналы активации на основе входных данных из среды пользователя, таких как речевой ключевое слово, обнаружение звука или нажатие кнопки.

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

Указывает режимы питания, поддерживаемые ActivationSignalDetector, которые описывают связанные с питанием условия, при которых разрешено работать детектору.

ConversationalAgentActivationKind

Указывает поддерживаемые типы активации агента.

ConversationalAgentActivationResult

Указывает поддерживаемые значения результатов запроса активации агента.

ConversationalAgentSessionUpdateResponse

Указывает каждый возможный ответ для обновления ConversationalAgentSession .

ConversationalAgentState

Указывает все возможные значения AgentState для цифрового помощник.

ConversationalAgentSystemStateChangeType

Указывает возможные изменения состояния для события SystemStateChanged .

ConversationalAgentVoiceActivationPrerequisiteKind

Указывает возможные параметры, необходимые для работы голосовой активации.

DetectionConfigurationAvailabilityChangeKind

Задает уровни разрешений, предоставляемые пользователем для каждой конфигурации ActivationSignalDetectionConfigurationобъекта ActivationSignalDetector.

DetectionConfigurationTrainingStatus

Указывает состояния данных для обучения голоса, распознаваемые ActivationSignalDetector для цифрового помощник.

Примечание

Эти определения выполняются с помощью алгоритмов обучения отдельного детектора сигналов и могут быть специфичны для аппаратных или программных реализаций детектора.

SignalDetectorResourceKind

Указывает типы системных ресурсов, которые могут быть признаны недоступными для ActivationSignalDetectionConfiguration.

Комментарии

Пользователи могут включить сигнал обнаружения на уровне платформы для агента беседы в разделе Параметры. Этот сигнал может включать ключевое слово речевой фрагмент, передачу Bluetooth, системный ускоритель клавиатуры, распознавание речи в приложении или другие звуки (хлопание двери, детектор дыма). Например, ключевое слово "Привет, Кортана", которая начинает голосовое взаимодействие с Кортаной.

Детекторы сигналов на уровне платформы действуют как фильтр "первого прохода" и могут привести к слишком много непреднамеренных активаций. По этой причине рекомендуется рассмотреть возможность дополнительной проверки сигнала активации, например с помощью более строгого ключевое слово детектора из контекста приложения агента.

Если conversationalAgentSignal обнаружен, когда приложение не запущено или не может ответить на событие ConversationalAgentSession.SignalDetected , приложение активируется в фоновом режиме с помощью задачи, зарегистрированной в ConversationalAgentTrigger.

Если обнаружен объект ConversationalAgentSignal , когда приложение может реагировать на событие ConversationalAgentSession.SignalDetected (путем вызова ConversationalAgentSession.RequestAgentStateChangeAsync), фоновая активация не выполняется, так как сигнал уже обработан.

Если для агента беседы обнаружен объект ConversationalAgentSignal , в то время как прерываемый сеанс (см. раздел RequestInterruptableAsync) уже активен, сеанс получит событие ConversationalAgentSession.SessionInterrupted , указывающее на то, что возникло новое событие сигнала.

Примечание

Некоторые сеансы цифрового помощник не могут быть прерваны другим сигналом. Например, Кортана требует, чтобы пользователь выдал команду отмены или остановки для завершения текущего сеанса (пользователь не может находиться в сеансе Кортаны и выдавать команды в Alexa).