Las funciones de transformación se utilizan cuando la información recibida de la integración o la entrada del usuario debe transformarse antes de que pueda utilizarse en la habilidad. Luma Virtual Agent proporciona un conjunto de funciones predefinidas que permiten a los administradores o desarrolladores de habilidades analizar, procesar o modificar el valor proporcionado por el usuario o la respuesta de integración y pasar ese valor modificado a un atributo de usuario global, local o personalizado. Los valores modificados también se pueden usar para configurar la carga útil para ejecutar una acción, habilidad o respuesta del bot para el usuario final.
Por ejemplo, puede cambiar el formato de fecha y hora a un formato personalizado que no sea el formato definido por el sistema y presentarlo al usuario.
Luma proporciona una variedad de funciones de transformación para permitir que los desarrolladores de habilidades modifiquen datos según sea necesario, como dividir, recortar, subcadena, reemplazar, fecha y hora personalizadas y horas personalizadas, entre otras.
Cómo usar las funciones de transformación
Las funciones de transformación se pueden utilizar en las siguientes situaciones:
Generando una habilidad como tema de conversación.
Al crear una operación de integración, en Inbound Response Mapping (en el mapeo de entrada de respuesta)
Al crear un seguimiento, en la definición de Mensaje, Extracción de datos y Destinatarios.
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:
El primer paso es agregar el segmento Set attribute → Transform (Establecer el atributo → Transformar).
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.
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).
En el control Set Attribute (Establecer atributo), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo).
Al crear la operación, las funciones de transformación se utilizan en la sección Inbound mapping (Asignación de entrada).
En Create Operation--> Response Configuration (Crear operación--> Configuración de respuesta), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo).
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:
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.
Function Mode (Modo de función): representa los modos de transformación disponibles para la ejecución.
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.
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.
Attribute (Atributo): representa el nombre del atributo.
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:
Función de transformación | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Dividir | Dividir | Delimiter (Delimitador): es el carácter o expresión que se utiliza para dividir la cadena. En el ejemplo proporcionado, “@” es la expresión delimitadora. | Tenga en cuenta que el atributo de entrada @{user.email} contiene el valor Test@serviceaide.com. La dirección de correo electrónico del usuario que inició sesión que aparece en el atributo de usuario @{user.email} se divide en el carácter “@” y se devuelve la subcadena en la posición del índice [1]. | serviceaide.com |
Index Position (Posición del índice): representa la posición del índice para recuperar el texto de la cadena resultante. |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Recortar | Recortar | No aplicable | Por ejemplo, la cadena de entrada es “Luma VSA”. | Luma VSA |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Reemplazar | Reemplazar subcadena | Find (Buscar): representa la subcadena a reemplazar. En el siguiente ejemplo, la subcadena es “VSA” | Por ejemplo, la cadena de entrada es “VSA Luma VSA” | Virtual Agent Luma Virtual Agent |
Replacement (Reemplazo): representa la cadena sustituta, la que reemplazará la subcadena en el campo Find (Buscar). En el siguiente ejemplo, la subcadena sustituta es “Virtual Agent”. |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Reemplazar | Reemplazar primera subcadena | Find (Buscar): representa la subcadena a reemplazar. En el siguiente ejemplo, la subcadena es “VSA” | Por ejemplo, la cadena de entrada es “VSA Luma VSA” La primera aparición de la subcadena se reemplazará por la nueva cadena. | Virtual Agent Luma VSA |
Replacement (Reemplazo): representa la cadena sustituta, la que reemplazará la subcadena en el campo Find (Buscar). En el siguiente ejemplo, la subcadena sustituta es “Virtual Agent”. |
La barra diagonal inversa (\) o del signo de dólar ($) en la cadena de reemplazo pueden afectar el resultado de la transformación. Utilice una expresión regular para reemplazar una cadena o partes de una cadena.
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Subcadena | Extraer | Start Position (Posición de inicio): especifica la posición del carácter de inicio en la cadena de entrada para iniciar la extracción. En el siguiente ejemplo, la posición de inicio es 0. | Tenga en cuenta que el atributo de entrada @{user.email} contiene la dirección de correo electrónico del usuario que inició sesión, Test@serviceaide.com. La subcadena entre las posiciones especificadas se extraerá en una nueva cadena. | Prueba |
End Position (Posición de cierre): especifica la posición del carácter final en la cadena de entrada para detener la extracción. En el siguiente ejemplo, la posición de inicio es 4. |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Aleatorio | Número aleatorio | No of digits (Número de dígitos): representa el número de dígitos necesarios para el número aleatorio. En el siguiente ejemplo, el número de dígitos se estableció en 5. | La función genera un número aleatorio de cinco dígitos. | 57895 (cualquier número aleatorio) |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Aleatorio | UUID aleatorio (mayúsculas) | No aplicable | La función genera un código hexadecimal único. Nota: La función no requiere ningún valor de entrada. | 0DBEE5E0-525E-4A12-8A0D-163657286C7F (un UUID aleatorio) |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Tiempo Epoch | Hora UTC actual (en ms) | No aplicable | La función devuelve la hora actual de Unix en milisegundos en la zona horaria UTC. Nota: La función no requiere ningún valor de entrada. | 1600330046722 (hora actual) |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Tiempo Epoch | ISO a Epoch en milisegundos | No aplicable | Por ejemplo, si la cadena de entrada es La función devuelve la fecha y hora en milisegundos Epoch según formato horario ISO-8601 especificado. | 1594923630000 |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Tiempo Epoch | ISO a Epoch en segundos | No aplicable | Por ejemplo, si la cadena de entrada es La función devuelve la hora Unix en milisegundos para la fecha y hora especificada en formato ISO-8601. | 1594923630 |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Formato de fecha personalizado | Uso de la fecha y hora ISO | Format (Formato): representa el formato de fecha y hora al que se debe transformar la cadena de entrada. ISO Date Time (Fecha y hora ISO): representa la fecha y hora de entrada en formato ISO 1806. Aquí puede proporcionar un atributo que contenga una fecha y hora en formato ISO o una cadena. | Tenga en cuenta que la fecha y hora ISO de entrada es La función devuelve la hora de entrada en formato de hora ISO-8601 a d-m-a (día-mes-año) | 16-7-2020 |
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:
Función | Modo de función | Campos específicos de la función | Ejemplo | Resultado |
|---|---|---|---|---|
Formato de fecha personalizado | Uso de la fecha y hora ISO | Formato- Representa el formato de fecha y hora al que se debe transformar la cadena de entrada. Epoch Time ( Milliseconds) - Representa la fecha y hora de Epoch de entrada en milisegundos para convertir al formato especificado. Aquí puede proporcionar un atributo que contenga la fecha y hora Epoch o una cadena. Zoneid ( Zone ID): Representa la zona horaria a la que se debe convertir la cadena de entrada. Por ejemplo, America / Sao_Paulo, America / New_York, Asia / Kolkata, Asia / Shanghai, among others. | Si la entrada en tiempo La función devuelve la fecha y hora de entrada es dMa H m (día-mes-año hora:minutos) | 16-7-2020 23 50 |
Nota: Los formatos de fecha y hora deben proporcionarse con los siguientes símbolos. Por ejemplo, use dMy para dia-mes-año or d / M / y H: m para día-mes-año horas:minutos.
