1. Cliquez sur Entités dans la barre de navigation latérale.

2. Cliquez sur Ajouter des entités.

3. Choisissez Conteneur composite comme type d'entité.

4. Entrez un nom et une description.
5. Cliquez sur + Gestionnaire d'événements pour exécuter l'invite et la logique du conteneur composite par programmation à l'aide de gestionnaires d'événements d'entité.

6. Cliquez sur + Elément de conteneur pour ouvrir la boîte de dialogue Ajouter un élément de conteneur. Si vous ajoutez une entité intégrée ou une entité personnalisée existante, vous pouvez créer un nom propre au conteneur pour cette entité et y ajouter une description de son rôle dans le contexte du conteneur composite.

7. Vous pouvez remplir le conteneur avec des entités personnalisées, des entités intégrées et les éléments suivants :

   • STRING : capture le texte libre de l'utilisateur.

   • LOCATION : capture la localisation de l'utilisateur.

   • ATTACHMENT : accepte les fichiers, les fichiers audio, les fichiers vidéo ou les fichiers image téléchargés par l'utilisateur. L'entité de conteneur composite stocke l'URL qui héberge la pièce jointe.

   Remarque
   
   Lorsque vous ajoutez l'entité DATE_TIME, vous êtes invité à saisir un sous-type.

   Les éléments sont résolus dans l'ordre dans lequel vous les ajoutez. Toutefois, cette séquence peut varier en fonction de la manière dont vous configurez les membres individuels du conteneur composite.

8. Si vous cliquez sur Fermer, vous revenez à la page Entités, mais avant cela, vous pouvez ajouter d'autres fonctionnalités propres aux conteneurs à l'élément (ou mettre ce dernier à jour ultérieurement en cliquant sur sur la page Entités).

9. Les étapes suivantes :

   • Ajoutez des messages d'erreur individuels, des invites de désambiguïsation ou des invites conditionnelles aux éléments du conteneur.
     Remarque
     
     Ceux-ci seront écrasés si vous ajoutez l'entité à un conteneur composite.

   • Ajoutez l'entité à une intention. Reportez-vous à Ajout d'entités aux intentions.

   • Configurez le flux de dialogue de façon à utiliser l'entité de conteneur composite..

• Seul l'élément en cours de résolution sera mis à jour. Lorsqu'une correspondance s'applique à plusieurs éléments de conteneur, l'élément de conteneur en cours de résolution est prioritaire sur les autres éléments. Si vous désactivez le remplissage amélioré des créneaux, tous les éléments sont mis à jour avec la même valeur.
• Si l'élément de résolution actuel est un élément de conteneur STRING, aucun autre élément de conteneur n'est jamais mis à jour.
• Si une correspondance d'entité s'applique à plusieurs éléments de conteneur (non résolus), une boîte de dialogue de déshomonymie s'affiche, permettant à l'utilisateur de choisir l'élément à mettre à jour au lieu de mettre à jour tous les éléments de conteneur.
• Le commutateur Invite de déshomonymie de l'entité est ignoré. Nous vous recommandons d'implémenter une déshomonymie personnalisée avec un gestionnaire d'événements d'entité.

1. Si vous voulez activer les invites, laissez le champ Invite pour la valeur vide (état par défaut). La saisie de false dans le champ Invite pour la valeur empêche l'affichage des invites. Afin d'envoyer une invite pour une valeur conditionnelle, ajoutez une expression FreeMarker booléenne qui peut prendre la valeur true (pour envoyer les invites) ou false.

   Conseil :

   Lorsque vous définissez Invite pour la valeur sur false, l'élément peut toujours être résolu comme une partie d'un autre élément pour lequel une invite est envoyée lorsque vous activez l'option Extraction dans le désordre.
