Usando funções de transformação

As funções de transformação são usadas quando as informações recebidas da entrada ou integração do usuário devem passar por uma transformação para que possam ser usadas na habilidade. A Agente virtual Luma fornece um conjunto de funções predefinidas que permitem que os administradores ou desenvolvedores de habilidades analisem, processem ou modifiquem o valor fornecido pelo usuário ou pela resposta da integração e passem o valor modificado a um atributo de usuário Global, Local ou Personalizado. Os valores modificados também podem ser usados para configurar a carga para executar uma ação/habilidade ou resposta do bot para o usuário final.

Por exemplo, você pode modificar o formato de data e hora para o formato personalizado de sua preferência, diferente do formato definido pelo sistema, e apresentá-lo ao usuário.

A Luma fornece uma variedade de funções de transformação para permitir que os desenvolvedores de habilidades modifiquem os dados conforme necessário, como dividir, cortar, subsequência de caracteres, substituir, data e hora personalizadas e muito mais.

Como usar as funções de transformação?

As funções de transformação podem ser usadas nos seguintes cenários:

• Criando uma habilidade, como um item de conversa

• Criando uma operação de integração, no mapeamento de resposta de entrada

• Criando um acompanhamento, em extração de dados, destinatários e definição da mensagem

Usando as funções de transformação, os desenvolvedores/administradores de habilidades podem extrair uma sequência de caracteres ou converter algumas informações em dados, que são necessários para executar a habilidade ou a integração.
Para adicionar as funções de transformação, siga as etapas abaixo:

1. A primeira etapa é adicionar o segmento Definir atributo → Transformar.

   1. Ao criar uma habilidade, as funções de transformação podem ser adicionadas ao fluxo de trabalho da conversa. Consulte Criar habilidades para obter mais informações sobre como criar uma habilidade.

      1. No Skill Builder - >seção Fluxo de conversa, selecione Definir atributo no item de conversa.

         Open

         

      2. No controle Definir atributo, selecione Transformar na lista suspensa Adicionar atributo.

         Open

         

          

   2. Ao criar uma operação, as funções de transformação são usadas na seção Mapeamento de entrada.

      1. Em Criar operação - > Configuração de resposta, selecione Transformar na lista suspensa Adicionar atributo.

          

2. Uma vez que o segmento é adicionado à tela, você pode selecionar a função de transformação conforme necessário. Além dos parâmetros específicos da função, veja abaixo os detalhes necessários para cada função:

   1. Função de transformação: essa é a função de transformação necessária. Modo de função, Atributo a ser transformado e outros campos específicos aparecem e são preenchidos com base na função de transformação selecionada.

   2. Modo de função: representa os modos de transformação disponíveis para execução.

   3. Atributo a ser transformado: representa a sequência de caracteres de entrada a ser transformada. Você pode adicionar um atributo válido ou uma sequência de caracteres ao campo.

   4. Escopo: representa o escopo do Atributo de saída para o qual os dados transformados devem ser transmitidos. Você pode atribuir o valor a um Atributo de usuário Local, Global ou Personalizado.

   5. Atributo: representa o nome do atributo.

   6. Tipo de dado: representa o tipo de dado do atributo. No caso dos atributos de usuário Global e Personalizado, o tipo de dado é preenchido com base na definição do atributo selecionado. Ao usar um atributo local, selecione o tipo de dado com base no valor a ser salvo.

Veja a seguir as funções de transformação disponíveis no sistema:

Dividir

A função Dividir pode ser usada para dividir um texto ou uma resposta de integração em sequências de caracteres menores. Ela divide a sequência no caractere delimitador e extrai o texto na posição de índice definida da matriz extraída. A função retorna um conjunto de sequências de caracteres menores na ordem de sua ocorrência na sequência de caracteres. As sequências extraídas podem ser passadas para um atributo.

Adicione os seguintes detalhes para usar a função:

Cortar

A função Cortar é usada para remover espaços em branco da sequência de caracteres de entrada ou do valor do atributo. Ela retorna uma sequência de caracteres após a remoção de quaisquer espaços em branco à esquerda, à direita ou extras. A sequência de caracteres extraída pode ser passada para um atributo.

Adicione os seguintes detalhes para usar a função:

Substituir - Substituir subsequência de caracteres

