Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 botsBot Builder (Consola de Administración de Luma).

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 variablesDescripciónEjemplosVariables listas para usar
Atributo globalLos atributos globales almacenan los datos extraídos de los datos introducidos por el usuario, operaciones de integración de tercerosde terceros, respuestas y más. Los atributos globales se utilizan 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 datos temporalmente
los datos
durante la
vida
ejecución de
una habilidad u operación
la 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 usuario
que 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. 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.
está definido.

@{local.<localAttributeName>} 

Por ejemplo, se utiliza @{local. ticketId} para almacenar el ID del ticket.

@{local. ticketId}
Atributo personalizado Atributo personalizado del usuarioLos atributos personalizados del usuario almacenan atributos 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 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.languageLocalelanguageLocale} 
  • @{user.languageNamelanguageName} 
  • @{user.languageDisplayNamelanguageDisplayName} 
  • @{user.languageCode} 

 

Parámetros de integración externa: 

  • @{user.location} 
  • @{user.employee id} 
Channel Attribute

Un atributo de canal de canal se usa para  almacenar para almacenar los detalles del canal utilizado 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 AttributeLos 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.languageLocaleslanguageLocales} 
  • @{bot.languageNameslanguageNames} 
  • @{bot.languageDisplayNameslanguageDisplayNames} 
  • @ {bot.languageCodes} 
Atributos de configuración de la instancia de la aplicación conectada conectada Los atributos de configuración de la instancia de la aplicación conectada almacenan conectada almacenan los parámetros configurados en la instancia de la aplicación conectada. Se utilizan como marcadores de posición utilizan 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.

  • @{app.apiBaseUrl} 
  • @{app.headers.csm_app_url} 
  • @{app.headers.user_auth_token} 
Solicitud HTTP de operación de la aplicación conectadaEste atributo contiene los valores de las solicitudes HTTP enviadas 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 conectadaEste atributo contiene los valores de las respuestas HTTP recibidas 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}     
                                                      
ConversaciónUn 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.
  • @{conv.currentAttributeBlackListedFileFormats}
  • @{conv.currentAttributeDefaultValue}
  • @{conv.currentAttributePattern}
  • @{conv.currentAttributeDataType}
  • @{conv.currentAttributeEnumList}
  • @{conv.currentAttributeIdentifier}
  • @{conv.currentAttributeLength)
  • @{conv.currentAttributeMaximum)
  • @{conv.currentAttributeMaximumFileSize)
  • @{conv.currentAttributeMaximumLength)
  • @{conv.currentAttributeMinimum)
  • @{conv.currentAttributeMinimumLength)
  • @{conv.currentAttributeName)
  • @{conv.currentAttributeValidFileFormats)
  • @{conv.currentAttributeRequired)
  • @{conv.skillName)
DesambiguaciónEstos atributos contienen detalles de la desambiguación de la habilidad resuelta por el bot@{disamb.<attribute>}, por ejemplo, @{disamb.nombres dehabilidades) se utiliza para almacenar el nombre de las habilidades de la competencia que se encuentran dentro del intervalo de proximidad
  • @{disamb.skillConfidenceScores}
  • @{disamb.entities)
  • @{disamb.skillDescriptions)
  • @{disamb.skillIdentifiers)
  • @{disamb.skillNames)
SeguimientoEstos 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.

  • @{followup.attemptNumbers}
  • @{followup.configurationConnectionType)
  • @{followup.configurationId)
  • @{followup.configurationName)
  • @{followup.data)
  • @{followup.extractedDataType)
  • @{followup.recordIdentifiers)
FormatoEstos atributos se utilizan para formatear los mensajes del bot que se muestran en los canales de chat.

Por ejemplo ,@{format.lineBreak) representa un carácter de nueva línea y se utiliza para agregar un salto de línea.

  • @{format.beginBold}
  • @{format.beginItalic)
  • @{format.endBold)
  • @{format.endItalic)
  • @{format.lineBreak)
Transferir grupo nuevamenteEl atributo 'Re Transfer Group' (Retransferir grupo) 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.

  • @{retransferGroup.newGroupName}
Comando de habilidadEl 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.Por ejemplo, @{skillcommand.abort} se utiliza para salir de la conversación,  es específico del tenant y se establece en '//abort' de forma predeterminada.
  • @{skillcommand.abort}
  • @{skillcommand.agentTransfer}
Agente de soporteLos 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>} ,por ejemplo, @ {supportagent.firstName} se utiliza para almacenar el nombre del  agente de soporte.
@{supportagent.groupNames} almacena los grupos de soporte de los que forma parte el agente de soporte.

  • @{supportagent.contactExternalId}
  • @{supportagent.email}
  • @{supportagent.firstName}
  • @{supportagent.groupIds}
  • @{supportagent.groupNames}
  • @{supportagent.id}
  • @{supportagent.languageCode}
  • @{supportagent.languageDisplayName}
  • @{supportagent.languageLocale}
  • @{supportagent.languageName}
  • @{supportagent.lastName}
  • @{supportagent.middleName}
  • @{supportagent.phone}
  • @{supportagent.roleIds}
  • @{supportagent.roleNames}
  • @{supportagent.timezone}
  • @{supportagent.title}
  • @{supportagent.userName}
Chat del agente de soporteEl 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

  • @{supportagentchat.transcriptJson}
Grupo de soporteLos atributos del grupo de soporte se utilizan para almacenar detalles relacionados con el grupo de soporte seleccionado

@{supportgroup.<attribute>}, por  ejemplo @{supportgroup.memberCount) representa el número total de agentes de soporte en el grupo de soporte seleccionado.

  • @{supportgroup.groupExternalId}
  • @{supportgroup.memberCount}
  • @{supportgroup.name}
  • @{supportgroup.usedFor}
  • @{supportgroup.id}
Comandos del sistemaLos 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.

  • @{systemcommand.skip}
TenantLos atributos de tenant se utilizan para almacenar información relacionada con el tenant al que está conectado el usuario.@{tenant.<attribute>} ,por ejemplo, @ {tenant.name} se utiliza para almacenar el nombre del tenant
  • @{tenant.externalId}
  • @{tenant.name}
  • @{tenant.symbol}
  • @{tenant.tenantId}

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.


Image Modified


Info
titleInformación

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