Freigeben über


Windows.ApplicationModel.ConversationalAgent Namespace

Bietet Anwendungen die Möglichkeit, Funktionen über alle digitalen Assistent verfügbar zu machen, die von der Windows Conversational Agent-Plattform unterstützt werden.

Wichtig

Die Windows.ApplicationModel.ConversationalAgent-APIs sind Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Um weitere Informationen zu erhalten oder ein Entsperrtoken anzufordern, verwenden Sie das ANFORDERUNGSFORMULAR für LAF-Zugriffstoken.

Klassen

ActivationSignalDetectionConfiguration

Stellt die Konfigurationsdetails für ein einzelnes Signal bereit, das von einem Aktivierungssignaldetektor unterstützt wird. Beispielsweise Schlüsselwort (keyword) "Hey Cortana" auf US-Englisch.

ActivationSignalDetectionConfigurationCreationResult

Stellt die Ergebnisse bereit, wenn ein ActivationSignalDetector eine ActivationSignalDetectionConfiguration erstellt.

ActivationSignalDetector

Stellt Hardware- und Softwarekomponenten dar, die Aktivierungssignale basierend auf Eingaben aus der Umgebung eines Benutzers generieren können, z. B. gesprochene Schlüsselwort (keyword), Sounderkennung oder Tastendruck.

ConversationalAgentDetectorManager

Ermöglicht den Zugriff auf vorhandene Signaldetektor- und Konfigurationsdefinitionen einer digitalen Assistent.

ConversationalAgentSession

Der Kommunikationskanal zwischen dem digitalen Assistent und der Windows Conversational Agent-Plattform.

ConversationalAgentSessionInterruptedEventArgs

Stellt Ereignisdaten für das SessionInterrupted-Ereignis bereit.

ConversationalAgentSignal

Ein von einem Agent erkanntes Signal, das einer ActivationSignalDetectionConfiguration entspricht. Dieses Signal gibt an, dass der übereinstimmende Agent aktiviert werden soll, um eine Interaktion zu verarbeiten.

ConversationalAgentSignalDetectedEventArgs

Stellt Ereignisdaten für das SignalDetected-Ereignis bereit .

ConversationalAgentSystemStateChangedEventArgs

Stellt Ereignisdaten für das SystemStateChanged-Ereignis bereit .

DetectionConfigurationAvailabilityChangedEventArgs

Stellt Ereignisdaten für das ActivationSignalDetectionConfiguration.AvailabilityChanged-Ereignis bereit .

DetectionConfigurationAvailabilityInfo

Stellt Verfügbarkeitsdetails für den ActivationSignalDetector bereit.

Enumerationen

ActivationSignalDetectionConfigurationCreationStatus

Gibt die möglichen Ergebnisse beim Erstellen einer ActivationSignalDetectionConfiguration für die digitale Assistent an.

ActivationSignalDetectionConfigurationRemovalResult

Gibt die möglichen Ergebnisse an, wenn eine ActivationSignalDetectionConfiguration aus dem digitalen Assistent entfernt wird.

ActivationSignalDetectionConfigurationSetModelDataResult

Gibt die möglichen Ergebnisse an, die beim Festlegen der Modellkonfigurationsdaten einer ActivationSignalDetectionConfiguration für die digitale Assistent zurückgegeben werden.

ActivationSignalDetectionConfigurationStateChangeResult

Gibt die möglichen Ergebnisse an, die beim Aktivieren oder Deaktivieren von ActivationSignalDetectionConfiguration für die digitale Assistent zurückgegeben werden.

ActivationSignalDetectionTrainingDataFormat

Gibt die Vom ActivationSignalDetector unterstützten Aktivierungssignaltrainingsdatenformate für die digitale Assistent an.

ActivationSignalDetectorKind

Gibt die unterstützten ActivationSignalDetector-Typen an .

ActivationSignalDetectorPowerState

Gibt die von einem ActivationSignalDetector unterstützten Leistungsmodi an, die die energiebezogenen Bedingungen beschreiben, unter denen ein Detektor arbeiten darf.

