1. Haga clic en Entidades en la barra de navegación lateral.

2. Haga clic en Agregar entidades.

3. Seleccione Bolsa compuesta como tipo de entidad.

4. Introduzca el nombre y la descripción.
5. Haga clic en + Manejador de eventos si desea utilizar la petición de datos y la lógica de la bolsa compuesta mediante programación mediante manejadores de eventos de entidades.

6. Haga clic en Agregar elemento de bolsa para abrir el cuadro de diálogo Agregar elemento de bolsa. Si va a agregar una entidad incorporada o una entidad personalizada existente, puede crear un nombre específico de la bolsa y agregar una descripción del rol dentro del contexto de la bolsa compuesta.

7. Puede rellenar la bolsa con entidades personalizadas, entidades incorporadas y los siguientes elementos:

   • STRING: captura el texto libre del usuario.

   • LOCATION: captura la ubicación del usuario.

   • ATTACHMENT: acepta archivos, archivos de audio, vídeos o archivos de imagen cargados por el usuario. La entidad de bolsa compuesta almacena el URL donde se aloja el anexo.

   Nota
   
   Al agregar la entidad DATE_TIME, se le solicitará un subtipo.

   Los elementos se resuelven en el orden en el que se agregan. Sin embargo, la secuencia puede verse afectada según cómo se configuren los miembros individuales de la bolsa compuesta.

8. Al hacer clic en Cerrar, volverá a la página Entidades, pero antes podrá agregar otras capacidades específicas de la bolsa al elemento (o actualizarlo más tarde haciendo clic en en la página Entidades).

9. siguientes pasos:

   • Agregue mensajes de error individuales, peticiones de datos de desambiguación o peticiones de datos condicionales para los elementos de la bolsa.
     Nota
     
     Estos se sobrescribirán si agrega la entidad a una bolsa compuesta.

   • Agregue la entidad a una intención. Consulte Agregar entidades a intenciones.

   • Configure el flujo de diálogo para que utilice la entidad de bolsa compuesta..

• Solo se actualizará el elemento que se está resolviendo actualmente. Cuando una coincidencia se aplica a más de un elemento de bolsa, el elemento de bolsa que se está resolviendo actualmente tiene prioridad sobre otros elementos. Si desactiva el relleno de espacio mejorado, todos los elementos se actualizarán con el mismo valor.
• Si el artículo de resolución actual es un artículo de bolsa STRING, no se actualizará ningún otro artículo de bolsa.
• Si una coincidencia de entidad se aplica a varios elementos de bolsa (no resueltos), se muestra un cuadro de diálogo de desambiguación, que permite al usuario elegir qué elemento se debe actualizar en lugar de actualizar todos los elementos de bolsa.
• Se ignora el conmutador Petición de datos para desambiguación de la entidad. Recomendamos implantar la desambiguación personalizada con un manejador de eventos de entidad.

1. Si desea activar la petición de datos, deje el campo Petición de valor en blanco (su estado por defecto). Si se introduce false en el campo Petición de valor, se evita la petición de datos. Para pedir un valor condicional, agregue una expresión booleana de FreeMarker que se evalúe como true (para la petición de datos) o false.

   Consejo:

   Al definir Petición de valor en false, el elemento podrá resolverse como parte de otro elemento para el que se realice una petición de datos si se activa Extracción en secuencia incorrecta.
2. Haga clic en Agregar petición de datos para crear la secuencia de peticiones de datos. Si necesita cambiar el orden de la secuencia, puede hacerlo moviendo los campos con gestos de arrastrar y soltar o volviendo a numerarlos. Para aleatorizar la salida de las peticiones de datos, asigne el mismo número a dos o más peticiones de datos.

   Nota
   
   Solo se pueden agregar peticiones de datos para entidades incorporadas si se agregan a una bolsa compuesta.

   Puede almacenar peticiones de datos en grupos de recursos (por ejemplo, ${rb.askCheese}) o escribirlas como combinaciones de texto y expresiones de FreeMarker.

• Siempre: la opción por defecto. Al seleccionar esta opción para un elemento, se puede asignar espacio a su valor sin ninguna petición de datos. Por ejemplo, la entidad PizzaSize se puede resolver cuando un cliente introduce Quiero una pizza grande. Esta opción también permite cambiar el valor del elemento en cualquier momento, siempre que la expresión de la propiedad Actualizable no se evalúe como false. Por ejemplo, cuando la bolsa compuesta solicita la entidad PizzaType, el cliente puede responder Vegría, por favor, pero que sea mediana. La aptitud puede actualizar el valor de la entidad PizzaSize con el medio sin necesidad de reiniciar la conversación, ya que Siempre se ha activado para los elementos PizzaSize y PizzaType de la bolsa.
  Nota
  
  Aunque esta opción es el comportamiento por defecto, puede que no siempre sea adecuado para elementos STRING. Si se selecciona esta opción para un elemento de tipo STRING, por ejemplo, el primer mensaje de usuario sería almacenado por el elemento de tipo STRING, en lugar de parearse con la entidad prevista (que podría designarse como el primer elemento de la bolsa que se va a resolver).
