Vous pouvez créer des entités personnalisées pour établir des correspondances entre des données spécifiques et votre agent.
Par exemple, vous pouvez définir un type d'entité vegetable qui peut correspondre aux types de légumes disponibles à la vente auprès d'un agent d'épicerie.
Créer des entités personnalisées
Pour créer une entité personnalisée :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre Google Cloud projet.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Cliquez sur Créer.
- Saisissez les données d'entité.
- Cliquez sur Save.
API
Utilisez la méthode create de EntityType.
Sélectionnez un protocole et une version pour la référence EntityType :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource EntityType | Ressource EntityType |
| RPC | Interface EntityType | Interface EntityType |
| 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 :
- Les noms à afficher des types d'entité personnalisés sont uniques pour chaque agent.
Les noms à afficher du type d'entité doivent commencer par une lettre et peuvent contenir les éléments suivants :
A-Z,a-z,0-9,_(trait de soulignement),-(tiret). Les valeurs de référence d'entité et de synonyme ne sont pas soumises à cette limitation.
Exporter et importer des entités personnalisées
Vous pouvez exporter et importer des entités pour les partager entre les agents.
L'une des options de format d'exportation est le package JSON, qui est un fichier ZIP contenant une hiérarchie de répertoires et de fichiers JSON. La structure des répertoires est la suivante :
entityTypes: ce répertoire contient vos types d'entités.<entity type name>: un ou plusieurs de ces répertoires existent, et leurs noms correspondent aux noms à afficher des types d'entités.entities: ce répertoire contient les fichiers d'entrées d'entités.<language tag>.json: un ou plusieurs de ces fichiers existent, et leurs noms correspondent aux balises de langue. Chaque fichier contient des entrées d'entités spécifiques à une langue.
<excludedPhrases>: ce répertoire contient les fichiers de phrases exclues.<language tag>.json: un ou plusieurs de ces fichiers existent, et leurs noms correspondent aux balises de langue. Chaque fichier contient des exclusions de phrases spécifiques à une langue.
<entity type name>.json: ce nom de fichier correspond à un nom à afficher de type d'entité. Le fichier contient des données spécifiques au type d'entité qui ne se trouvent pas dans d'autres fichiers.
Exemple :
entityTypes ⤷ Entity Type A ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type A.json ⤷ Entity Type B ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type B.json
Lors de l'importation de types d'entités, des conflits de fusion peuvent se produire lorsque le nom à afficher d'un type d'entité de votre agent existant correspond à celui d'un type d'entité importé. Vous pouvez contrôler le comportement de fusion lorsque les noms à afficher des types d'entités correspondent en sélectionnant l'une des options suivantes :
- Replace existing entity types (Remplacer les types d'entités existants) : un type d'entité importé écrase tout type d'entité portant le même nom dans votre agent existant.
- Merge with existing entity types (Fusionner avec les types d'entités existants) : les entrées d'entités d'un type d'entité importé sont ajoutées au type d'entité existant. Si les mêmes entrées d'entités existent, elles ne seront pas dupliquées, et les synonymes qui leur sont associés seront fusionnés.
- Rename and import as new entity types (Renommer et importer en tant que nouveaux types d'entités) : le type d'entité importé est renommé en ajoutant "_1" au nom à afficher.
- Skip the entity types (Ignorer les types d'entités) : le type d'entité existant reste inchangé, et le type d'entité importé est ignoré.
Pour exporter des types d'entités :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre Google Cloud projet.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Sélectionnez tous les types d'entités que vous souhaitez exporter.
- Cliquez sur Export selected entity (Exporter l'entité sélectionnée).
- Sélectionnez le format et la destination.
- Cliquez sur Envoyer.
Pour importer des types d'entités :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre Google Cloud projet.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Cliquez sur Importer.
- Sélectionnez la source et le comportement de fusion.
- Cliquez sur Envoyer.
Importer des entrées d'entités
Vous pouvez importer des entrées d'entités dans un type d'entité existant.
Le format de fichier utilisé pour importer des entrées d'entités est le même que celui utilisé pour importer des types d'entités. Toutefois, le fichier d'importation ne peut contenir qu'un seul type d'entité, et toutes les entrées qu'il contient seront importées dans le type d'entité sélectionné. Si les mêmes entrées d'entités existent, elles ne seront pas dupliquées, et les synonymes qui leur sont associés seront fusionnés.
Pour importer des entrées d'entités pour un type d'entité :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre Google Cloud projet.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Sélectionnez une entité.
- Cliquez sur Import to entity (Importer dans l'entité).
- Sélectionnez un fichier.
- Cliquez sur Envoyer.