ConversationalAgentActivationKind

Gibt die unterstützten Agentaktivierungstypen an.

ConversationalAgentActivationResult

Gibt die Werte der unterstützten Agentaktivierungsanforderung an.

ConversationalAgentSessionUpdateResponse

Gibt jede mögliche Antwort für ein ConversationalAgentSession-Update an.

ConversationalAgentState

Gibt jeden möglichen AgentState für eine digitale Assistent an.

ConversationalAgentSystemStateChangeType

Gibt die möglichen Zustandsänderungen für das SystemStateChanged-Ereignis an .

ConversationalAgentVoiceActivationPrerequisiteKind

Gibt die möglichen Einstellungen an, die für die Funktion der Sprachaktivierung erforderlich sind.

DetectionConfigurationAvailabilityChangeKind

Gibt die Berechtigungsstufen an, die einem Benutzer für jede ActivationSignalDetectionConfiguration eines ActivationSignalDetectors gewährt werden.

DetectionConfigurationTrainingStatus

Gibt die vom ActivationSignalDetector erkannten Sprachtrainingsdatenzustände für die digitale Assistent an.

Hinweis

Diese Bestimmung erfolgt durch die Trainingsalgorithmen eines einzelnen Signaldetektors und kann spezifisch für die Hard- oder Softwareimplementierungen des Detektors sein.

SignalDetectorResourceKind

Gibt die Typen von Systemressourcen an, die für eine ActivationSignalDetectionConfiguration als nicht verfügbar gemeldet werden.

Hinweise

Benutzer können ein Erkennungssignal auf Plattformebene für einen Konversations-Agent in den Einstellungen aktivieren. Dieses Signal kann eine Schlüsselwort (keyword) Äußerung, Bluetooth-Übertragung, Systemtastataturbeschleuniger, In-App-Spracherkennung oder andere Geräusche (Türschnall, Rauchmelder) umfassen. Beispielsweise die "Hey Cortana"-Schlüsselwort (keyword), die eine Sprachinteraktion mit Cortana beginnt.

Signaldetektoren auf Plattformebene fungieren als "First-Pass"-Filter und können zu vielen unbeabsichtigten Aktivierungen führen. Aus diesem Grund wird empfohlen, eine zusätzliche Überprüfung eines Aktivierungssignals in Betracht zu ziehen, z. B. die Verwendung eines strengeren Schlüsselwort (keyword)-Detektors aus dem Kontext der Agentanwendung.

Wenn ein ConversationalAgentSignal erkannt wird, während die Anwendung nicht ausgeführt wird, oder nicht in der Lage ist, auf das ConversationalAgentSession.SignalDetected-Ereignis zu reagieren, wird die Anwendung im Hintergrund mithilfe einer Aufgabe aktiviert, die bei einem ConversationalAgentTrigger registriert ist.

Wenn ein ConversationalAgentSignal erkannt wird, während die Anwendung auf ein ConversationalAgentSession.SignalDetected-Ereignis reagieren kann (durch Aufrufen von ConversationalAgentSession.RequestAgentStateChangeAsync), erfolgt keine Hintergrundaktivierung, da das Signal bereits verarbeitet wurde.

Wenn ein ConversationalAgentSignal für einen Konversations-Agent erkannt wird, während eine unterbrechbare Sitzung (siehe RequestInterruptableAsync) bereits aktiv ist, erhält die Sitzung ein ConversationalAgentSession.SessionInterrupted-Ereignis , um anzugeben, dass ein neues Signalereignis ausgelöst wurde.

Hinweis

Einige digitale Assistent Sitzungen können nicht durch ein anderes Signal unterbrochen werden. Cortana erfordert beispielsweise, dass der Benutzer einen Befehl zum Abbrechen oder Beenden ausgibt, um die aktuelle Sitzung zu beenden (der Benutzer kann sich nicht in einer Cortana-Sitzung befinden und Befehle an Alexa ausgeben).