Entités système

Dialogflow fournit de nombreuses entités système permettant d'extraire les types de valeurs les plus courants des expressions d'utilisateur final. Par exemple, le type @sys.color permet d'extraire des valeurs telles que "rouge" ou "bleu". Vous trouverez la liste complète des entités système dans la documentation de référence sur les entités système.

Les valeurs fournies par les entités système conviennent pour la plupart des applications. Il se peut cependant que votre application nécessite l'ajout de valeurs supplémentaires pour certaines entités système. Par exemple, vous pourriez avoir besoin d'ajouter "bleu-vert" à la liste des valeurs de l'entité système @sys.color. Certaines entités système peuvent être étendues à cette fin. La documentation de référence sur les entités système répertorie les entités système pouvant être étendues. Les sections suivantes de ce document expliquent comment étendre les entités système.

Où trouver ces données

La méthode la plus courante pour créer un agent consiste à utiliser la console Dialogflow (consulter la documentation, ouvrir la console). Les instructions ci-dessous concernent l'utilisation de la console. Pour accéder aux données sur les entités système de votre agent, procédez comme suit :

  1. Accédez à la console Dialogflow.
  2. Sélectionnez un agent.
  3. Sélectionnez Entités dans le menu de la barre latérale gauche.
  4. Cliquez sur l'onglet System (Système) pour accéder aux entités système.

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.

Étendre une entité système à partir de la page des entités

À partir de la page des entités, vous pouvez afficher les entités système utilisées par votre agent et les étendre en procédant comme suit :

  1. Utilisez l'entité système dans l'un de vos paramètres.
  2. Sélectionnez Entités dans le menu de la barre latérale gauche.
  3. Cliquez sur l'onglet System (Système) pour accéder aux entités système.
  4. La liste des entités système actuellement utilisées par votre agent s'affiche. Les entités dont le nom est affiché dans une couleur de police normale sont extensibles, en revanche celles dont le nom est affiché en gris ne sont pas extensibles.
  5. Vous pouvez sélectionner une entité extensible et mettre à jour les valeurs étendues.
  6. Fournissez des entrées d'entité en utilisant les valeurs avec lesquelles vous souhaitez étendre l'entité.

Capture d'écran de l'onglet des entités système

Étendre une entité système avec l'API

Pour étendre des entités système à l'aide de l'API, créez des extensions d'entité système en procédant de la même façon que pour la création d'une entité personnalisée. Indiquez le nom de l'entité système que vous souhaitez étendre et indiquez les valeurs à inclure dans l'extension. Si l'entité système que vous tentez d'étendre n'est pas extensible, une erreur est renvoyée.

Étendre une entité système tout en annotant une expression d'entraînement

Sur la page d'un intent, la section concernant les expressions d'entraînement vous permet d'étendre une entité système tout en annotant une expression d'entraînement. Si vous annotez manuellement une partie d'une expression d'entraînement à l'aide d'une entité système extensible qui n'inclut pas la valeur sélectionnée, il vous est demandé d'ajouter la valeur manquante à cette entité système.