Windows.ApplicationModel.ConversationalAgent 命名空間

讓應用程式能夠透過 Windows 對話代理程式平台支援的任何數位 助理 公開功能。

重要

Windows.ApplicationModel.ConversationalAgent API 是有限存取功能的一部分， (請參閱 LimitedAccessFeatures 類別) 。 如需詳細資訊或要求解除鎖定令牌，請使用 LAF存取令牌要求表單。

類別

ActivationSignalDetectionConfiguration	提供啟用訊號偵測器所支援之單一訊號的組態詳細數據。 例如，美國英文的關鍵詞 「Hey Cortana」。
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	指定 Digital 助理 ActivationSignalDetector 支援的啟用訊號定型數據格式。
ActivationSignalDetectorKind	指定支援的 ActivationSignalDetector 類型。
ActivationSignalDetectorPowerState	指定 ActivationSignalDetector 所支援的電源模式，描述允許偵測器運作的電源相關條件。
ConversationalAgentActivationKind	指定支援的代理程式啟用類型。
ConversationalAgentActivationResult	指定支援的代理程式啟用要求結果值。
ConversationalAgentSessionUpdateResponse	指定 ConversationalAgentSession 更新的每個可能回應。
ConversationalAgentState	指定數位 助理 的每個可能 AgentState。
ConversationalAgentSystemStateChangeType	指定 SystemStateChanged 事件的可能狀態變更。
ConversationalAgentVoiceActivationPrerequisiteKind	指定語音啟用運作所需的可能設定。
DetectionConfigurationAvailabilityChangeKind	指定使用者授與給 ActivationSignalDetector 之每個 ActivationSignalDetectionConfiguration 的許可權等級。
DetectionConfigurationTrainingStatus	指定 Digital 助理 ActivationSignalDetector 所辨識的語音訓練數據狀態。 注意 這些判斷是由個別訊號偵測器的定型演算法所決定，而且可能專屬於偵測器的硬體或軟體實作。
SignalDetectorResourceKind	指定可能回報為無法提供給 ActivationSignalDetectionConfiguration 的系統資源類型。

備註

用戶可以在 [設定] 中啟用交談代理程式的平臺層級偵測訊號。 此訊號可以包含關鍵詞語句、藍牙傳輸、系統鍵盤快捷鍵、應用程式內語音識別或其他音效 (門燈、噴氣偵測器) 。 例如，開始與 Cortana 進行語音互動的 「Hey Cortana」 關鍵詞。

平臺層級訊號偵測器會做為「第一次」篩選，而且可能會導致太多非預期的啟用。 基於這個理由，我們建議您考慮啟用訊號的其他驗證，例如從代理程式應用程式的內容使用更嚴格的關鍵詞偵測器。

如果在應用程式未執行時偵測 到 ConversationalAgentSignal ，或無法回應 ConversationalAgentSession.SignalDetected 事件，則會使用向 ConversationalAgentTrigger 註冊的工作在背景中啟動應用程式。

如果在應用程式能夠透過呼叫 ConversationalAgentSession.RequestAgentSession.RequestAgentStateChangeAsync) 來回應 ConversationalAgentSession.SignalDetected (事件時偵測到 ConversationalAgentSignal，則不會發生背景啟用，因為已處理訊號。

如果在中斷的會話 (看到 RequestInterruptableAsync) 已在作用中時偵測到交談代理程式的 ConversationalAgentSignal，會話將會收到 ConversationalAgentSession.SessionInterrupted 事件，指出已引發新的訊號事件。

注意

某些數位 助理 會話無法由另一個訊號中斷。 例如，Cortana 要求使用者發出取消或停止命令，以結束目前的會話， (使用者不能在 Cortana 會話中，並將命令發出給) 。