Descripción general

Los atributos se utilizan para almacenar información durante una conversación entre el bot y el usuario. Se puede establecer el valor de un atributo a partir de los datos introducidos por el usuario, una llamada de los servicios web (a través de la aplicación conectada) o transferido desde otras habilidades. Esto permite generar conversaciones dinámicas y recopilar datos para cumplir con la solicitud del usuario. Los atributos se comparten dentro de un bot, lo que permite crearlos y reutilizarlos entre las habilidades.

Para gestionar atributos, vaya al panel de navegación izquierdo y haga clic en el menú Skill Builder (Consola de Administración de Luma), luego seleccione la ficha Attributes (Atributos) como se muestra a continuación.

Crear atributos

Los atributos se definen por tres componentes principales. Detalles, solicitudes y validación. Cada componente define el modo en que el atributo funciona con sus habilidades. 

El siguiente GIF muestra los pasos para crear un atributo de texto que almacena una lista de aplicaciones de las que el usuario puede seleccionar en una habilidad. Este atributo es compatible con la extracción y validación del procesamiento del lenguaje natural (PLN) y permite que el usuario escriba el valor en una respuesta o en una frase del usuario.

Para crear un atributo, haga clic en Create Attribute (Crear atributo) desde la pestaña Attributes (Atributos) en la página Skill Builder (Consola de Administración de Luma). A continuación, siga los siguientes pasos.

Definir detalles del atributo

La sección Attribute Details (Detalles de atributos) de un atributo incluye los siguientes campos clave:

• Name (Nombre): especifique el nombre del atributo que aparecerá en la interfaz de usuario (IU) de Bot Builder. Se permite el uso de espacios para aceptar nombres sencillos.
• Identifier (Identificador): este es el ID único que utiliza el sistema para referirse al atributo. Este valor se genera automáticamente, pero se puede editar antes de crear el atributo. 

• Tipo de datos:  Seleccione el tipo de datos para su atributo. Determina los valores que se pueden almacenar en el atributo y cómo se utilizará en las habilidades. Por ejemplo, un atributo de correo electrónico solo permitirá que se almacene texto en el formato de una dirección de correo electrónico  nombre@empresa.com . Un atributo del tipo “Archivo” permitirá al usuario cargar un archivo como una imagen, un archivo de texto, un archivo zip, un archivo de MS Office, un pdf, etc. Los atributos de tipo de datos de texto admiten la extracción de PLN. 
  Los siguientes son los tipos de datos disponibles en Luma VA: Booleano, Correo electrónico, Número, Texto, Hora, Entero, Lista, Largo y Archivo.

  • El atributo de archivo adjunto no permite archivos ejecutables como exe, dll, vbs, jsp, apk, ipa, sh, bat, com, jar, so, sl, msi, o, swf, class, js, cgi, scr, pif, cmd , vxd, cpl
  • La extracción de PLN no es compatible con el atributo de tipo “Archivo”.
  • El atributo global de tipo “LIST” no debe utilizarse para recopilar información del usuario final durante la ejecución de la habilidad, ya que el usuario final puede proporcionar solo una entrada para una solicitud. El atributo de tipo “list” se puede utilizar para almacenar o procesar una matriz de datos recibidos de las llamadas de integraciones.

Extracción de PLN

Si el tipo de datos seleccionado es texto, aparecerá el campo NLP Extraction Method  (Método de extracción de PLN) en la página Attribute Details (Detalles del atributo). La extracción de PLN le permite al atributo extraer el valor de una frase del usuario cuando se desactiva la habilidad así como tomar la entrada del usuario como sinónimo y alinearla con un valor. Esto proporciona una mejor experiencia del usuario dado que permite que se omitan las solicitudes y se mueva al usuario a través de la conversación sobre las habilidades con mayor rapidez y facilidad. Por ejemplo, si un usuario dijera “restablecer mi contraseña para SF”. SF puede ser un sinónimo para el valor Salesforce en el atributo de texto ApplicationName. La habilidad omite la solicitud y pregunta al usuario el nombre de la aplicación y almacena “Salesforce” en el atributo.

Existen dos opciones para el método de extracción de PLN:

• Value (Valor): admite valores de texto y sinónimos para asociar la entrada del usuario con el valor. Un usuario puede introducir cualquiera de los sinónimos y este se resolverá en el valor real. Esto le proporciona al usuario una experiencia simple y lo hará sentir que el bot comprende su terminología. 
• Pattern Matching (Coincidencia de patrones): admite expresiones comunes para garantizar que la entrada coincida con el patrón definido. Esto resulta útil para números de teléfono, ID de empleados y otros valores que coinciden con un formato específico. Existen muchos recursos en línea para buscar expresiones comunes o crear las propias. Regex101 y Rexegg  son dos recursos útiles.

Al completar los detalles, haga clic en Next (Siguiente).

Generar solicitudes para usuarios

Una vez definidos los detalles del atributo, se deberá rellenar la sección User Prompt (Solicitud para usuarios). Cada atributo puede tener una solicitud única asociada con él. Esto facilita la creación de una habilidad, puesto que una solicitud se puede crear una vez y se puede volver a utilizar entre las habilidades donde se utiliza el atributo.

La sección User Prompt (Solicitud para usuarios) contiene las siguientes opciones:

