O sistema contém muitos tipos diferentes de variável A plataforma Luma VA fornece diversas variáveis de contexto que podem ser usados em habilidades para uma mensagem, uma regra, um processamento ou uma integração. Este artigo aborda como e quando essas variáveis podem ser usadas e, sobretudo, o respectivo formatousadas para representação em conversas de habilidade, definições de configuração e em todo o aplicativo do Criador de bot.
As variáveis podem ser usadas nos cenários a seguir:
- Executar serviços web
- Substituir serviços web em atributosSubstituir serviços web no processamento de habilidades
- Definir respostas de texto da habilidadeMensagem de informação interna para as respostas do bot ao usuário.
Veja a seguir uma lista dos parâmetros e cenários nos quais elas são usadas.
| Tipos de variável | Descrição | Exemplos | Variáveis OOTB (Out-of-the-Box - Prontas para Uso) |
|---|---|---|---|
| Atributo global | Os atributos globais armazenam dados extraídos da entrada do usuário, operações de integração de terceiros, respostas e muito mais. Os atributos globais são usados como espaços reservados em modelos de mensagem do usuário, regras, integrações, fluxos de trabalho de ação e mais. | @{global.<attributeIdentifier>} Por exemplo, @{global.itsm_ticketDescription} é usado para armazenar a descrição do ticket do ITSM, extraído da entrada do usuário. |
|
| Atributo local | Os atributos locais são usados para armazenar dados temporariamente durante a vida útil de uma habilidade ou operação. Diferentemente de um atributo global, que é válido para toda a sessão do usuário, um atributo local não está disponível fora da habilidade ou operação em que foi definida. Os Ele é válido entre os prompts e é usado para passar dados entre várias integrações Os atributos locais também são usados como um espaço reservado em modelos e regras de mensagem do usuário e regras no fluxo de trabalho de ação. | @{local.<localAttributeName>} Por exemplo, @{local.ticketId} é usado para armazenar a ID do ticket. | @{local.ticketId} |
| Atributo de usuário personalizado | Atributos de usuário personalizados armazenam Atributos de perfil do usuário definidos por um administrador de sistema. Geralmente, eles armazenam informações, como departamento, local, status VIP e muitas outras que as habilidades podem usar para regras e ramificação. Os atributos de usuário personalizados são usados como espaços reservados em modelos de mensagem do usuário, regras e muitos mais. | @{user.<userProfileAttributeName>} Por exemplo, @{user.firstName} é usado para armazenar o nome do usuário no canal atual. |
Parâmetros de integração externos:
|
| Atributo de canal | Um atributo de canal é usado para autenticar o usuário com base no canalarmazenar os detalhes do canal usado para interagir com o bot. Ele armazena os detalhes de autenticação do usuário. | @{channel.<channelAttribute>} Por exemplo, @{channel.channelType} é usado para armazenar o tipo de canal atual, por exemplo, o WeChat. |
|
| Atributo de bot | Os atributos de bot armazenam os atributos específicos do bot atual. | @{bot.<botAttribute>} Por exemplo, @{bot.name} é usado para armazenar o nome do bot atual. | |
| Atributos de configuração da instância do aplicativo conectado | Os atributos de configuração da instância do aplicativo conectado armazenam os parâmetros configurados na instância do aplicativo conectado. Eles são utilizados como espaços reservados em modelos de mensagem do usuário, regras, integrações, fluxos de trabalho de ação e assim por diante. | @{app.<parameterName>} Por exemplo, @{app.headers.user_auth_token} é usado para armazenar o token de autenticação do usuário durante a integração do serviço web. |
|
| Solicitação HTTP da operação do aplicativo conectado | Esse atributo contém os valores das solicitações HTTP enviadas para outros sistemas. | @{solicitação.<parametername>} Por exemplo, @{request.timeout} é usado para o tempo limite da solicitação em uma chamada de API durante uma conversa do bot. |
|
| Resposta HTTP da operação do aplicativo conectado | Esse atributo contém os valores das respostas HTTP recebidas de outros sistemas. | @{response.<parametername>} Por exemplo, @{response.statusCode} é usado para exibir o código de status da resposta em uma chamada de API durante uma conversa do bot. |
|
Pesquisas inteligentes
A Luma fornece um recurso de pesquisa inteligente que permite ao administrador do sistema/desenvolvedor acessar rapidamente as variáveis de contexto
Isso ajuda a evitar ter que digitar manualmente, lembrar o formato e consultar a documentação da API. Ele permite que você pesquise diretamente os atributos disponíveis para sua habilidade. Os atributos são agrupados em várias categorias para ajudar a identificar rapidamente o atributo necessário.
Digite @ para invocar o pop-up de pesquisas inteligentes de modo a ver a lista de categorias das variáveis de contexto.
Os resultados são exibidos em ordem alfabética de A a Z. Você pode pesquisar ou rolar pelo conjunto de resultados e selecionar a variável de contexto necessária. O item selecionado será preenchido no respectivo campo.
| Info | ||
|---|---|---|
| ||
O recurso Pesquisas inteligentes está disponível em Habilidades do sistema, Conversa trivial, Criador de habilidades, Integrações, Configurações de bot e Definições do inquilino |