Copy of Usar las funciones de transformación

Transform functions are used when information received from integration or user input must be transformed before it can be used in the skill. Luma Virtual Agent provides a set of predefined functions that allow administrators or skill developers to analyze, process, or modify the user-supplied value or integration response and pass that modified value to a global, local, or custom user attribute. The modified values can also be used to configure the payload to execute an action, skill, or response from the bot for the end user.

For example, you can change the date and time format to a custom format other than the system-defined format and present it to the user.

Luma provides a variety of transform functions to allow skill developers to modify data as needed, such as Split, Trim, Substring, Replace, Custom Date-Time, and custom times), among others.

How to use transform functions

Transform functions can be used in the following situations:

• By generating a skill as a conversation item.

• When creating an integration operation , in Inbound Response Mapping.

• When creating a trace , in the definition of Message, Data Extraction, and Recipients.

Mediante el uso de las funciones de transformación, los desarrolladores y administradores de habilidades pueden extraer una cadena o convertir parte de la información en datos necesarios para realizar la habilidad o la integración.
Para agregar las funciones de transformación, siga los pasos a continuación:

1. El primer paso es agregar el segmento Set attribute → Transform (Establecer el atributo → Transformar).

   1. Al generar una habilidad, se pueden agregar funciones de transformación al flujo de trabajo de la conversación. Consulte Crear habilidades para obtener más información sobre cómo crear una habilidad.

      1. En la sección Skill builder-->Conversation flow (Generador de habilidades-->Flujo de conversación), seleccione Set Attribute (Establecer atributo) en Conversation Item (Elemento de conversación).

         

      2. En el control Set Attribute (Establecer atributo), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo).

         

   2. Al crear la operación, las funciones de transformación se utilizan en la sección Inbound mapping (Asignación de entrada).

      1. En Create Operation--> Response Configuration (Crear operación--> Configuración de respuesta), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo).

         

2. Una vez que se agrega el segmento a la pantalla, puede seleccionar la función de transformación según sea necesario. Además de los parámetros específicos de la función, los siguientes detalles son necesarios para cada función:

   1. Transform Function (Función de transformación): esta es la función de transformación obligatoria. Function Mode (Modo de función), Attribute to Transform (Atributo a transformar) y otros campos específicos aparecen y se rellenan según la función de transformación seleccionada.

   2. Function Mode (Modo de función): representa los modos de transformación disponibles para la ejecución.

   3. Attribute to Transform (Atributo a transformar): representa la cadena de entrada que se va a transformar. Puede agregar un atributo válido o una cadena al campo.

   4. Scope (Alcance): representa el ámbito del atributo de salida al que deben pasarse los datos transformados. Puede asignar el valor a un atributo de usuario local, global o personalizado.

   5. Attribute (Atributo): representa el nombre del atributo.

   6. Data Type (Tipo de dato): representa el tipo de dato del atributo. En el caso de los atributos de usuario globales y personalizados, el tipo de dato se rellena según la definición del atributo seleccionado. Cuando utiliza un atributo local, seleccione el tipo de dato en función del valor que guardará.

Las funciones de transformación disponibles en el sistema son las siguientes:

Dividir

La función “Split” (Dividir) se puede utilizar para dividir un texto o una respuesta de integración en cadenas más pequeñas. Divide la cadena en el carácter “delimitador” y extrae el texto en la posición del índice definido de la matriz extraída. La función devuelve un conjunto de cadenas más pequeñas según el orden en que aparecen en la cadena. Posteriormente, las cadenas extraídas se pueden pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Recortar

La función “Recortar” se utiliza para eliminar espacios en blanco de la cadena de entrada o del valor del atributo. Devuelve una cadena después de eliminar los espacios en blanco iniciales, finales o adicionales. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Replace - Replace Substring (Reemplazar: Reemplazar subcadena)

La función “Replace” (Reemplazar) busca y reemplaza una subcadena con otra en el texto de entrada. El modo de función “Replace Substring” (Reemplazar subcadena) se utiliza si debe reemplazar todas las ocurrencias de la subcadena en la cadena de entrada. Devuelve una cadena después de reemplazar las ocurrencias de la subcadena con la cadena sustituta especificada. El reemplazo comienza desde el inicio hasta el final de la cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Replace - Replace First Substring (Reemplazar: Reemplazar primer subcadena)