2. Cliquez sur Ajouter une invite pour créer la séquence d'invites. Vous pouvez réorganiser les champs en les faisant glisser ou en les renumérotant. Vous pouvez rendre la sortie des invites aléatoire lorsque vous attribuez le même numéro à deux invites ou plus.

   Remarque
   
   Vous ne pouvez ajouter des invites aux entités intégrées que lorsque vous les ajoutez à un conteneur composite.

   Vous pouvez stocker les invites dans des groupes de ressources (par exemple, ${rb.askCheese}) ou les écrire comme des combinaisons de texte et d'expressions FreeMarker.

• Always : option par défaut. Lorsque vous choisissez cette option pour un élément, sa valeur peut être insérée sans invite. Par exemple, l'entité PizzaSize peut être résolue lorsqu'un client saisit I want a large pizza. Cette option permet également de modifier la valeur de l'élément à tout moment, à condition que l'expression de la propriété Modifiable ne renvoie pas la valeur false. Par exemple, lorsque le conteneur composite envoie une invite pour l'entité PizzaType, le client peut alors répondre Veggie please, but make it a medium. La brique peut mettre à jour la valeur de l'entité PizzaSize avec la valeur medium sans redémarrer la conversation car l'option Toujours est activée pour les éléments PizzaSize et PizzaType du conteneur.
  Remarque
  
  Bien que cette option soit le comportement par défaut, elle peut ne pas toujours être appropriée pour les éléments STRING. Par exemple, si vous avez choisi cette option pour un élément STRING, le premier message utilisateur sera stocké par l'élément STRING au lieu d'être mis en correspondance par l'entité prévue (qui peut être désignée comme le premier élément du conteneur à résoudre).
• Jamais : lorsque vous choisissez cette option, l'élément n'est inséré qu'une fois qu'il a été demandé, même lorsque d'autres messages utilisateur contiennent des valeurs valides. Sélectionnez Jamais pour empêcher les correspondances par inadvertance.
• Uniquement lors de la résolution de la variation d'intention : limite le slot de valeur hors séquence à la première variation utilisateur qui a été résolue en intention associée à l'entité de conteneur composite.

• Le conteneur composite comporte deux entités liées à l'adresse : NamedAddress, une entité de valeur de liste contenant des valeurs comme home et office, et DeliveryAddress, une entité ADDRESS.
• L'invite de l'entité DeliveryAddress est Where do you want that delivered?
• L'entité NamedAddress ne vous invite pas à saisir des informations (la valeur false est indiquée dans le champ Invite pour la valeur).
• L'entité NamedAddress peut être extraite avec DeliveryAddress (DeliveryAddress est sélectionné dans le menu Extraire avec).

${varName.value.itemName}

${expense.value.Amount.amount > 4}

Amounts below 5 ${expense.value.Amount.currency} cannot be expensed. Enter a higher amount or type 'cancel'.

• userInput
• prompt
• promptCount
• updatedEntities
• outOfOrderMatches
• disambiguationValues
• enumValues
• needShowMoreButton
• rangeStartVar
• nextRangeStart

Sorry,'${system.entityToResolve.value.userInput!'this'}' is not a valid pizza size.

    metadata:
      responseItems:        
      - type: "text" 
        text: "<#list system.entityToResolve.value.updatedEntities>I have updated <#items as ent>${ent.description}<#sep> and </#items>. </#list><#list system.entityToResolve.value.outOfOrderMatches>I got <#items as ent>${ent.description}<#sep> and </#items>. </#list>"
      - type: "text" 
        text: "${system.entityToResolve.value.prompt}"
        actions:
        - label: "${enumValue}"
          type: "postback"
          iteratorVariable: "system.entityToResolve.value.enumValues"

        globalActions: 
        - label: "Show More"
          type: "postback" 
          visible:
            expression: "${system.entityToResolve.value.needShowMoreButton}"
          payload:
            action: "system.showMore"
            variables: 
              ${system.entityToResolve.value.rangeStartVar}: ${system.entityToResolve.value.nextRangeStart} 
        - label: "Cancel"
          type: "postback" 
          visible:
            onInvalidUserInput: true
          payload:
            action: "cancel"

