Windows.ApplicationModel.ConversationalAgent 命名空间

使应用程序能够通过 Windows 对话代理平台支持的任何数字助手公开功能。

重要

Windows.ApplicationModel.ConversationalAgent API 是受限访问功能的一部分, (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌,请使用 LAF 访问令牌请求表单

ActivationSignalDetectionConfiguration

提供激活信号检测器支持的单个信号的配置详细信息。 例如,关键字 (keyword) 美国英语中的“你好小娜”。

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

指定 ActivationSignalDetector 支持的电源模式,这些模式描述允许检测器在哪些条件下运行与电源相关的条件。

ConversationalAgentActivationKind

指定支持的代理激活类型。

ConversationalAgentActivationResult

指定支持的代理激活请求结果值。

ConversationalAgentSessionUpdateResponse

指定 ConversationalAgentSession 更新的每个可能响应。

ConversationalAgentState

指定数字助手的每个可能的 AgentState

ConversationalAgentSystemStateChangeType

指定 SystemStateChanged 事件的可能状态更改。

ConversationalAgentVoiceActivationPrerequisiteKind

指定语音激活正常运行所需的可能设置。

DetectionConfigurationAvailabilityChangeKind

指定用户授予 ActivationSignalDetector 的每个 ActivationSignalDetectionConfiguration 的权限级别。

DetectionConfigurationTrainingStatus

为数字助手指定 ActivationSignalDetector 识别的语音训练数据状态。

注意

这些确定由单个信号检测器的训练算法完成,可能特定于检测器的硬件或软件实现。

SignalDetectorResourceKind

指定可能报告为 ActivationSignalDetectionConfiguration 不可用的系统资源类型。

注解

用户可以在“设置”中为对话代理启用平台级检测信号。 此信号可以包括关键字 (keyword) 言语、蓝牙传输、系统键盘加速器、应用内语音识别或其他声音 (门猛击、烟雾检测器) 。 例如,“你好小娜”关键字 (keyword) 开始与 Cortana 进行语音交互。

平台级信号检测器充当“首次通过”筛选器,并可能导致过多的意外激活。 出于此原因,建议考虑对激活信号进行其他验证,例如使用更严格的关键字 (keyword) 检测器(来自代理应用程序上下文)。

如果在应用程序未运行时检测到 ConversationalAgentSignal ,或者无法响应 ConversationalAgentSession.SignalDetected 事件,则会使用使用 ConversationalAgentTrigger 注册的任务在后台激活该应用程序。

如果在应用程序能够通过调用 ConversationalAgentSession.RequestAgentStateChangeAsync () 响应 ConversationalAgentSession.SignalDetected 事件时检测到 ConversationalAgentSignal,则不会发生后台激活,因为信号已处理。

如果在可中断会话 (请参阅 RequestInterruptableAsync) 已处于活动状态时检测到 ConversationalAgentSignal,则会话将收到 ConversationalAgentSession.SessionInterrupted 事件,以指示已引发新的信号事件。

注意

某些数字助手会话不能被其他信号中断。 例如,Cortana 要求用户发出取消或停止命令以结束当前会话, (用户不能在 Cortana 会话中,并向 Alexa) 发出命令。