Share via

Concepts et définitions de commandes personnalisées

  • Article

Important

Les Commandes personnalisées seront mises hors service le 30 avril 2026. Depuis le 30 octobre 2023, vous ne pouvez pas créer de nouvelles applications Commandes personnalisées dans Speech Studio. En lien avec ce changement, LUIS sera mis hors service le 1er octobre 2025. Depuis le 1er avril 2023, vous ne pouvez pas créer de nouvelles ressources LUIS.

Cet article sert de référence pour les concepts et définitions des applications Commandes personnalisées.

Configuration des commandes

Les commandes représentent les blocs de construction de base d’une application Commandes personnalisées. Une commande est un ensemble de configurations requises pour effectuer une tâche spécifique définie par un utilisateur.

Exemples de phrases

Les exemples d’énoncés sont des exemples définis que l’utilisateur peut prononcer pour déclencher une commande particulière. Vous devez fournir uniquement un échantillon d’énoncés et non une liste exhaustive.

Paramètres

Les paramètres constituent des informations requises par les commandes pour effectuer une tâche. Dans des scénarios complexes, les paramètres peuvent également servir à définir des conditions qui déclenchent des actions personnalisées.

Règles d'exécution

Les règles d’exécution sont une série de règles à exécuter une fois la commande prête à être remplie, par exemple, lorsque toutes les conditions des règles sont satisfaites.

Règles d'interaction

Les règles d’interaction sont des règles supplémentaires qui traitent des situations plus spécifiques ou complexes. Vous pouvez ajouter d’autres validations, ou configurer des fonctionnalités avancées comme des confirmations ou une correction en une étape. Vous pouvez également créer vos propres règles d’interaction personnalisées.

Configuration des paramètres

Les paramètres constituent des informations requises par les commandes pour effectuer une tâche. Dans des scénarios complexes, les paramètres peuvent également servir à définir des conditions qui déclenchent des actions personnalisées.

Nom

Un paramètre est identifié par la propriété de nom. Vous devez toujours attribuer un nom descriptif à un paramètre. Un paramètre peut être référencé dans différentes sections, par exemple, lors de la construction de conditions, de réponses vocales ou d’autres actions.

Obligatoire

Cette case à cocher indique si une valeur de ce paramètre est requise pour exécuter la commande. Vous devez configurer les réponses pour inviter l’utilisateur à fournir une valeur si un paramètre est marqué comme étant obligatoire.

Si vous avez configuré un paramètre obligatoire avec une valeur par défaut, le système demande toujours la valeur du paramètre.

Type

Les commandes personnalisées prennent en charge les types de paramètres suivants :

  • Age
  • Devise
  • DateTime
  • Dimension
  • E-mail
  • Geography
  • Number
  • Ordinal
  • Pourcentage
  • PersonName
  • PhoneNumber
  • Chaîne
  • Température
  • Url

Chaque paramètre régional prend en charge le type de paramètre « String », mais la disponibilité de tous les autres types diffère selon les paramètres régionaux. Les commandes personnalisées utilisant la résolution d’entité prédéfinie de LUIS, la disponibilité d’un type de paramètre dans des paramètres régionaux dépend de la prise en charge des entités prédéfinies de LUIS dans ces paramètres régionaux. Vous trouverez plus d’informations sur la prise en charge des entités prédéfinies par les paramètres régionaux de Luis. Les entités LUIS personnalisées (par exemple les entités de machine learning) ne sont pas prises en charge pour le moment.

Certains types de paramètres comme Nombre, Chaîne et DateHeure prennent en charge la configuration de valeurs par défaut, que vous pouvez configurer à partir du portail.

Configuration

Configuration est une propriété de paramètre définie uniquement pour le type Chaîne. Les valeurs suivantes sont admises :

  • Aucun.
  • Accepter une entrée complète : lorsqu’il est activé, un paramètre accepte tout énoncé d’entrée. Cette option est utile lorsque l’utilisateur a besoin d’un paramètre avec l’énoncé complet. Par exemple, les adresses postales.
  • Accepter les valeurs d’entrée prédéfinies d’un catalogue externe : cette valeur est utilisée pour configurer un paramètre qui peut accepter une grande variété de valeurs. Un catalogue de ventes en est un exemple. Dans ce cas, le catalogue est hébergé sur un point de terminaison web externe et peut être configuré indépendamment.
  • Accepter les valeurs d’entrée prédéfinies du catalogue interne : cette valeur est utilisée pour configurer un paramètre qui peut accepter quelques valeurs. Dans ce cas, les valeurs doivent être configurées dans Speech Studio.