• Nunca: al seleccionar esta opción, el elemento solo se coloca después de que se le solicite, incluso cuando otros mensajes de usuario contienen valores válidos. Seleccione Nunca para evitar coincidencias involuntarias.
• Solo al resolver la expresión de intención: restringe el espacio de valores fuera de orden a la primera expresión de usuario que se ha resuelto en la intención asociada a la entidad de bolsa compuesta.

• La bolsa compuesta tiene dos entidades relacionadas con la dirección: NamedAddress, una entidad de valor de lista con valores como domicilio y oficina, y DeliveryAddress, una entidad ADDRESS.
• La petición de datos de la entidad DeliveryAddress es ¿Dónde quiere que le entreguemos el pedido?
• La entidad NamedAddress no solicita una entrada (se introduce false en el campo Petición de datos de valor).
• La entidad NamedAddress se puede extraer con DeliveryAddress (se selecciona DeliveryAddress en el menú Extraer 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

Puede gestionar el servicio desplegado para EEH desde la página Componentes .

ExpenseDate: {

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

1. Antes de crear un elemento de bolsa DATE_TIME, configure las reglas de resolución de ambigüedad de fecha y hora adecuadas para su caso de uso. Por ejemplo, si está creando una aptitud de generación de informes de gastos, seleccione Pasado. Si la aptitud es un programador de reuniones, seleccione Futuro.
2. En la entidad de bolsa compuesta, haga clic en Agregar elemento.
3. Seleccione Entidad en el menú Tipo.
4. Seleccione DATE_TIME en el menú Nombre de entidad.
5. Seleccione un subtipo DATE_TIME en el menú Subtype.
   
   
   Descripción de la ilustración select-date-time-subtype.png
   
   Las opciones de configuración de la página Agregar Elemento de Bolsa cambian según el subtipo que seleccione. Por ejemplo, si selecciona el subtipo Recurrente, puede acceder a las opciones de configuración para los elementos de bolsa anidada que son específicos para definir un evento repetitivo, como el objeto Fecha y hora para la fecha y hora de inicio inicial y el objeto Duración para definir la frecuencia del evento.
   
   
   Descripción de la ilustración edit-date-time-bag-item.png
   
   
6. Si ha seleccionado los subtipos Recurrente o Intervalo:
   • Defina los valores de subtipo que solicita la bolsa compuesta en el menú Petición de datos para.
   • Puesto que las reuniones suelen empezar y terminar el mismo día, active Fecha de finalización por defecto a fecha de inicio para el subtipo startDate. Esto establece la fecha final como igual a la fecha inicial cuando el mensaje del usuario no menciona la fecha final (o cuando la fecha final no se extrae en orden).
     
     
     
     
7. De manera opcional, agregue una etiqueta de desambiguación si la entrada de usuario puede coincidir con más de un subtipo.

   Consejo:

   También puede configurar las propiedades que no son específicas de DATE_TIME, como relleno de ranuras mejorado, actualización de valores de ranuras con Apache FreeMarker, peticiones de datos personalizadas y mensajes de error.
8. Puede acceder a la configuración de nivel de subtipo haciendo clic en un subtipo. Use el recorrido para volver a la configuración de nivel de artículo.
   
   
   
   
9. siguientes pasos:
   • Asocie la entidad de bolsa compuesta a la intención.
   • Declare una variable para la entidad en el flujo de diálogo.
   • En el flujo de diálogo, haga referencia a la entidad de bolsa compuesta con el elemento DATE_TIME mediante el estado Resolver bolsa compuesta.
   • Los valores DATE_TIME se representan como ISO 8601. Para una salida fácil de usar, utilice Apache FreeMarker .xs incorporado. En el siguiente fragmento, el valor del subtipo Time se formatea con .value?time.xs?string['hh:mm a'].

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

     En lugar de hacer referencia al elemento DATE_TIME como una cadena, puede seguir el enfoque de mejores prácticas para hacer referencia a él en un grupo de recursos, como DeliveryMessage en el siguiente ejemplo.

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

     Para el mensaje de grupo de recursos DeliveryMessage, el valor se representa mediante el parámetro {time}:

     Your pizza will be delivered at {time}.