1. Fare clic su Entità nella barra di navigazione laterale.

2. Fare clic su Aggiungi entità.

3. Scegliere Borsa composta come tipo di entità.

4. Immettere il nome e la descrizione.
5. Fare clic su + Gestore eventi se si desidera utilizzare il prompt e la logica del sacchetto composto a livello di programmazione utilizzando gestori eventi entità.

6. Fare clic su + Elemento set per aprire la finestra di dialogo Aggiungi elemento set. Se si aggiunge un'entità incorporata o un'entità personalizzata esistente, è possibile creare un nome specifico del sacchetto e aggiungere una descrizione del relativo ruolo nel contesto del sacchetto composito.

7. È possibile riempire il sacchetto con entità personalizzate, entità incorporate e quanto segue:

   • STRING (STRING) - Acquisisce il testo libero dall'utente.

   • LOCATION (UBICAZIONE) - Acquisisce la posizione dell'utente.

   • ATTACHMENT: accetta file, file audio, video o file immagine caricati dall'utente. L'entità sacchetto composito memorizza l'URL in cui è ospitato l'allegato.

   Nota
   
   Quando si aggiunge l'entità DATE_TIME, viene richiesto di specificare un sottotipo.

   Gli articoli vengono risolti nell'ordine in cui vengono aggiunti. Tuttavia, la sequenza può essere influenzata a seconda di come si configurano i singoli membri del sacchetto composito.

8. Se si fa clic su Chiudi, si torna alla pagina Entità, ma è possibile aggiungere prima altre funzionalità specifiche del sacchetto all'elemento (o aggiornarlo in seguito facendo clic su nella pagina Entità).

9. Passi successivi

   • Aggiungere singoli messaggi di errore, prompt di disambiguazione o prompt condizionale per gli elementi del sacchetto.
     Nota
     
     Se si aggiunge l'entità a un sacchetto composito, queste verranno sovrascritte.

   • Aggiungere l'entità a un intento. Vedere Aggiungi entità a intenti.

   • Configurare il flusso della finestra di dialogo per utilizzare l'entità sacchetto composito.

• Verrà aggiornato solo l'elemento attualmente in fase di risoluzione. Quando una corrispondenza si applica a più articoli della borsa, l'articolo della borsa attualmente risolvente ha la precedenza sugli altri articoli. Se si disattiva il riempimento avanzato degli slot, tutti gli elementi vengono aggiornati con lo stesso valore.
• Se l'articolo risolutore corrente è un articolo della borsa STRING, nessun altro articolo della borsa viene mai aggiornato.
• Se una corrispondenza entità si applica a più articoli bag (non risolti), viene visualizzata una finestra di dialogo di disambiguazione che consente all'utente di scegliere l'articolo da aggiornare anziché aggiornare tutti gli articoli bag.
• Lo switch Prompt per disambiguazione dell'entità viene ignorato. Si consiglia di implementare la disambiguazione personalizzata con un gestore di eventi entità.

1. Se si desidera abilitare la richiesta, lasciare vuoto il campo Richiedi valore (stato predefinito). L'immissione di false nel campo Richiedi valore impedisce la richiesta. Per richiedere un valore condizionale, aggiungere un'espressione FreeMarker booleana che restituisca true (per la richiesta) o false.

   Suggerimento

   Quando si imposta Richiedi valore su false, l'elemento può comunque essere risolto come parte di un altro elemento richiesto quando si abilita Estrazione fuori ordine.
2. Fare clic su Aggiungi prompt per creare la sequenza di prompt. È possibile riordinarlo mescolando i campi mediante azioni di trascinamento della selezione o rinumerandoli. È possibile randomizzare l'output dei prompt quando si assegnano due o più prompt con lo stesso numero.

   Nota
   
   È possibile aggiungere prompt per entità incorporate solo quando vengono aggiunti a un sacchetto composto.

   È possibile memorizzare i prompt nei bundle di risorse (ad esempio, ${rb.askCheese}) o scriverli come combinazioni di testo e espressioni FreeMarker.

• Always (sempre): l'opzione predefinita. Quando si sceglie questa opzione per un elemento, il relativo valore può essere inserito in uno slot senza alcuna richiesta. Ad esempio, l'entità PizzaSize potrebbe essere risolta quando un cliente immette Voglio una pizza di grandi dimensioni. Questa opzione consente inoltre di modificare il valore dell'elemento in qualsiasi momento, a condizione che l'espressione nella proprietà Aggiornabile non restituisca false. Ad esempio, quando il sacchetto composito richiede l'entità PizzaType, il cliente potrebbe quindi rispondere Veggie, ma renderlo un supporto. Lo skill può aggiornare il valore dell'entità PizzaSize con il supporto senza riavviare la conversazione perché Sempre è abilitato per gli elementi PizzaSize e PizzaType del bag.
  Nota
  
  Sebbene questa opzione sia il comportamento predefinito, potrebbe non essere sempre appropriata per gli elementi STRING. Se si sceglie questa opzione per un articolo STRING, ad esempio, il primo messaggio utente verrà memorizzato dall'articolo STRING anziché essere abbinato all'entità desiderata (che potrebbe essere designata come primo articolo del carrello da risolvere).
