...
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 ingresados 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.
| Info | ||
|---|---|---|
| ||
Este artículo se centra en los atributos globales que están disponibles para todas las habilidades dentro de un bot. Se abarcan los atributos locales en la creación de en Crear habilidades e integraciones. |
Para gestionar atributos, vaya al panel de navegación izquierdo y haga clic en el menú Skill Builder (Consola Constructor de Administración de Lumahabilidades), luego seleccione la ficha Attributes (Atributos) como se muestra a continuación.
...
Para crear un atributo, haga clic en Create Attribute (Crear atributo) desde la pestaña Attributes (Atributos) en la página Skill Builder (Consola Constructor de Administración de Lumahabilidades). A continuación, siga los siguientes pasos.
| Info |
|---|
Cuando se crea un nuevo atributo, se debe ejecutar el proceso de generación y publicación de habilidades. Hasta que el atributo se publique, no se podrá usar en una habilidad o integración. Puede copiar el identificador utilizando el botón Copy (Copiar) ubicado junto a la sección del identificador. Esto copia la variable de contexto ({global.<attributeidentifier>}), , que se puede utilizar para hacer referencia al atributo en Integrations (Integraciones), Rulesets (Conjuntos de reglas), Set Attributes (Establecer atributos) o Information Messages (Mensajes de información). |
...
La sección Attribute Details (Detalles de atributosdel atributo) 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@empresaname@company.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, Archivo, JSON y ArchivoXML.Info - 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 Los atributos globales de tipo “LIST”, “JSON” y “XML” no debe deben 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 Estos atributos se pueden utilizar para almacenar o procesar una matriz de datos recibidos de las llamadas de integraciones. Puede utilizar el atributo de tipo de datos LIST estos atributos para almacenar datos/valores en el flujo de conversación.
...
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 deshabilita 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 la aplicación y almacena “Salesforce” en el atributo.
...
- Value (Valor): admite valores de texto y sinónimos para asociar la entrada del usuario con el valor. Un usuario puede introducir ingresar 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.
Active la opción "Sync values as buttons” (Sincronizar valores como botones) para copiar los valores de la sección Values and Synonyms (Valores y sinónimos) al botón y el valor en Quick Replies & Cards (Respuestas rápidas y tarjetas) en la sección User prompt (Solicitud para usuariosdel usuario)
Al completar los detalles, haga clic en Next (Siguiente).
...
Una vez definidos los detalles del atributo, se deberá rellenar la sección User Prompt (Solicitud para usuariosdel usuario). 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 usuariosdel usuario) contiene las siguientes opciones:
- Prompt the User (Solicitar al usuario): un atributo no puede tener ninguna petición ni una solicitud para usuarios del usuario estática. Se puede utilizar un atributo sin solicitud para almacenar valores que establece el sistema. Una solicitud para usuarios del usuario estática define una solicitud que el usuario verá y responderá.
- User Prompt Type (Tipo de solicitud para usuariosdel usuario): una solicitud para usuarios del usuario 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 ingresa 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 que selecciona 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.
| Info |
|---|
Mientras se está ejecutando una habilidad, el usuario final puede omitir los atributos de solicitud estática mediante el comando Skip (Omitir). Consulte los comandos del sistema en la configuración del bot para obtener más información sobre cómo omitir comandos en Luma. Si se selecciona la opción "Sync values as buttons” (Sincronizar valores como botones), los valores en Values and Synonyms (Valores y sinónimos) se agregan como botón y valor en Quick Replies & Cards (Respuestas rápidas y tarjetas) |
Validar entrada de usuario
| Info | ||
|---|---|---|
| ||
|
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 ingresados 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 | .json | XML | ||
| Patrón | Use una expresión regular para garantizar que los datos | |||||||||||
| ingresados 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.
...
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 Build & Publish Skills se haya ejecutado correctamente.
...
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 Conversation Flow (Flujo de la conversación). Para obtener más información, consulte Crear habilidades.
