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