Windows.ApplicationModel.ConversationalAgent Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit aux applications la possibilité d’exposer des fonctionnalités via n’importe quel assistant numérique pris en charge par la plateforme d’agent conversationnel Windows.
Important
Les API Windows.ApplicationModel.ConversationalAgent font partie d’une fonctionnalité d’accès limité (voir classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, utilisez le formulaire de demande de jeton d’accès LAF.
Classes
| ActivationSignalDetectionConfiguration |
Fournit les détails de configuration d’un signal unique pris en charge par un détecteur de signal d’activation. Par exemple, le mot clé « Hey Cortana » en anglais américain. |
| ActivationSignalDetectionConfigurationCreationResult |
Fournit les résultats lorsqu’un ActivationSignalDetector crée un ActivationSignalDetectionConfiguration. |
| ActivationSignalDetector |
Représente les composants matériels et logiciels qui peuvent générer des signaux d’activation en fonction de l’entrée de l’environnement d’un utilisateur, telles que les mot clé parlées, la détection du son ou l’appui sur un bouton. |
| ConversationalAgentDetectorManager |
Fournit l’accès aux définitions de configuration et de détecteur de signal existants d’un assistant numérique. |
| ConversationalAgentSession |
Canal de communication entre le assistant numérique et la plateforme de l’agent conversationnel Windows. |
| ConversationalAgentSessionInterruptedEventArgs |
Fournit des données d’événement pour l’événement SessionInterrupted . |
| ConversationalAgentSignal |
Signal détecté par un agent qui correspond à une activationSignalDetectionConfiguration. Ce signal indique que l’agent correspondant doit être activé pour gérer une interaction. |
| ConversationalAgentSignalDetectedEventArgs |
Fournit des données d’événement pour l’événement SignalDetected . |
| ConversationalAgentSystemStateChangedEventArgs |
Fournit des données d’événement pour l’événement SystemStateChanged . |
| DetectionConfigurationAvailabilityChangedEventArgs |
Fournit des données d’événement pour l’événement ActivationSignalDetectionConfiguration.AvailabilityChanged . |
| DetectionConfigurationAvailabilityInfo |
Fournit les détails de disponibilité pour ActivationSignalDetector. |
Énumérations
| ActivationSignalDetectionConfigurationCreationStatus |
Spécifie les résultats possibles lors de la création d’une activationSignalDetectionConfiguration pour le assistant numérique. |
| ActivationSignalDetectionConfigurationRemovalResult |
Spécifie les résultats possibles lors de la suppression d’une activationSignalDetectionConfiguration de l’assistant numérique. |
| ActivationSignalDetectionConfigurationSetModelDataResult |
Spécifie les résultats possibles retournés lors de la définition des données de configuration du modèle d’une activationSignalDetectionConfiguration pour le assistant numérique. |
| ActivationSignalDetectionConfigurationStateChangeResult |
Spécifie les résultats possibles retournés lors de l’activation ou de la désactivation de ActivationSignalDetectionConfiguration pour le assistant numérique. |
| ActivationSignalDetectionTrainingDataFormat |
Spécifie les formats de données d’entraînement de signal d’activation pris en charge par ActivationSignalDetector pour le assistant numérique. |
| ActivationSignalDetectorKind |
Spécifie les types ActivationSignalDetector pris en charge. |
| ActivationSignalDetectorPowerState |
Spécifie les modes d’alimentation, pris en charge par activationSignalDetector, qui décrivent les conditions liées à l’alimentation dans lesquelles un détecteur est autorisé à fonctionner. |
| ConversationalAgentActivationKind |
Spécifie les types d’activation d’agent pris en charge. |
| ConversationalAgentActivationResult |
Spécifie les valeurs de résultat de la demande d’activation de l’agent prise en charge. |
| ConversationalAgentSessionUpdateResponse |
Spécifie chaque réponse possible pour une mise à jour ConversationalAgentSession . |
| ConversationalAgentState |
Spécifie chaque AgentState possible pour un assistant numérique. |
| ConversationalAgentSystemStateChangeType |
Spécifie les modifications d’état possibles pour l’événement SystemStateChanged . |
| ConversationalAgentVoiceActivationPrerequisiteKind |
Spécifie les paramètres possibles requis pour le fonctionnement de l’activation vocale. |
| DetectionConfigurationAvailabilityChangeKind |
Spécifie les niveaux d’autorisation accordés par un utilisateur à chaque ActivationSignalDetectionConfigurationd’un ActivationSignalDetector. |
| DetectionConfigurationTrainingStatus |
Spécifie les états de données d’entraînement vocal reconnus par ActivationSignalDetector pour l’assistant numérique. Notes Ces déterminations sont effectuées par les algorithmes d’apprentissage d’un détecteur de signal individuel et peuvent être spécifiques aux implémentations matérielles ou logicielles du détecteur. |
| SignalDetectorResourceKind |
Spécifie les types de ressources système qui peuvent être signalées comme indisponibles pour une activationSignalDetectionConfiguration. |
Remarques
Les utilisateurs peuvent activer un signal de détection au niveau de la plateforme pour un agent conversationnel dans Paramètres. Ce signal peut inclure un énoncé mot clé, la transmission Bluetooth, l’accélérateur clavier système, la reconnaissance vocale dans l’application ou d’autres sons (claquement de porte, détecteur de fumée). Par exemple, le mot clé « Hey Cortana » qui commence une interaction vocale avec Cortana.
Les détecteurs de signal au niveau de la plateforme agissent comme un filtre de « première passe » et peuvent entraîner un trop grand nombre d’activations involontaires. Pour cette raison, nous vous recommandons d’envisager une vérification supplémentaire d’un signal d’activation, comme l’utilisation d’un détecteur de mot clé plus strict à partir du contexte de l’application de l’agent.
Si un Objet ConversationalAgentSignal est détecté alors que l’application n’est pas en cours d’exécution ou n’est pas en mesure de répondre à l’événement ConversationalAgentSession.SignalDetected , l’application est activée en arrière-plan à l’aide d’une tâche inscrite auprès d’un ConversationalAgentTrigger.
Si un ConversationalAgentSignal est détecté alors que l’application est en mesure de répondre à un événement ConversationalAgentSession.SignalDetected (en appelant ConversationalAgentSession.RequestAgentStateChangeAsync), aucune activation en arrière-plan ne se produit, car le signal a déjà été géré.
Si un ConversationalAgentSignal est détecté pour un agent conversationnel alors qu’une session interruptible (voir RequestInterruptableAsync) est déjà active, la session reçoit un événement ConversationalAgentSession.SessionInterrupted pour indiquer qu’un nouvel événement de signal a été déclenché.
Notes
Certaines sessions de assistant numériques ne peuvent pas être interrompues par un autre signal. Par exemple, Cortana exige que l’utilisateur émette une commande d’annulation ou d’arrêt pour mettre fin à la session active (l’utilisateur ne peut pas être dans une session Cortana et émettre des commandes à Alexa).