La función “Replace” (Reemplazar) busca y reemplaza una subcadena con otra en el texto de entrada. El modo de función “Replace Substring” (Reemplazar subcadena) se utiliza si debe reemplazar la primera ocurrencia de la subcadena en la cadena de entrada. Devuelve una cadena después de reemplazar la primera ocurrencia de la subcadena por la cadena sustituta especificada. El reemplazo comienza desde el inicio hasta el final de la cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Subcadena

La función “SubString” (subcadena) extrae la subcadena especificada de una cadena de texto para crear otra cadena. La función selecciona caracteres entre ubicaciones especificadas y devuelve lo mismo pero como una nueva cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Random- Random Number (Aleatorio: número aleatorio)

La función “Random” (Aleatorio) genera un número aleatorio. Los números aleatorios se utilizan principalmente para la autenticación y verificación de usuarios. Por ejemplo, en la generación de OTP para la autenticación de usuarios. El modo de función Random Number (Número aleatorio) se utiliza para generar un número aleatorio con el número especificado de dígitos.

Agregue los siguientes detalles para utilizar la función:

Random- Random UUID (Aleatorio: UUID aleatorio (mayúsculas))

La función Random UUID (Uppercase) (UID aleatorio (mayúsculas)) genera un identificador único universal mediante el uso de un código hexadecimal para los caracteres en mayúscula de la A a la F, el mismo se puede guardar en un atributo y utilizar durante la generación de habilidades.

Agregue los siguientes detalles para utilizar la función:

Epoch Time - Current UTC Time (ms) (Tiempo Epoch: Hora UTC actual (ms))

La función Epoch Time- Current UTC Time (ms) (Tiempo Epoch: Hora UTC actual (ms)) se utiliza para generar la hora Unix actual del sistema. La función devuelve la fecha y hora Unix en milisegundos según la zona horaria UTC.

Agregue los siguientes detalles para utilizar la función:

Epoch Time - ISO To Epoch in milliseconds (Tiempo Epoch: ISO a Epoch en milisegundos)

La función Epoch Time - ISO To Epoch in milliseconds (Hora Epoch: ISO a Epoch en milisegundos) se utiliza para convertir el formato de hora ISO a tiempo Epoch (Unix) en milisegundos. La función convierte el formato horario ISO-8601 de entrada y devuelve la fecha y hora en formato de milisegundos Epoch.

Agregue los siguientes detalles para utilizar la función:

Epoch Time - ISO To Epoch in seconds (Hora Epoch: ISO a Epoch en segundos)

La función Epoch Time - ISO To Epoch in seconds (Hora Epoch: ISO a Epoch en segundos) se utiliza para convertir el formato fecha y hora ISO a Epoch (Unix) en segundos. La función convierte el formato de fecha y hora ISO-8601 de entrada y lo devuelve en formato de segundos Epoch.

Agregue los siguientes detalles para utilizar la función:

Custom Date format - Using ISO Date Time (Formato de fecha personalizado: uso de fecha y hora ISO)

La función Custom Date convierte el formato de fecha ISO al formato de fecha y hora requerido. La función devuelve la fecha y hora de entrada en el formato de fecha especificado, como dd-mm-aaaa, mm-dd-aaaa, entre otras opciones.

Agregue los siguientes detalles para utilizar la función:

Custom Date format - Using Epoch Time (Formato de fecha personalizado: uso de tiempo Epoch)

La función de formato de fecha personalizado (Custom Date format) convierte el tiempo Epoch a la fecha y hora en la zona y el formato especificados. La función devuelve el tiempo Epoch de entrada en milisegundos en la zona y el formato de fecha y hora especificados, como d-m-a, m-d-a h:m, entre otras opciones.

Agregue los siguientes detalles para utilizar la función:

Note :Date and time formats must be provided by the following symbols. For example, usedMyforday-month-yearord / M / y H: mforday-month-year hours: minutes.