Windows.ApplicationModel.ConversationalAgent Espace de noms

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