Windows.ApplicationModel.ConversationalAgent Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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).