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

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

Важно!

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

Классы

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).