Remarque

Vous pouvez gérer le service déployé pour l'EEH à partir de la page Composants .

ExpenseDate: {

        validate: async (event, context) => {
          if (new Date(event.newValue.date) > new Date()) {
            context.addValidationError("ExpenseDate",context.translate('ExpenseDate.text'));
            return false;
          }          
        }

1. Avant de créer un élément de conteneur DATE_TIME, configurez les règles de résolution des ambiguïtés de date et d'heure appropriées à votre cas d'emploi. Par exemple, si vous créez une brique de note de frais, sélectionnez Passé. Si la brique est un planificateur de réunions, sélectionnez Futur.
2. Dans l'entité de conteneur composite, cliquez sur Ajouter un élément.
3. Sélectionnez Entité dans le menu Type.
4. Sélectionnez DATE_TIME dans le menu Nom de l'entité.
5. Choisissez un sous-type DATE_TIME dans le menu Sous-type.
   
   
   Description de l'image select-date-time-subtype.png
   
   Les options de configuration de la page Ajouter un élément de poche varient en fonction du sous-type sélectionné. Par exemple, si vous sélectionnez le sous-type Récurrent, vous pouvez accéder aux options de configuration des éléments de conteneur imbriqué spécifiques à la définition d'un événement récurrent, telles que l'objet Date et heure pour la date et l'heure de début initiales et l'objet Durée pour la définition de la fréquence d'événement.
   
   
   Description de l'image edit-date-time-bag-item.png
   
   
6. Si vous avez sélectionné les sous-types Récurrent ou Intervalle :
   • Définissez les valeurs de sous-type que le conteneur composite invite à saisir dans le menu Invite pour.
   • Etant donné que les réunions commencent et se terminent généralement le même jour, activez l'option Date de fin par défaut à la date de début pour le sous-type startDate. La date de fin est alors identique à la date de début lorsque le message utilisateur ne mentionne pas la date de fin (ou lorsque la date de fin n'est pas extraite dans l'ordre).
     
     
     
     
7. Ajoutez éventuellement une étiquette d'homonymie si l'entrée utilisateur peut correspondre à plusieurs sous-types.

   Conseil :

   Vous pouvez également configurer les propriétés qui ne sont pas spécifiques à DATE_TIME, telles que renseignement amélioré des emplacements, mise à jour des valeurs d'emplacement avec Apache FreeMarker, des invites personnalisées et des messages d'erreur.
8. Vous pouvez accéder à la configuration de niveau sous-type en cliquant sur un sous-type. Utilisez la traversée pour revenir à la configuration de niveau article.
   
   
   
   
9. Les étapes suivantes :
   • Associez l'entité de conteneur composite à l'intention.
   • Déclarez une variable pour l'entité dans le flux de dialogue.
   • Dans le flux de dialogue, référencez l'entité de conteneur composite avec l'élément DATE_TIME à l'aide de l'état Résoudre le conteneur composite.
   • Les valeurs DATE_TIME sont représentées au format ISO 8601. Pour une sortie conviviale, utilisez Apache FreeMarker .xs intégré. Dans le fragment de code suivant, la valeur du sous-type Heure est formatée à l'aide de .value?time.xs?string['hh:mm a'].

     Your pizza will be delivered at ${pizza.value.deliveryTime.value?time.xs?string['hh:mm a']}.
     

     Au lieu de référencer l'élément DATE_TIME en tant que chaîne, vous pouvez suivre l'approche recommandée pour le référencer dans un groupe de ressources, comme DeliveryMessage dans l'exemple suivant.

     ${rb('DeliveryMessage','time',pizza.value.deliveryTime.value?time.xs?string['hh:mm a'])}
     

     Pour le message de groupe de ressources DeliveryMessage, la valeur est affichée via le paramètre {time} :

     Your pizza will be delivered at {time}.