Documentation Oracle Cloud Infrastructure

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.

Vous pouvez utiliser deux types de composant dans un flux de dialogue : des composants intégrés et des composants personnalisés. Lorsque le moteur de dialogue entre dans un état dans le flux de dialogue, il évalue le composant. Lorsqu'il rencontre l'un des composants intégrés, il exécute l'une des tâches génériques, telles que l'affichage d'un message ou l'invite de l'utilisateur à saisir du texte. Lorsque le moteur de dialogue repère un composant personnalisé, il appelle le service du composant, qui héberge des composants personnalisés.

Composants intégrés

Digital Assistant fournit un ensemble de composants qui prennent en charge une plage d'actions génériques que vous pouvez utiliser dans n'importe quelle brique : sécurité, analyse de la saisie utilisateur, acheminement du flux de dialogue en fonction de la saisie utilisateur et sortie des réponses de la brique de différentes manières. A moins que vous n'ayez besoin d'intégrer les back-ends ou d'exécuter une logique très complexe, ces composants fournissent les actions dont vos états ont besoin.

La façon dont vous accédez aux composants varie selon que vous concevez le flux de dialogue avec le concepteur visuel de flux ou en mode YAML :

  • Si vous utilisez le concepteur visuel de flux, vous ajoutez le premier état d'un composant intégré à un flux en positionnant le curseur de la souris sur sa mosaïque Démarrage, en cliquant sur le menu icône du menu Add State, en sélectionnant Ajouter un état de démarrage, 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. Reportez-vous à la section Conception des flux.
  • Si vous concevez votre brique en mode YAML, vous ajoutez un état pour un composant intégré à votre flux de dialogue en sélectionnant + 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, le service vous avertit si vous avez oublié d'inclure une propriété requise.

Pour plus d'informations sur les modèles de composant disponibles dans Visual Flow Designer, reportez-vous à Modèles de composant.

Pour plus d'informations sur les composants disponibles en mode YAML, reportez-vous à Composants intégrés : propriétés, transitions et utilisation.

Composants personnalisés

La plupart des briques doivent s'intégrer aux données des systèmes distants ou effectuer un traitement back-end. Par exemple, vous avez peut-être besoin que votre brique obtienne une liste de produits ou enregistre les informations relatives à une commande. Vous pouvez également être amené à exécuter une logique complexe impossible à l'aide de FreeMarker ou d'un gestionnaire d'événements d'entité. Les composants personnalisés vous permettent l'intégration aux back-ends et la réalisation de tâches qui ne sont pas couvertes par les composants intégrés.

Pour découvrir comment créer un composant personnalisé, reportez-vous à Implémentation des composants personnalisés. Pour savoir comment ajouter des composants personnalisés à utiliser dans votre brique, reportez-vous à la section Ajouter un package de composant à une brique. Pour en savoir plus sur un composant personnalisé ajouté à la brique, accédez à la page Composants Icône Composants de la brique, développez le service de composant et sélectionnez le composant. Le nom, les propriétés et les actions prises en charge du composant sont affichés. Utilisez ces informations pour créer l'état du composant dans votre flux de dialogue.

Conseil :

Dans la mesure où il est possible que les composants issus de services différents aient le même nom, vous pouvez ajouter au début du nom du composant le nom du service suivi du signe deux-points (:) pour être sûr de faire référence de manière unique à chaque composant personnalisé que vous utilisez.

Voici un exemple d'état de composant personnalisé dans un flux de dialogue développé en mode YAML. Le composant hello.world est issu du service custom. 

  start:
    component: "custom:helloWorld"
    properties:
      human: "${human.value}"
    transitions:
      next: "askAge"

Lorsque vous utilisez le service de composant imbriqué pour héberger vos composants personnalisés, vous pouvez accéder aux journaux de vues et aux rapports d'incident des composants à partir de la page Composants Icône Composants. Sélectionnez le service, puis cliquez sur Diagnostics.

Autres propriétés disponibles pour les composants personnalisés en mode YAML

Lorsque vous développez des 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 du composant.

Nom Description Requis ?
autoNumberPostbackActions Lorsqu'elle est définie sur true, cette option ajoute des nombres en tant que préfixes aux boutons et aux options de liste. Même si vous n'avez pas défini cette option sur true, la numérotation automatique peut être appliquée aux éléments de carte lorsque la configuration Activer la numérotation automatique sur les actions de postback de l'assistant numérique est définie sur true. La valeur par défaut est false. Non
insightsEndConversation Définissez cette option sur true afin d'arrêter l'enregistrement de la conversation pour la génération de rapports d'analyse. La valeur par défaut est false. Non
insightsInclude Indique si l'état doit être inclus dans la génération de rapports d'analyse. La valeur par défaut est true. Non
translate Utilisez cette propriété afin de 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 que vous l'avez définie sur false, vous pouvez définir cette propriété sur true afin d'activer la traduction automatique pour ce composant uniquement. Si vous avez défini la variable autotranslation sur true, vous pouvez définir cette propriété sur false pour exclure ce composant de la traduction automatique. Reportez-vous à Services de traduction dans les briques. La valeur par défaut est la valeur de la variable de contexte autotranslate. Non

Ces propriétés ne sont pas disponibles pour les états des flux de dialogue que vous développez avec Visual Flow Designer.