Usar variables en las Habilidades

La plataforma de Luma VA proporciona diversas variables de contexto que se pueden representar en las conversaciones de habilidades, ajustes de configuración y en toda la aplicación del generador de bots.

Se pueden utilizar las variables en los siguientes escenarios:

Ejecutar servicios web
Anular servicios web en el cumplimiento de habilidades
Mensaje de información interna para las respuestas del bot al usuario.

A continuación, se muestra una lista de los parámetros y las situaciones donde se utilizan.

Tipos de variables	Descripción	Ejemplos	Variables listas para usar
Atributo global	Los atributos globales almacenan los datos extraídos de los datos introducidos por el usuario, operaciones de integración de terceros, respuestas y más. Los atributos globales se utilizan como marcadores de posición en plantillas de mensajes de usuario, reglas, integraciones, flujos de trabajo de acción y mucho más.	@{global.<attributeIdentifier>} Por ejemplo, @{global.itsm_ticketDescription} se utiliza para almacenar la descripción del ticket de ITSM que se extrae desde la entrada del usuario.	@{global.itsm_instanceId} @{global.itsm_ticketDescription} @{global.itsm_ticketType}
Atributo local	Los atributos locales se utilizan para almacenar temporalmente los datos durante la vida de una habilidad u operación. A diferencia de un atributo global, que es válido para toda la sesión del usuario, un atributo local no está disponible fuera de la habilidad u operación en la que se ha definido. Es válido entre las solicitudes y se utiliza para pasar datos entre varias integraciones. Los atributos locales también se utilizan como marcadores temporales en las plantillas de mensaje del usuario y las reglas dentro del flujo de trabajo de la acción.	@{local.<localAttributeName>} Por ejemplo, se utiliza @{local. ticketId} para almacenar el ID del ticket.	@{local. ticketId}
Atributo personalizado del usuario	Los atributos personalizados del usuario almacenan atributos de perfil del usuario definidos por un administrador del sistema. Por lo general, almacenan información como, por ejemplo, el departamento, la ubicación, el estado de la VIP y más cosas que pueden utilizar las habilidades para reglas y bifurcaciones. Los atributos personalizados del usuario se utilizan como marcadores de posición en las plantillas de mensajes del usuario, reglas y más.	@{user.<userProfileAttributeName>} Por ejemplo, @{user.firstName} se utiliza para almacenar el nombre del usuario en el canal actual.	@{user.firstName} @{user.middleName} @{user.lastName} @{user.email} @{user.userName} @{user.id} @{user.phone} @{user.timezone} @{user.title} @{user.contactExternalId} @{user.roleIds} @{user.roleNames} @{user.groupIds} @{user.groupNames} @{user.languageLocale} @{user.languageName} @{user.languageDisplayName} @{user.languageCode} Parámetros de integración externa: @{user.location} @{user.employee id}
Channel Attribute	Un atributo de canal se usa para almacenar los detalles del canal utilizado para interactuar con el bot.	@{channel.<channelAttribute>} Por ejemplo, @{channel.channelType} se utiliza para almacenar el tipo de canal actual, por ejemplo, WeChat.	@{channel.channelScopeContactId} @{channel.channelType} @{channel.channelAuthenticationId} @{channel.channelAuthenticationStatus} @{channel.channelAuthenticationMode}
Bot Attribute	Los atributos de bot almacenan los atributos específicos del bot actual.	@{bot.<botAttribute>} Por ejemplo, @{bot.name} se utiliza para almacenar el nombre del bot actual.	@{bot.name} @{bot.externalId} @{bot.symbol} @{bot.id} @{bot.languageLocales} @{bot.languageNames} @{bot.languageDisplayNames} @ {bot.languageCodes}
Atributos de configuración de la instancia de la aplicación conectada	Los atributos de configuración de la instancia de la aplicación conectada almacenan los parámetros configurados en la instancia de la aplicación conectada. Se utilizan como marcadores de posición en las plantillas de mensajes del usuario, reglas, integraciones, flujos de trabajo de acción, entre otras.	@{app.<parameterName>} Por ejemplo, @{app.headers.user_auth_token} se utiliza para almacenar el token de autenticación del usuario durante una integración con el servicio web.	@{app.apiBaseUrl} @{app.headers.csm_app_url} @{app.headers.user_auth_token}
Solicitud HTTP de operación de la aplicación conectada	Este atributo contiene los valores de las solicitudes HTTP enviadas a otros sistemas.	@{request.<parametername>} Por ejemplo, @{request.timeout} se usa para el tiempo de espera de la solicitud en una llamada de API durante una conversación con un bot.	@{request.requestUri} @{request.method} @{request.requestUrl} @ request.headers.<headerName>} @{request.path.<pathParameterName>} @{request.query.<queryParameterName>} @{request.soapBinding} @{request.soapOperation} @{request.soapEndPoint} @{request.timeout} @{request.body}
Respuesta HTTP de operación de la aplicación conectada	Este atributo contiene los valores de las respuestas HTTP recibidas desde otros sistemas.	@{response.<parametername>} Por ejemplo, @{response.statusCode} se usa para mostrar el código del estado de la respuesta en una llamada de API durante una conversación con un bot.	@{response.statusCode} @{response.protocolVersion} @{response.reasonPhrase} @{response.statusLine} @{response.headers.<headerName>} @{response.body}

Búsquedas inteligentes

Luma proporciona una función de búsqueda inteligente que permite al administrador o desarrollador del sistema acceder de forma rápida a las variables de contexto.

Esto evita que deba ingresar todo de forma manual y permite recordar el formato y consultar la documentación de la API. Permite buscar los atributos disponibles para su habilidad de forma sencilla y directa. Los atributos se agrupan en varias categorías para ayudarle a identificar rápidamente el atributo requerido.

Escriba @ para abrir la venta emergente de búsquedas inteligentes y ver la lista de categorías de variables de contexto.

Los resultados se muestran en orden alfabético. Puede buscar o desplazarse por el conjunto de resultados y seleccionar la variable de contexto que busca. El elemento seleccionado se rellenará en el campo correspondiente.

Información

La función de búsquedas inteligentes está disponible en System skills (Habilidades del sistema), Small talk (Charla), Skill builder (Generador de habilidades), Integrations (integraciones), Bot Configurations (Configuraciones de bots) y Tenant Settings (Configuraciones de inquilinos).