A função Substituir localiza e substitui uma subsequência de caracteres por outra no texto de entrada. O modo de função Substituir subsequência de caracteres é usado quando precisamos substituir todas as ocorrências da subsequência de caracteres na sequência de caracteres de entrada. Ele retorna uma sequência de caracteres após substituição das ocorrências da subsequência de caracteres pela sequência de caracteres substituta especificada. A substituição vai do início até o final da sequência de caracteres. A sequência de caracteres extraída pode ser passada para um atributo.

Adicione os seguintes detalhes para usar a função:

Substituir - Substituir primeira subsequência de caracteres

A função Substituir localiza e substitui uma subsequência de caracteres por outra no texto de entrada. O modo de função Substituir subsequência de caracteres é usado quando precisamos substituir a primeira ocorrência da subsequência de caracteres na sequência de caracteres de entrada. Ele retorna uma sequência de caracteres após substituição da primeira ocorrência da subsequência de caracteres pela sequência de caracteres substituta especificada. A substituição vai do início até o final da sequência de caracteres. A sequência de caracteres extraída pode ser passada para um atributo.

Adicione os seguintes detalhes para usar a função:

Subsequência de caracteres

A função Subsequência de caracteres extrai a subsequência de caracteres especificada de uma sequência de caracteres de texto para criar outra sequência de caracteres. A função seleciona caracteres entre os locais especificados e retorna os mesmos como uma nova sequência de caracteres. A sequência de caracteres extraída pode ser passada para um atributo.

Adicione os seguintes detalhes para usar a função:

Aleatório - Número aleatório

A função Aleatório gera um número aleatório. Números aleatórios são usados principalmente para autenticação e verificação do usuário. Por exemplo, a geração OTP usada para autenticação do usuário. O modo de função Número aleatório é usado para gerar um número aleatório com o número especificado de dígitos.

Adicione os seguintes detalhes para usar a função:

Aleatório - UUID aleatória (em maiúscula)

A função UUID aleatória (em maiúscula) gera um identificador exclusivo universal usando o código hexadecimal para caracteres maiúsculos de A a F, que podem ser salvos em um atributo e usados durante a criação de habilidades.

Adicione os seguintes detalhes para usar a função:

Horário UNIX - Horário UTC atual (ms)

A função Horário UNIX - Horário UTC atual (ms) é usada para gerar o horário Unix do sistema atual. A função retorna o horário Unix atual em milissegundos de acordo com o fuso horário UTC.

Adicione os seguintes detalhes para usar a função:

Horário UNIX - ISO para UNIX em milissegundos

A função Horário UNIX - ISO para UNIX em milissegundos é usada para converter o formato de horário ISO em horário Unix em milissegundos. A função converte o formato de horário ISO-8601 de entrada e retorna o horário no formato de milissegundos UNIX.

Adicione os seguintes detalhes para usar a função:

Horário UNIX - ISO para UNIX em segundos

A função Horário UNIX - ISO para UNIX em segundos é usada para converter o formato de horário ISO em horário Unix em segundos. A função converte o formato de horário ISO-8601 de entrada e retorna o horário no formato de segundos UNIX.

Adicione os seguintes detalhes para usar a função:

Formato de data personalizado - usando data e hora ISO

A função de formato de data personalizado converte o formato de data ISO no formato de data e hora necessário. A função retorna a data e hora de entrada no formato de data especificado, como dd-mm-aaaa, mm-dd-aaaa e assim por diante.

Adicione os seguintes detalhes para usar a função:

Formato de data personalizado - usando o horário UNIX

A função de formato de data personalizado converte o horário UNIX em data e hora na zona e no formato especificados. A função retorna o horário UNIX de entrada em milissegundos no formato de data e zona especificados, como d-M-a, M-d-a H m, e assim por diante.

Adicione os seguintes detalhes para usar a função:

Formato de data personalizado - data e hora no zoneamento ISO

A função de formato de data personalizado converte a data e a hora ISO em uma zona e formato específicos. A função retorna uma data e hora ISO na zona especificada.

Adicione os seguintes detalhes para usar a função:

Observação: os formatos de data e hora devem ser fornecidos usando os símbolos abaixo. Por exemplo, use d-M-a para Data-Mês-Ano, d/M/a H: m para Data-Mês-Ano Horas: Minutos.