El sistema contiene muchos tipos diferentes de variables que se pueden utilizar en las habilidades para un mensaje, regla, cumplimiento o integración. Este artículo explica cómo y cuándo se pueden utilizar estas variables y, lo que es más importante, sus formatosLa 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 Bot Builder (Consola de Administración de Luma).
Se pueden utilizar las variables en los siguientes escenarios:
- Ejecutar servicios webAnular
- Reemplazar servicios web en atributosAnular servicios web en el cumplimiento de habilidades
- Establecer las respuestas de texto de la habilidadMensaje 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 ingresados 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. |
|
| Atributo local | Los atributos locales se utilizan para almacenar datos temporalmente los datos durante la vida ejecución de una habilidad u operaciónla habilidad. El valor almacenado en una variable local se conserva solo hasta el elemento de conversación de solicitud. Si se utiliza después de la solicitud, el valor del atributo local no estará disponible. A diferencia de un atributo global , que es válido para toda la sesión del usuarioque se puede utilizar en varias habilidades y eventos, un atributo local no está disponible fuera de la habilidad u operación en la que se ha definido. Los atributos locales se utilizan como un marcador de posición en las plantillas de mensajes de usuario y las reglas dentro del flujo de trabajo de acción. está definido. | @{local.<localAttributeName>} Por ejemplo, se utiliza @{local. ticketId} para almacenar el ID del ticket. | @{local. ticketId} |
| Atributo personalizado del usuario | Los atributos personalizados del por el 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 por el 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. |
Parámetros de integración externa:
|
| Channel Attribute | Un atributo de canal se usa para autenticar el usuario en función del canal que se utilizaalmacenar los detalles del canal utilizado para interactuar con el bot . Almacena los detalles de autenticación del usuario. | @{channel.<channelAttribute>} Por ejemplo, @{channel.channelType} se utiliza para almacenar el tipo de canal actual, por ejemplo, WeChat. |
|
| 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. | |
| 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 para agregar valores de parámetros 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. |
|
| 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. |
|
| 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. |
|
| Conversación | Un atributo de contexto de conversación se utiliza para almacenar los detalles del atributo en uso durante la ejecución de la habilidad. | @{conv. <parametername>} Por ejemplo, @{conv. currentAttributeName} almacena el nombre del atributo que se utiliza al ejecutar una habilidad. @{conv.skillName) contiene el nombre de la habilidad que se está ejecutando como parte de la conversación. |
|
| Desambiguación | Estos atributos contienen detalles de la desambiguación de la habilidad resuelta por el bot | ||
| Seguimiento | Estos atributos contienen detalles de los seguimientos procesables configurados y activados para el tenant. | @{followup. <parametername>}, por ejemplo, @{followup.attemptNumbers} almacena el número de intentos configurados para que se active el seguimiento. | |
| Formato | Estos atributos se utilizan para formatear los mensajes del bot que se muestran en los canales de chat. | ||
| Transferir grupo nuevamente | El atributo 'Re Transfer Group' (Transferir grupo nuevamente) se utiliza para almacenar los detalles del grupo de soporte al que se ha asignado la solicitud del usuario. | @{retransferGroup.newGroupName} representa el nombre del grupo de soporte cada vez que el usuario solicita hablar con un agente de soporte. |
|
| Comando de habilidad | El comando Skill (Habilidad) almacena información sobre las habilidades utilizadas por el usuario para salir de la conversación con Virtual Agent o el agente de soporte O BIEN transferir la conversación a los agentes de soporte. | es específico del tenant y se establece en '//abort' de forma predeterminada. |
|
| Agente de soporte | Los atributos del agente de soporte se utilizan para almacenar detalles relacionados con el agente de soporte que ha iniciado sesión en la consola de chat del agente para ayudar a los usuarios con su solicitud. | @{supportagent. <attribute>} , |
|
| Chat del agente de soporte | El chat del agente de soporte almacena los detalles de la conversación entre el usuario final y el agente de soporte | @{supportagentchat.transcriptJson} almacena la transcripción de la conversación entre el usuario final y el agente de soporte en formato JSON |
|
| Grupo de soporte | Los atributos del grupo de soporte se utilizan para almacenar detalles relacionados con el grupo de soporte seleccionado | ||
| Comandos del sistema | Los comandos del sistema se utilizan para activar una acción del sistema | @{systemcommand.skip}, el comando Skip (Omitir) se utiliza para determinar si el usuario final ha solicitado omitir la solicitud durante la ejecución de la habilidad. |
|
| Tenant | Los atributos de tenant se utilizan para almacenar información relacionada con el tenant al que está conectado el usuario. | @{tenant. <attribute>} , |
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.
| Info | ||
|---|---|---|
| ||
La función de búsquedas inteligentes está disponible en System skills (Habilidades del sistema), Small talk (Charla), Skill Builder (Constructor de habilidades), Integrations (integraciones), Bot Configurations (Configuraciones de bots) y tenant Settings (Configuraciones del Tenant). |