Composants
Les états d'un flux de dialogue sont basés sur des composants qui effectuent des actions, telles que l'acceptation d'une entrée utilisateur, la vérification de cette entrée ou la réponse avec du texte.
Il existe deux types de composant que vous pouvez utiliser dans un flux de dialogue : des composants intégrés et des composants personnalisés. Lorsque le moteur de dialogue parvient à un état du flux de dialogue, il évalue le composant. Lorsqu'il détecte l'un des composants intégrés, il exécute une des tâches génériques, par exemple afficher un message ou demander à l'utilisateur d'entrer du texte. Lorsque le moteur de dialogue détecte un composant personnalisé, il appelle le service du composant, qui héberge un ou plusieurs composants personnalisés.
Composants intégrés
Digital Assistant fournit un jeu de composants qui prennent en charge une variété d'actions génériques. Vous pouvez les utiliser dans n'importe quelle compétence : sécurité, analyse de l'entrée utilisateur, routage du flux de dialogue en fonction de cette entrée et sortie des réponses de la compétence de différentes façons. Excepté dans les cas où vous devez procéder à l'intégration avec des systèmes dorsaux ou exécuter une logique extrêmement complexe, ces composants fournissent les actions dont vos états ont besoin.
La façon dont vous accédez aux composants dépend de la conception du flux de dialogue avec Visual Flow Designer ou en mode YAML :
- Si vous utilisez le concepteur de flux visuel, vous ajoutez le premier état d'un composant intégré à un flux en pointant sur sa vignette Démarrer, en cliquant sur le menu
, en sélectionnant Ajouter un état de début, puis en sélectionnant un modèle de composant dans la boîte de dialogue Ajouter un état. Vous pouvez ajouter des états suivants en sélectionnant Ajouter un état dans le menu d'un état ou en cliquant sur l'icône Ajouter un état à cette transition entre deux états. Voir Conception de flux.
- Si vous concevez votre compétence en mode YAML, vous ajoutez un état pour un composant intégré à votre flux de dialogue en sélectionnant + Components (Composants), puis en sélectionnant un modèle de composant dans le menu.
Lorsque vous validez votre flux de dialogue, Digital Assistant vérifie les propriétés du composant. Par exemple, il signale si vous avez oublié d'inclure une propriété obligatoire.
Pour plus de détails sur les modèles de composant disponibles dans le concepteur de flux visuel, voir Modèles de composant.
Pour plus de détails sur les composants disponibles en mode YAML, voir Composants intégrés : Propriétés, transitions et utilisation.
Composants personnalisés
La plupart des compétences doivent s'intégrer aux données des systèmes distants ou effectuer un traitement dorsal. Par exemple, votre compétence doit obtenir une liste de produits ou enregistrer des informations de commande. Elle peut également avoir à exécuter une logique complexe que vous ne pouvez pas accomplir à l'aide de FreeMarker ou d'un programme de traitement d'événements d'entité. Les composants personnalisés permettent d'effectuer une intégration aux systèmes dorsaux ainsi que d'accomplir des tâches non couvertes par les composants intégrés.
Pour apprendre à créer un composant personnalisé, voir Mettre en oeuvre des composants personnalisés. Pour savoir comment ajouter des composants personnalisés à utiliser dans votre compétence, voir Ajouter un ensemble de composants à une compétence. Pour en savoir plus sur les composants personnalisés, allez à la page Components (Composants) de la compétence, développez le service de composants et sélectionnez le composant. Le nom, les propriétés et les actions du composant s'affichent. Utilisez ces informations pour créer l'état du composant dans le flux de dialogue.
Conseil :
Comme il est possible que les composants de services différents portent le même nom, vous pouvez ajouter le nom du service, suivi d'un deux-points (:
), devant celui du composant afin de référencer de manière unique chaque composant personnalisé utilisé.
Voici un exemple d'état de composant personnalisé dans un flux de dialogue développé en mode YAML. Le composant hello.world
provient du service custom
.
start:
component: "custom:helloWorld"
properties:
human: "${human.value}"
transitions:
next: "askAge"
Lorsque vous utilisez le service de composants intégrés pour héberger vos composants personnalisés, vous pouvez accéder aux journaux et aux rapports de défaillance des composants depuis la page Components (Composants). Sélectionnez le service, puis cliquez sur Diagnostics.
Autres propriétés disponibles pour les composants personnalisés en mode YAML
Lors du développement de flux de dialogue en mode YAML, vous pouvez inclure ces propriétés dans l'état du composant personnalisé en plus des propriétés définies par le composant.
Nom | Description | Obligatoire? |
---|---|---|
autoNumberPostbackActions |
Lorsqu'elle est réglée à true , cette option ajoute un préfixe numérique aux boutons et aux options de liste. Même si cette option n'est pas réglée à true , la numérotation automatique peut être appliquée aux éléments avec carte lorsque la configuration Enable Auto Numbering on Postback Actions (Activer la numérotation automatique pour les actions de republication) de l'assistant numérique est réglée à true . La valeur par défaut est false .
|
No |
insightsEndConversation |
Réglez à true pour arrêter l'enregistrement de la conversation pour le rapport de données clés. La valeur par défaut est false .
|
No |
insightsInclude |
Indique s'il faut inclure l'état dans les rapports de données clés. La valeur par défaut est true .
|
No |
translate |
Utilisez cette propriété pour remplacer la valeur booléenne que vous avez définie pour la variable de contexte autotranslate . Si vous n'avez pas défini la variable autotranslate ou si vous l'avez réglée à false , vous pouvez régler cette propriété à true afin d'activer la traduction automatique pour ce composant uniquement. Si vous avez réglé la variable autotranslation à true , vous pouvez régler cette propriété à false pour exclure ce composant de la traduction automatique. Voir Services de traduction dans les compétences. La valeur par défaut est celle de la variable de contexte autotranslate .
|
No |
Ces propriétés ne sont pas disponibles pour les états des flux de dialogue que vous développez avec Visual Flow Designer.