Entités personnalisées

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

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Entity Types (Types d'entités).
  6. Cliquez sur Créer.
  7. Saisissez les données d'entité.
  8. 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. Voici la structure de répertoires:

  • 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 du type d'entité.
      • entities: ce répertoire contient les fichiers d'entrée d'entité.
        • <language tag>.json: un ou plusieurs de ces fichiers existent, et leurs noms correspondent à des tags de langue. Chaque fichier contient des entrées d'entités spécifiques à une langue.
      • <excludedPhrases>: ce répertoire contient les fichiers d'expressions exclues.
        • <language tag>.json: un ou plusieurs de ces fichiers existent, et leurs noms correspondent à des tags 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 pour un 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

Lorsque vous importez des 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 des types d'entités 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é portant le même nom dans votre agent existant.
  • Fusionner avec des 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 des entrées d'entités identiques existent, elles ne seront pas dupliquées, et les synonymes sous-jacents 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

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Entity Types (Types d'entités).
  6. Sélectionnez tous les types d'entités que vous souhaitez exporter.
  7. Cliquez sur Exporter l'entité sélectionnée.
  8. Sélectionnez le format et la destination.
  9. Cliquez sur Envoyer.

Pour importer des types d'entités:

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Entity Types (Types d'entités).
  6. Cliquez sur Importer.
  7. Sélectionnez la source et le comportement de fusion.
  8. Cliquez sur 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é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 sous celui-ci seront importées dans le type d'entité sélectionné. Si des entrées d'entités identiques existent, elles ne seront pas dupliquées, et les synonymes sous-jacents seront fusionnés.

Pour importer des entrées d'entité pour un type d'entité:

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Entity Types (Types d'entités).
  6. Sélectionnez une entité.
  7. Cliquez sur Importer dans l'entité.
  8. Sélectionnez un fichier.
  9. Cliquez sur Envoyer.