• Prompt the User (Solicitar al usuario): un atributo no puede tener ninguna petición ni una solicitud para usuarios estática. Se puede utilizar un atributo sin solicitud para almacenar valores que establece el sistema. Una solicitud para usuarios estática define una solicitud que el usuario verá y responderá.
• User Prompt Type (Tipo de solicitud para usuarios): una solicitud para usuarios puede ser texto, respuestas rápidas, tarjeta o imagen. El tipo de texto muestra una pregunta abierta para el usuario. Las respuestas rápidas muestran un mensaje y botones que el usuario puede seleccionar para responder a la solicitud. La tarjeta muestra un mensaje para el usuario seguido de un conjunto de tarjetas con un título, un subtítulo y un botón. La imagen muestra un mensaje al usuario junto con la imagen y la información sobre herramientas correspondientes.
  • Text (Texto): una solicitud de texto contiene un mensaje. Esto es lo que se muestra al usuario. Se pueden agregar varios mensajes para que el sistema tenga variedad en la solicitud y el sistema parezca más natural. Cada vez que se activa la solicitud, se selecciona un mensaje aleatoriamente. La respuesta exacta del usuario para la solicitud de texto se almacena en el atributo. Si un usuario introduce un sinónimo y el atributo utiliza la extracción de PLN, se utiliza el valor definido en la sección de detalles.
    
    
    Respuestas rápidas: tienen un único mensaje y varias opciones se muestran como botones. El usuario selecciona un solo botón. El valor del botón seleccionado se almacena en el atributo. Las respuestas rápidas permiten que respondan las solicitudes de forma más fácil ya que los usuarios no están confundidos con preguntas abiertas. Las respuestas rápidas también mejoran la validación de datos.
    
    
    
    
    Card (Tarjeta): son útiles cuando proporcionan más información al usuario para tomar su decisión. Se puede utilizar para seleccionar una sala de conferencias donde la ubicación o el número de asientos sea importantes en su decisión. Una solicitud de tarjeta contiene un mensaje y para cada una, una dirección URL de la imagen, un título, subtítulo, botón y valor. El usuario selecciona uno de los botones de la tarjeta y el valor que se almacenará en el atributo es el valor del botón seleccionado.
    
    
    Image (Imagen): de manera similar a las tarjetas, la opción imagen es útil cuando se debe proporcionar una representación visual de opciones disponibles al usuario. Esta opción muestra un mensaje para el usuario final junto con las imágenes y la información sobre herramientas relacionada.  Cuando el usuario final selecciona la imagen requerida, se asigna el texto de la información sobre herramientas al atributo.
    
    
    
    

La validación es la última sección en la creación de un atributo. La sección garantiza que la respuesta del usuario a una solicitud esté alineada con el formato necesario. Existen siete restricciones de validación posibles que están disponibles en función del tipo de datos del atributo. Si se produce un fallo en la validación, se mostrará el mensaje de incumplimiento al usuario y a la solicitud otra vez. Se pueden usar varias restricciones para garantizar que la entrada coincida con el formato apropiado. Si se produce un error en varias restricciones al mismo tiempo, se mostrarán todos los mensajes de incumplimiento asociados. Los mensajes de incumplimiento que destacan la incidencia específica con los datos introducidos por el usuario mejoran enormemente la experiencia del usuario. Por ejemplo, en el caso de que no se cumpla con la longitud mínima de la respuesta, no diga “Su entrada no cumplió con la longitud mínima”. En su lugar, diga “Los datos de entrada deben ser de 3 o más caracteres”.

En la siguiente tabla, se muestran todas las restricciones y los tipos de datos a los que se aplican.

Restricción	Descripción	Tipo de datos
		Booleano	Correo electrónico	Número	Texto	Tiempo	Archivo	Entero	Lista	Largo
Patrón	Use una expresión regular para garantizar que los datos introducidos por el usuario sigan un patrón exacto. Por ejemplo, el número de teléfono 212-555-4444 de EE. UU.
Longitud exacta	El valor debe contener una cantidad exacta de caracteres. Por ejemplo, el ID de empleado tener seis caracteres.
Longitud mínima	El valor debe contener una cantidad mínima determinada de caracteres. Por ejemplo, el código de la oficina debe contener como mínimo tres caracteres.
Longitud máxima	El valor no debe superar la cantidad determinada de caracteres. Se suele usar junto con la longitud mínima. Por ejemplo, el código de la oficina no debe tener más de seis caracteres.
Mínimo	Para los números, el valor debe ser por lo menos igual al número proporcionado. Por ejemplo, el número de asistentes a la reunión debe ser de 2 o más.
Máximo	Para los números, el valor no debe superar el número proporcionado. Se suele utilizar junto con el valor mínimo. Por ejemplo, el número de asistentes a la reunión no debe ser mayor a 10.
Lista	El valor proporcionado debe estar incluido en la lista. Por ejemplo, la aplicación debe estar incluida en la lista de aplicaciones corporativas.

Al finalizar la validación, haga clic en Create (Crear) para guardar el nuevo atributo. 

Gestionar atributos

Una vez que se creó un atributo, aparecerá en el modo de solo lectura. Haga clic en Edit (Editar) para modificar todas las secciones del atributo en una sola página. Tras la creación inicial, no se puede cambiar el identificador ni el tipo de datos del atributo. Si realiza ediciones a un atributo que ya se utiliza en una habilidad, los cambios no serán aplicables al bot de producción hasta que el proceso de Generar y publicar se haya ejecutado correctamente.

No se pueden eliminar los atributos ni se pueden establecer como inactivos. Si un atributo ya no es necesario, quítelo de todas las habilidades asociadas y los usuarios no podrán verlos durante las conversaciones. 

Usar atributos en las habilidades

Existen atributos para ayudar a completar la solicitud de un usuario en una habilidad.  Los atributos se asocian con una habilidad en la sección Flujo de la conversación. Para obtener más información, consulte  Crear habilidades.