• Mai: quando si sceglie questa opzione, l'elemento viene inserito nello slot solo dopo che è stato richiesto, anche quando altri messaggi utente contengono valori validi. Scegliere Mai per evitare corrispondenze involontarie.
• Solo quando si risolve l'espressione dell'intento: limita lo slotting del valore fuori ordine alla prima espressione utente risolta nell'intento associato all'entità sacchetto composito.

• Il sacchetto composito ha due entità relative all'indirizzo: NamedAddress, un'entità valore elenco con valori come home e office e DeliveryAddress, un'entità ADDRESS.
• Il prompt dell'entità DeliveryAddress è Dove si desidera che venga consegnato?
• L'entità NamedAddress non richiede l'input (false viene immesso nel campo Prompt per valore).
• L'entità NamedAddress può essere estratta con DeliveryAddress (DeliveryAddress è selezionata dal menu Estrai con).

${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"

Nota

È possibile gestire il servizio distribuito per EEH dalla pagina Componenti .

ExpenseDate: {

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

1. Prima di creare un articolo bag DATE_TIME, configurare le regole di risoluzione delle ambiguità di data e ora appropriate per il caso d'uso. Ad esempio, se si sta creando uno skill per le note spese, selezionare Passato. Se lo skill è uno scheduler riunioni, selezionare Futuro.
2. Nell'entità sacchetto composto fare clic su Aggiungi articolo.
3. Selezionare Entità nel menu Tipo.
4. Selezionare DATE_TIME dal menu Nome entità.
5. Scegliere un sottotipo DATE_TIME dal menu Sottotipo.
   
   
   Descrizione dell'immagine select-date-time-subtype.png
   
   Le opzioni di configurazione nella pagina Aggiungi elemento del sacchetto cambiano a seconda del sottotipo selezionato. Ad esempio, se si seleziona il sottotipo Ricorrente, è possibile accedere alle opzioni di configurazione per gli elementi del sacchetto nidificato specifici per l'impostazione di un evento ripetuto, ad esempio l'oggetto Data e ora per la data e l'ora di inizio iniziali e l'oggetto Durata per l'impostazione della frequenza dell'evento.
   
   
   Descrizione dell'immagine edit-date-time-bag-item.png
   
   
6. Se sono stati selezionati i sottotipi Ricorrente o Intervallo:
   • Impostare i valori del sottotipo richiesti dal sacchetto composito dal menu Richiedi.
   • Poiché in genere le riunioni iniziano e terminano lo stesso giorno, attivare Data di fine predefinita fino alla data di inizio per il sottotipo startDate. In questo modo la data di fine viene impostata come la data di inizio quando il messaggio utente non menziona la data di fine (o quando la data di fine non viene estratta fuori ordine).
     
     
     
     
7. Se si desidera, aggiungere un'etichetta di disambiguazione se l'input utente può corrispondere a più sottotipi.

   Suggerimento

   È inoltre possibile configurare le proprietà non specifiche di DATE_TIME, ad esempio riempimento avanzato degli slot, aggiornamento dei valori di slotting con Apache FreeMarker, prompt personalizzati e messaggi di errore.
8. È possibile accedere alla configurazione a livello di sottotipo facendo clic su un sottotipo. Utilizzare l'attraversamento per tornare alla configurazione a livello di articolo.
   
   
   
   
9. Passi successivi
   • Associare l'entità sacchetto composito all'intento.
   • Dichiarare una variabile per l'entità nel flusso della finestra di dialogo.
   • Nel flusso della finestra di dialogo, fare riferimento all'entità sacchetto composito con l'elemento DATE_TIME utilizzando lo stato Risolvi sacchetto composito.
   • I valori DATE_TIME sono rappresentati come ISO 8601. Per un output intuitivo, utilizzare Apache FreeMarker .xs integrato. Nello snippet seguente, il valore del sottotipo Ora viene formattato utilizzando .value?time.xs?string['hh:mm a'].

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

     Anziché fare riferimento all'elemento DATE_TIME come stringa, è possibile seguire l'approccio basato sulle migliori prassi per fare riferimento a tale elemento in un bundle di risorse, ad esempio DeliveryMessage nell'esempio riportato di seguito.

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

     Per il messaggio del bundle di risorse DeliveryMessage, il valore viene visualizzato tramite il parametro {time}:

     Your pizza will be delivered at {time}.