Validation

Les validations sont des constructions applicables à certains types de paramètres qui vous permettent de configurer des contraintes sur la valeur d’un paramètre. Actuellement, les commandes personnalisées prennent en charge les validations sur les types de paramètres suivants :

  • DateTime
  • Number

Configuration de règles

Une règle dans Commandes personnalisées est définie par un ensemble de conditions qui, lorsqu’elles sont remplies, exécutent un ensemble d’actions. Les règles vous permettent également de configurer l’état après exécution et des attentes pour le tour suivant.

Types

Les commandes personnalisées prennent en charge les catégories de règles suivantes :

  • Règles d’exécution : ces règles doivent être exécutées lors de l’exécution de la commande. Toutes les règles configurées dans cette section pour lesquelles les conditions sont vraies seront exécutées.
  • Règles d’interaction : ces règles peuvent être utilisées pour configurer d’autres validations personnalisées, des confirmations et une correction en une étape, ou pour appliquer toute autre logique de dialogue personnalisée. Les règles d’interaction sont évaluées à chaque étape de traitement et permettent de déclencher des règles d’exécution.

Les différentes actions configurées dans le cadre d’une règle sont exécutées dans l’ordre dans lequel elles apparaissent dans le portail de création.

Conditions

Les conditions sont les exigences qui doivent être satisfaites pour qu’une règle s’exécute. Les conditions de règles se présente sous plusieurs formes :

  • La valeur du paramètre est égale à : la valeur du paramètre configuré est égale à une valeur spécifique.
  • Aucune valeur de paramètre : les paramètres configurés ne doivent pas avoir de valeur.
  • Paramètres obligatoires : le paramètre configuré a une valeur.
  • Tous les paramètres obligatoires : tous les paramètres qui ont été marqués comme obligatoires ont une valeur.
  • Paramètres mis à jour : une ou plusieurs valeurs de paramètre ont été mises à jour suite au traitement de l’entrée actuelle (énoncé ou activité).
  • Confirmation réussie : l’énoncé ou l’activité d’entrée est une confirmation réussie (oui).
  • La confirmation a été refusée : l’énoncé ou l’activité d’entrée n’était pas une confirmation de réussite (non).
  • La commande précédente doit être mise à jour : cette condition est utilisée dans les instances où vous souhaitez intercepter une confirmation négative avec une mise à jour. En arrière-plan, cette condition est configurée dans le cas suivant : le moteur de dialogue détecte une confirmation négative, l’intention est identique à celle du tour précédent, et l’utilisateur a répondu avec une mise à jour.

Actions

  • Envoyer une réponse vocale : envoyer une réponse vocale au client.
  • Mettre à jour la valeur de paramètre : mettre à jour la valeur d’un paramètre de commande avec une valeur spécifiée.
  • Effacer la valeur de paramètre : effacer la valeur du paramètre de commande.
  • Appeler un point de terminaison web : appeler un point de terminaison web.
  • Envoyer l’activité au client : envoyer une activité personnalisée au client.

Attentes

Les attentes servent à configurer des conseils pour le traitement de l’entrée utilisateur suivante. Les types suivants sont pris en charge :

  • Attente de confirmation de l’utilisateur : cette attente spécifie que l’application attend une confirmation (oui/non) pour l’entrée utilisateur suivante.
  • Attente d’entrée de paramètre de l’utilisateur : cette attente spécifie un ou plusieurs paramètres de commande que l’application attend de l’entrée utilisateur.

État après exécution

L’état après exécution désigne l’état de la boîte de dialogue après traitement de l’entrée actuelle (énoncé ou activité). Défini selon l’un des types suivants :

  • Conserver l’état actuel : conserver l’état actuel uniquement.
  • Exécuter la commande : exécuter la commande sans traiter aucune autre règle de la commande.
  • Exécuter les règles d’exécution : exécuter toutes les règles d’exécution valides.
  • Attente d’entrée de l’utilisateur : attendre l’entrée utilisateur suivante.

Étapes suivantes

Voir des exemples sur GitHub