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

2. Cliquez sur Add Entities (Ajouter des entités).

3. Choisissez le type d'entité Composite Bag (Entité composite).

4. Entrez le nom et la description.
5. Cliquez sur + + Event Handler (Programme de traitement d'événements) si vous souhaitez utiliser l'affichage d'invite et la logique de l'entité composite de manière programmatique à l'aide de programmes de traitement d'événements d'entité.

6. Cliquez sur + Bag Item (Élément d'entité) pour ouvrir la boîte de dialogue Add Bag Item (Ajouter un élément d'entité composite). Si vous ajoutez une entité intégrée ou une entité personnalisée existante, vous pouvez créer un nom propre à l'entité composite et ajouter une description de son rôle dans le contexte de l'entité composite.

7. Vous pouvez remplir l'entité composite avec des entités personnalisées et intégrées, ainsi que les éléments suivants :

   • STRING—Saisit le texte libre de l'utilisateur.

   • LOCATION—Saisit l'emplacement de l'utilisateur.

   • ATTACHMENT—Accepte des fichiers, des fichiers audio, vidéo ou d'image chargés par l'utilisateur. L'entité composite stocke l'URL où le fichier joint est hébergé.

   Note
   
   Vous êtes invité à entrer un sous-type lorsque vous ajoutez l'entité DATE_TIME.

   Les éléments sont résolus dans l'ordre de leur ajout. Toutefois, la séquence peut être affectée par la configuration des membres individuels de l'entité composite.

8. Lorsque vous cliquez sur Close (Fermer), vous retournez à la page Entities (Entités), mais vous pouvez d'abord ajouter d'autres fonctions propres à l'entité composite à l'élément (ou le mettre à jour ultérieurement en cliquant sur dans cette page).

9. Étapes suivantes :

   • Ajoutez des messages d'erreur individuels, des invites de désambiguïsation ou des invites conditionnelles pour les éléments de l'entité composite.
     Note
     
     Ceux-ci seront remplacés si vous ajoutez l'entité à une entité composite.

   • Ajoutez l'entité à une intention. Voir Ajouter des entités à des intentions.

   • Configurez le flux de dialogue pour utiliser l'entité composite..

• Seul l'élément en cours de résolution sera mis à jour. Lorsqu'une correspondance s'applique à plusieurs éléments d'entité, l'élément d'entité en cours de résolution a priorité sur les autres éléments. Si vous désactivez le remplissage amélioré des emplacements, tous les éléments sont mis à jour avec la même valeur.
• Si l'élément de résolution courant est un élément d'entité de type STRING, aucun autre élément d'entité n'est mis à jour.
• Si une correspondance d'entité s'applique à plusieurs éléments d'entité (non résolus), une boîte de dialogue de désambiguïsation s'affiche, ce qui permet à l'utilisateur de choisir l'élément à mettre à jour au lieu de mettre à jour tous les éléments d'entité.
• Le commutateur Prompt for Disambiguation de l'entité est ignoré. Nous vous recommandons d'implémenter une désambiguïsation personnalisée avec un gestionnaire d'événements d'entité.

1. Si vous souhaitez activer l'affichage d'invite, laissez le champ Prompt for Value (Invite de valeur) vide (son état par défaut). L'entrée de false dans le champ Prompt for Value empêche l'affichage d'invite. Pour demander une valeur conditionnelle, ajoutez une expression FreeMarker booléenne qui donne true (pour l'affichage d'invite) ou false.

   Conseil :

   Si vous réglez Prompt for Value à false, l'élément peut être résolu dans le cadre de l'invite d'un autre élément lorsque vous activez l'option Out of Order Extraction (Extraction dans le désordre).
2. Cliquez sur Add Prompt (Ajouter une invite) pour générer la séquence d'invites. Vous pouvez la réorganiser en bougeant les champs par glisser-déposer ou en les renumérotant. Vous pouvez rendre aléatoire l'affichage des invites lorsque vous donnez le même numéro à plusieurs invites.

   Note
   
   Vous ne pouvez ajouter des invites pour les entités intégrées que lorsque vous les ajoutez à une entité composite.

   Vous pouvez stocker des invites dans des ensembles de ressources (par exemple, ${rb.askCheese}) ou les écrire en combinant du texte et des expressions FreeMarker.

• Toujours - Option par défaut. Lorsque vous choisissez cette option pour un élément, sa valeur peut être remplie sans invite. Par exemple, l'entité PizzaSize (Taille de pizza) peut être résolue lorsqu'un client entre I want a large pizza (Je veux une grande 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 soit pas évaluée à false. Par exemple, lorsque l'entité composite affiche l'invite pour l'entité PizzaType, le client pourrait répondre Veggie s'il vous plaît, mais en faire un moyen. La compétence peut mettre à jour la valeur de l'entité PizzaSize avec la valeur moyenne sans redémarrer la conversation, car Toujours est activé pour les éléments PizzaSize et PizzaType de l'entité composite.
  Note
  
  Bien que cette option soit le comportement par défaut, elle peut ne pas toujours être appropriée pour les articles STRING. Si vous sélectionnez cette option pour un élément STRING par exemple, le premier message utilisateur sera stocké par l'élément STRING au lieu d'être mis en correspondance par l'entité prévue (qui pourrait être désignée comme le premier élément de l'entité composite à être résolu).
• Jamais - Lorsque vous choisissez cette option, l'élément n'est inséré qu'après avoir été demandé, même si d'autres messages d'utilisateur contiennent des valeurs valides. Sélectionnez Jamais pour empêcher les correspondances par inadvertance.
• Uniquement lors de la résolution de l'énoncé d'intention - Restreint l'insertion de valeurs dans le désordre au premier énoncé d'utilisateur qui a été résolu en intention associée à l'entité composite.

• L'entité composite comporte deux entités liées à l'adresse : NamedAddress, une entité de type liste avec des valeurs telles que domicile et bureau, et DeliveryAddress, une entité ADDRESS.
• L'invite de l'entité DeliveryAddress est Où voulez-vous être livré?
• L'entité NamedAddress ne demande pas d'entrée ( false (faux) figure dans le champ Prompt for Value (Invite de valeur)).
• L'entité NamedAddress peut être extraite avec DeliveryAddress (DeliveryAddress est sélectionné dans le menu Extract With (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"

Note

Vous pouvez gérer le service déployé pour EEH à partir de la page Components (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 d'entité DATE_TIME, configurez les règles de résolution de l'ambiguïté de date et d'heure appropriées pour votre cas d'utilisation. Par exemple, si vous créez une compétence de production de rapports de frais, sélectionnez Précédent. Si la compétence est un programmateur de réunion, sélectionnez Futur.
2. Dans l'entité 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. Sélectionnez un sous-type DATE_TIME dans le menu Sous-type.
   
   
   Description de l'illustration select-date-time-subtype.png
   
   Les options de configuration de la page Ajout articles sac changent 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 d'entité imbriquée spécifiques à la définition d'un événement répétitif, tels 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 de l'événement.
   
   
   Description de l'illustration 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 l'entité composite invite à partir du menu Invite pour.
   • Comme les réunions commencent et se terminent généralement le même jour, activez Date de fin par défaut à la date de début pour le sous-type startDate. Cela définit la date de fin comme étant égale à la date de début lorsque le message de l'utilisateur ne mentionne pas la date de fin (ou lorsque la date de fin n'est pas extraite dans le désordre).
     
     
     
     
7. Facultativement, ajoutez 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 propres à DATE_TIME, telles que le remplissage amélioré des emplacements, la mise à jour des valeurs de référencement avec Apache FreeMarker, les invites personnalisées et les messages d'erreur.
8. Vous pouvez accéder à la configuration au niveau du sous-type en cliquant sur un sous-type. Utilisez le parcours pour revenir à la configuration au niveau de l'élément.
   
   
   
   
9. Étapes suivantes :
   • Associez l'entité 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é composite avec l'élément DATE_TIME à l'aide de l'état Résoudre l'entité composite.
   • Les valeurs DATE_TIME sont représentées sous la forme ISO 8601. Pour une sortie conviviale, utilisez la version intégrée d'Apache FreeMarker .xs. Dans l'extrait 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 de meilleure pratique consistant à le référencer dans un ensemble de ressources, par exemple DeliveryMessage dans l'exemple suivant.

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

     Pour le message d'ensemble de ressources DeliveryMessage, la valeur est affichée au moyen du paramètre {time} :

     Your pizza will be delivered at {time}.