Par défaut, la mise en correspondance d'une entité requiert l'établissement d'une correspondance exacte pour l'une de ses entrées d'entité. Ce mode de fonctionnement convient quand les valeurs d'entrée d'entité et les synonymes sont constitués d'un seul mot, mais il peut poser problème lorsqu'ils comportent plusieurs mots. Par exemple, supposons qu'une entité balle doive correspondre aux éléments d'expression d'utilisateur final suivants :
- "balle"
- "balle rouge"
- "rouge balle"
- "petite balle"
- "balle petite"
- "petite balle rouge"
- "petite rouge balle "
- "rouge petite balle"
- "rouge balle petite"
- "balle petite rouge"
- "balle rouge petite"
Pour qu'une correspondance se produise, vous devez normalement définir une valeur d'entrée d'entité et des synonymes pour chacune de ces permutations. Cependant, si la correspondance partielle est activée, l'ordre des mots au sein d'une valeur ou d'un synonyme n'a pas d'importance. Les éléments suivants déclencheront une correspondance pour tous les exemples ci-dessus :
- "balle"
- "balle rouge"
- "petite balle"
- "petite balle rouge"
Créer une entité à correspondance partielle
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet GCP.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Cliquez sur Créer.
- Cochez la case Correspondance partielle.
- Renseignez les champs restants.
- Cliquez sur Enregistrer.
API
Définissez le champ EntityType.enableFuzzyExtraction sur "true".
Sélectionnez un protocole et une version pour la référence EntityType :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource EntityType | Ressource EntityType |
| RPC | Interface de type d'entité | Interface de type d'entité |
| C++ | EntityTypesClient | Non disponible |
| C# | EntityTypesClient | Non disponible |
| Go | EntityTypesClient | Non disponible |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | Non disponible | Non disponible |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | Non disponible | Non disponible |
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.
- La correspondance partielle ne doit pas être activée pour les entités censées correspondre à des valeurs strictes, telles que des ID, des numéros nationaux d'identification, etc.