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.

Remarque : Lorsque vous créez votre agent, il est préférable de définir les entités avant d'ajouter les phrases d'entraînement aux intents. La console annote automatiquement vos phrases d'entraînement en fonction des entités existantes. Toutefois, si vous créez des entités après des phrases d'entraînement, vous pouvez les annoter manuellement.

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és personnalisées :

1. Accédez à la console Dialogflow ES.
2. Sélectionnez un agent.
3. Sélectionnez Entités dans le menu de la barre latérale gauche.
4. Sélectionnez l'onglet Personnalisé pour les entités personnalisées.

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. Les instructions ci-dessous présentent les différences importantes entre la console et l'API.

Créer des entités personnalisées

Pour créer un mappage d'entité personnalisée :

1. Cliquez sur Create entity (Créer une entité).
2. Saisissez un nom pour l'entité.
3. Notez que l'option Define synonyms (Définir les synonymes) est déjà sélectionnée.
4. Cliquez sur la première ligne et saisissez une valeur de référence dans la colonne de gauche.
5. Cliquez sur la colonne suivante ou appuyez sur Entrée, puis indiquez des synonymes.
6. Continuez à ajouter des lignes pour d'autres entrées d'entités.
7. Cliquez sur Save (Enregistrer).

Opérations par lot

Vous pouvez déplacer, copier ou supprimer plusieurs entités à l'aide d'opérations par lot :

• Copier : copie les entités sélectionnées sur l'agent cible.
• Déplacer : déplace les entités sélectionnées vers l'agent cible.
• Supprimer : supprime définitivement les entités sélectionnées. Cette action est irréversible.

Des options supplémentaires sont proposées pour les opérations "Copier" et "Déplacer" :

• Copier les entités associées : déplace ou copie les entités utilisées dans des entités composites.
• Écraser les entités : écrase les entités portant le même nom.

Pour copier, déplacer ou supprimer plusieurs entités, procédez comme suit :

1. Passez la souris sur la liste et sélectionnez une ou plusieurs entités. Les options de traitement par lot s'affichent.
2. Choisissez l'action souhaitée.
3. Sélectionnez les options souhaitées dans la boîte de dialogue.
4. Cliquez sur Démarrer.

Limites

Les limites suivantes s'appliquent :

• Les noms de types d'entités personnalisées sont uniques pour chaque agent. Les noms de types d'entités 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.