Certaines entités doivent correspondre à des formats plutôt qu'à des termes spécifiques. Il s'agit par exemple de numéros nationaux d'identification, d'identifiants, de numéros de plaque d'immatriculation, etc. Les entités d'expression régulière vous permettent de fournir des expressions régulières pour la mise en correspondance.
Où trouver ces données
La méthode la plus courante pour créer un agent consiste à utiliser la console Dialogflow ES (consulter la documentation, ouvrir la console). Les instructions ci-dessous concernent l'utilisation de la console. Pour accéder aux données d'entité :
- Accédez à la console Dialogflow ES.
- Sélectionnez un agent.
- Sélectionnez Entités dans le menu de la barre latérale gauche.
Si vous créez un agent à l'aide de l'API au lieu de la console, consultez la documentation de référence sur le type EntityTypes. Les champs portent le même nom dans l'API et dans la console. Le cas échéant, les différences notables entre la console et l'API sont signalées dans les instructions ci-dessous.
Expressions régulières composées
Chaque entité d'expression régulière correspond à un seul format, mais vous pouvez fournir plusieurs expressions régulières si chacune d'elles représente une variante d'un même format.
Lors de l'entraînement des agents, toutes les expressions régulières d'une même entité sont combinées à l'aide de l'opérateur d'alternance | de façon à former une expression régulière composée.
Par exemple, si vous fournissez les expressions régulières suivantes pour un numéro de téléphone :
^[2-9]\d{2}-\d{3}-\d{4}$^(1?(-?\d{3})-?)?(\d{3})(-?\d{4})$
L'expression régulière composée devient :
^[2-9]\d{2}-\d{3}-\d{4}$|^(1?(-?\d{3})-?)?(\d{3})(-?\d{4})$
L'ordre des expressions régulières est important. Chacune des expressions régulières formant l'expression régulière composée va être traitée dans l'ordre selon lequel elles sont spécifiées. La recherche s'arrête dès qu'une correspondance valide est trouvée. Ainsi, pour l'expression d'utilisateur final "Seattle" :
- la première correspondance valide de l'expression régulière composée
Sea|Seattleest "Sea" ; - la première correspondance valide de l'expression régulière composée
Seattle|Seaest "Seattle".
Traitement spécial associé à la reconnaissance vocale
Si votre agent utilise la reconnaissance vocale, également appelée "entrée audio" ou "speech-to-text" (STT), vos expressions régulières requièrent un traitement particulier pour la mise en correspondance des lettres et des chiffres. Un énoncé parlé de l'utilisateur final est traité par le système de reconnaissance vocale préalablement à la mise en correspondance des entités. Lorsqu'un énoncé contient une série de lettres ou de chiffres, l'outil de reconnaissance est susceptible d'insérer des espaces de part et d'autre de chaque caractère. En outre, l'outil de reconnaissance peut aussi interpréter les chiffres en les retranscrivant en toutes lettres. Par exemple, l'énoncé d'utilisateur final "Mon identifiant est 123" peut être reconnu de différentes façons, comme suit :
- "Mon ID est 123"
- "Mon ID est 1 2 3"
- "Mon ID est un deux trois"
Pour accepter des nombres à trois chiffres, vous pouvez utiliser les expressions régulières suivantes :
\d{3}
\d \d \d
(zero|one|two|three|four|five|six|seven|eight|nine) (zero|one|two|three|four|five|six|seven|eight|nine) (zero|one|two|three|four|five|six|seven|eight|nine)
Créer une entité d'expression régulière
Pour créer une entité d'expression régulière, procédez comme suit :
- Ouvrez une entité existante ou créez-en une.
- Cochez la case Regexp entity (Entité d'expression régulière).
- Saisissez une ou plusieurs expressions régulières dans le tableau des entrées.
- Cliquez sur Enregistrer.
Si vous utilisez l'API pour la création ou la mise à jour d'entités, spécifiez KIND_REGEXP pour le champ définissant le genre d'entité.
Limites
Les limites suivantes s'appliquent :
- Il est impossible d'activer la correspondance partielle pour les entités d'expression régulière. Ces deux fonctionnalités sont mutuellement exclusives.
- Chaque agent peut comporter jusqu'à 50 entités d'expression régulière.
- L'expression régulière composée associée à une entité ne peut pas comporter plus de 1 024 caractères.