Réponses

Chaque intent dispose d'un gestionnaire de réponses intégré qui peut renvoyer des réponses une fois l'intent associé. Cette fonctionnalité n'est compatible qu'avec les réponses statiques. Vous pouvez néanmoins utiliser des références de paramètres dans ces réponses pour les rendre plus dynamiques. Ceci est utile pour récapituler les informations fournies par l'utilisateur final. Par exemple, votre réponse d'intent peut être semblable à ceci : "D'accord, j'ai réservé une chambre pour vous le $Date".

Dans certains cas, c'est tout ce dont vous avez besoin. Lorsque votre code doit exécuter une action ou générer une réponse plus dynamique, vous devez configurer l'une des options de réponse dynamique ci-dessous. Les agents emploient généralement une combinaison de réponses statiques et dynamiques.

Plusieurs types de réponses peuvent être fournis. Le type de réponse de base est une réponse textuelle. D'autres types de réponses sont disponibles (image, audio, synthèse vocale, etc.). Certaines d'entre elles sont spécifiques à une plate-forme.

Si vous définissez plusieurs variantes de réponse pour un intent, votre agent sélectionne une réponse de manière aléatoire. Vous devez ajouter plusieurs variantes de réponse pour que la conversation avec votre agent soit plus naturelle.

Lorsque vous créez un agent, vous devez fournir des données de réponse pour chaque intent. Lorsque vous interagissez avec Dialogflow à l'aide de l'API ou d'un fulfillment, vous n'avez pas nécessairement besoin de fournir des données de réponse, car ces deux méthodes peuvent générer n'importe quelle réponse de manière dynamique. En revanche, vous devez fournir les données de réponse si vous souhaitez tester ou définir des intents avec une réponse simple à l'aide du simulateur.

En règle générale, vos réponses d'intent doivent inciter l'utilisateur final à fournir une expression correspondant à un autre intent. Vos réponses doivent également inciter l'utilisateur final à fournir des données spécifiques. Par exemple, une question comme "Dans quelle ville êtes-vous né ?" est plus utile qu'une question plus ouverte comme "Où êtes-vous né ?".

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 de réponse d'un intent, procédez comme suit :

  1. Accédez à la console Dialogflow.
  2. Sélectionnez un agent.
  3. Cliquez sur Intents dans le menu de la barre latérale gauche.
  4. Sélectionnez un intent.
  5. Faites défiler la page vers le bas jusqu'à la section Responses (Réponses).

Si vous créez un agent à l'aide de l'API au lieu de la console, consultez la documentation de référence sur les intents. 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.

Plate-formes de réponse

Chaque réponse est définie pour la plate-forme Par défaut (appelée PLATFORM_UNSPECIFIED dans l'API) ou pour une plate-forme d'intégration spécifique. Si vous n'utilisez pas d'intégration, toutes vos réponses peuvent utiliser la plate-forme par défaut. Si vous utilisez des intégrations, chacune d'elles peut avoir une réponse unique ou être configurée pour utiliser la réponse par défaut.

Pour plus d'informations sur les réponses spécifiques à une plate-forme, consultez la page Messages de réponses enrichies.

Créer des réponses intégrées

Pour créer des réponses intégrées, procédez comme suit :

  1. Sélectionnez Par défaut ou une plate-forme spécifique.
  2. Si le type de réponse souhaité (par exemple, Text response (Réponse textuelle)) ne figure pas encore dans la liste, cliquez sur Add Responses (Ajouter des réponses), puis sélectionnez le type de réponse.
  3. Saisissez les informations requises pour la réponse.
  4. Cliquez sur Save (Enregistrer).

Réponses dynamiques avec le fulfillment

Grâce au fulfillment, vous pouvez créer des réponses dynamiques. Pour en savoir plus, consultez les documents sur le fulfillment.

Réponses dynamiques avec l'API

L'API vous permet de créer des réponses dynamiques. Pour plus d'informations, consultez la présentation de l'API.

Caractères spéciaux

Certains caractères spéciaux nécessitent un échappement dans votre réponse.

Pour utiliser le symbole du dollar $ ou le signe typographique # dans une réponse, ajoutez des accolades {} autour du contenu qui suit immédiatement le signe. Exemple :

  • ${100} renvoie $100.
  • ${$number} renvoie $100, où $number est une référence de paramètre avec une valeur égale à 100.
  • #{hello} renvoie #hello.

Vous devez utiliser des accolades doubles {} dans votre réponse. Exemple :

  • {{hello}} renvoie {hello}.

Traiter des valeurs de paramètres vides

Si votre intent contient un paramètre pouvant renvoyer une valeur vide, vous devez fournir au moins une variante de réponse qui n'utilise pas ce paramètre.

Par exemple, si votre intent contient deux paramètres (p1 et p2) et si l'un d'entre eux ou les deux peuvent être vides, vous devez fournir au moins quatre variantes de réponse :

  • D'accord. Vous avez indiqué $p1 et $p2.
  • D'accord. Vous avez indiqué $p1.
  • D'accord. Vous avez indiqué $p2.
  • D'accord.