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 projet Google Cloud.
- 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 Enregistrer.
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 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 :
- 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 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. Voici une description de la structure de répertoire:
entityTypes: ce répertoire contient vos types d'entités.<entity type name>: un ou plusieurs de ces répertoires existent, et les noms de répertoires correspondent aux noms à afficher du type d'entité.entities: ce répertoire contient des fichiers d'entrée d'entité.<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é spécifiques à la langue.
<excludedPhrases>: ce répertoire contient des fichiers d'expressions exclues.<language tag>.json: un ou plusieurs de ces fichiers existent, et leurs noms correspondent aux balises de langue. Chaque fichier contient des exclusions d'expressions spécifiques à une langue.
<entity type name>.json: ce nom de fichier correspond au nom à afficher d'un type d'entité. Le fichier contient des données spécifiques au type d'entité introuvables 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é dans votre agent existant correspond à celui d'un type d'entité importé. Vous pouvez contrôler le comportement de fusion lorsque les noms à afficher du type d'entité correspondent en sélectionnant l'une des options suivantes:
- Remplacer les types d'entités existants: un type d'entité importé écrase tout type d'entité du même nom dans votre agent existant.
- Fusionner avec les types d'entités existants : les entrées d'entité d'un type d'entité importé sont ajoutées au type d'entité existant. Si les mêmes entrées d'entité existent, elles ne seront pas dupliquées et les synonymes qu'elles contiennent seront fusionnés.
- Renommer et importer en tant que nouveaux types d'entités : le type d'entité importé est renommé en ajoutant "_1" au nom à afficher.
- 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 projet Google Cloud.
- 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 Exporter l'entité sélectionnée.
- Sélectionnez le format et la destination.
- Cliquez sur Submit (Envoyer).
Pour importer des types d'entités:
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- 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 Submit (Envoyer).
Importer des entrées d'entité
Vous pouvez importer des entrées d'entité dans un type d'entité existant.
Le format de fichier utilisé pour importer des entrées d'entité est identique à 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é existent, elles ne seront pas dupliquées et les synonymes qu'elles contiennent seront fusionnés.
Pour importer des entrées d'entité pour un type d'entité:
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Entity Types (Types d'entités).
- Sélectionnez une entité.
- Cliquez sur Importer dans l'entité.
- Sélectionnez un fichier.
- Cliquez sur Submit (Envoyer).