Partager via


Syntaxe du modèle

Important

LUIS sera mis hors service le 1er octobre 2025 et à partir du 1er avril 2023, vous ne pourrez plus créer de nouvelles ressources LUIS. Nous vous recommandons de migrer vos applications LUIS vers la compréhension du langage courant pour tirer parti de la prise en charge continue des produits et des fonctionnalités multilingues.

La syntaxe du modèle est un modèle d’énoncé. Le modèle doit contenir les mots et entités que vous souhaitez faire correspondre, ainsi que les mots et la ponctuation que vous souhaitez ignorer. Ce n’est pas une expression régulière.

Attention

Les modèles incluent uniquement les parents d’entité de Machine Learning, pas les sous-entités. Les entités des modèles sont placées entre accolades, {}. Les modèles peuvent inclure des entités et des entités avec rôles. Pattern.any est une entité qui n’est utilisée que dans les modèles.

Les modèles acceptent la syntaxe suivante :

Fonction Syntaxe Niveau d’imbrication Exemple
entité {} – accolades 2 Où se trouve le formulaire {nom-entité} ?
facultatif [] – crochets

Les niveaux d’imbrication de la syntaxe facultative et de la syntaxe de regroupement sont limités à trois, pour toutes les combinaisons possibles
2 Le point d’interrogation est facultatif [?]
regroupement () – parenthèses 2 est (a | b)
ou | - barre verticale (pipe)

Les barres verticales (ou) sont limitées à deux par groupe
- Où est le formulaire ({nom-court-formulaire} | {nom-long-formulaire} | {numéro-formulaire})
Début ou fin de l’énoncé ^ – accent circonflexe (caret) - ^commence l’énoncé
l’énoncé est terminé^
^correspondance littérale stricte de tout l’énoncé avec l’entité {numéro}^

Syntaxe d’imbrication dans les modèles

La syntaxe facultatif, entre crochets, peut être imbriquée sur deux niveaux. Par exemple : [[this]is] a new form. Cet exemple accepte les énoncés suivants :

Exemple d’énoncé facultatif imbriqué Explication
this is a new form correspond à tous les mots du modèle
is a new form correspond au mot facultatif externe et aux mots non facultatifs du modèle
a new form correspond uniquement aux mots obligatoires

La syntaxe regroupement, entre parenthèses, peut être imbriquée sur deux niveaux. Par exemple : (({Entity1:RoleName1} | {Entity1:RoleName2} ) | {Entity2} ). Cette fonctionnalité permet une correspondance avec chacune des trois entités.

Si Entity1 est un emplacement comportant des rôles comme l’origine (Seattle) et la destination (Cairo) et Entity2 un nom de bâtiment connu issu d’une entité de liste (RedWest-C), les énoncés suivants correspondent à ce modèle :

Exemple d’énoncé de regroupement imbriqué Explication
RedWest-C correspond à l’entité de regroupement externe
Seattle correspond à l’une des entités de regroupement internes
Le Caire correspond à l’une des entités de regroupement internes

Limites d’imbrication des groupes à syntaxe facultative

Les combinaisons entre les syntaxes regroupement et facultatif sont limitées à trois niveaux d’imbrication.

Autorisé Exemple
Oui ( [ ( test1 | test2 ) ] | test3 )
Non ( [ ( [ test1 ] | test2 ) ] | test3 )

Limites d’imbrication des groupes à syntaxe de type ou

Les combinaisons entre les syntaxes regroupement et ou sont limitées à deux barres verticales.

Autorisé Exemple
Oui ( test1 | test2 | ( test3 | test4 ) )
Non ( test1 | test2 | test3 | ( test4 | test5 ) )

Syntaxe pour ajouter une entité à un modèle

Pour ajouter une entité au modèle, placez le nom de l’entité entre accolades, comme Who does {Employee} manage?.

Modèle avec une entité
Who does {Employee} manage?

Syntaxe pour ajouter une entité et un rôle à un modèle

Le rôle d’une entité est indiqué par {entity:role} avec le nom de l’entité suivi d’un signe deux-points, puis du nom de rôle. Pour ajouter une entité et un rôle au modèle, placez le nom de l’entité et le nom du rôle entre accolades, comme Book a ticket from {Location:Origin} to {Location:Destination}.

Modèle avec des rôles d’entités
Book a ticket from {Location:Origin} to {Location:Destination}

Syntaxe pour ajouter un pattern.any à un modèle

L’entité Pattern.any vous permet d’ajouter une entité de longueur variable au modèle. Tant que le modèle est suivi, l’entité pattern.any peut être de n’importe quelle longueur.

Pour ajouter une entité Pattern.any au modèle, placez l’entité Pattern.any entre accolades, comme How much does {Booktitle} cost and what format is it available in?.

Modèle avec une entité Pattern.any
How much does {Booktitle} cost and what format is it available in?
Titres de livres dans le modèle
Combien Steal this book coûte-t-il et dans quel format est-il disponible ?
Combien Soufi, mon amour coûte-t-il et dans quel format est-il disponible ?
Combien Le Bizarre Incident du chien pendant la nuit coûte-t-il et dans quel format est-il disponible ?

Les mots du titre du livre ne gênent pas LUIS, car il sait où le titre du livre se termine grâce à l’entité Pattern.any.

Listes explicites

Créez une Liste explicite via l’API de création pour autoriser l’exception si les deux conditions suivantes sont réunies :

  • Votre modèle contient un Pattern.any.
  • La syntaxe de ce modèle autorise l’extraction d’une mauvaise entité selon l’énoncé.

Par exemple, supposons que vous disposez d’un modèle contenant la syntaxe facultative, [], et la syntaxe d’entité, {}, combinées de façon à extraire les données de manière incorrecte.

Prenons l’exemple du modèle « [trouver] e-mail sur {objet} [de {personne}] ».

Dans les énoncés suivants, les entités objet et personne sont extraites correctement et incorrectement :

Énoncé Entité Extraction correcte
e-mail sur les chiens de Chris objet = les chiens
personne = Chris
e-mail sur l’homme de La Manche objet = l’homme
personne = La Manche
X

Dans le tableau précédent, l’objet devrait être the man from La Mancha (titre de livre) ; cependant, comme il comporte le mot facultatif from, le titre est mal prédit.

Pour corriger cette exception dans le modèle, ajoutez the man from la mancha en tant que correspondance de liste explicite pour l’entité {objet} à l’aide de l’API de création de liste explicite.

Syntaxe pour marquer le texte facultatif dans un modèle d’énoncé

Marquez un texte facultatif dans l’énoncé à l’aide de la syntaxe en crochet d’expression régulière, []. Dans le texte facultatif, vous pouvez imbriquer jusqu'à deux crochets uniquement.

Modèle avec un texte facultatif Signification
[find] email about {subject} [from {person}] find et from {person} sont facultatifs.
`Can you help me[?] Le signe de ponctuation est facultatif

Les signes de ponctuation (?, ! et .) doivent être ignorés, avec la syntaxe entre crochets des modèles.

Étapes suivantes

Découvrez-en plus sur les modèles :

Découvrez comment les sentiments sont retournés dans la réponse .json.