Documentación de Oracle Cloud Infrastructure

Otros tipos de variables

Además de las variables de flujo y las variables globales, puede utilizar el ámbito de usuario, el perfil y las variables del sistema.

Variables de ámbito de perfil para contexto de usuario

Puede acceder a los valores del nombre, la configuración regional y la hora local de un usuario mediante variables de ámbito de perfil, que acceden a la configuración del perfil desde el cliente de chat.

Por ejemplo:
"Hello ${profile.firstName}, how can I help you today?"

Imagen de profile.firstName en la salida.
Utilice estas variables predefinidas para generar una salida específica del contexto del usuario de la aptitud.
Para ello... Use lo siguiente:...
Obtener el nombre propio del usuario del bot. ${profile.firstName}
Obtener el apellido del usuario del bot. ${profile.lastName}
Obtener la configuración regional del usuario del bot. ${profile.locale}
Obtener la zona horaria del usuario (con un desfase de milisegundos). ${profile.timezoneOffset}

Estas variables predefinidas se definen automáticamente a partir de los valores de la plataforma de mensajes. Los valores varían según la plataforma de mensajería y puede que algunas plataformas de mensajería no los proporcionen. Para las integraciones del asistente digital como agente, por ejemplo, profile.firstName, profile.lastName y profile.email solo tienen valores si el usuario ha iniciado sesión en Oracle Service Cloud o si un usuario ha rellenado los campos para el nombre, el apellido y la dirección de correo electrónico en la página de inicio de chat de Oracle Service Cloud antes de solicitar un chat. Para Oracle Web Client, estos valores de perfil se deben definir con la propiedad initUserProfile o el método updateUser.

Guardar valores específicos de usuario para visitas posteriores

Puede crear variables de ámbito de usuario para que se mantengan entre sesiones.

En general, cuando finaliza una conversación de usuario con una aptitud o un asistente digital, se destruyen los valores de variable definidos a partir de la entrada de usuario. Sin embargo, también puede definir variables de ámbito de usuario para retener la entrada de usuario de sesiones anteriores a fin de mejorar las nuevas conversaciones. Las variables de ámbito de usuario se crean directamente en los propios componentes.

Para crear una variable de ámbito de usuario:

  1. En el campo Variable del inspector de propiedades del componente en el que desea crearlo, seleccione Variable de ámbito de usuario en la lista desplegable.
  2. En el campo Nombre de variable de ámbito que aparece, introduzca el nombre de la variable.

    Introduzca el nombre sin el prefijo user.. (Aunque utilice ese prefijo al hacer referencia a una variable de ámbito de usuario, no lo utilizará al definirla).

Para hacer referencia a una variable de ámbito de usuario, utilice una expresión como ${user.VAR_NAME}.

Por ejemplo, en la aptitud de ejemplo Aptitud de pizza - Diseñador de flujos visuales, la variable de ámbito de usuario lastOrderNumber se define después de que el usuario realice el orden en el flujo service.reg.placeOrder. La expresión ${((user.lastOrderNumber)?has_content)} hace referencia a esta variable en el primer estado del flujo al que se llama cada vez que se inicia la aptitud (handler.startSkill) para determinar si el usuario ha realizado algún pedido anterior.

Nota

Los valores de las variables de ámbito de usuario son específicos del canal. Por ejemplo, si un usuario accede a una aptitud en un canal web y, a continuación, accede a la aptitud a través de un canal de Microsoft Teams, el canal de Teams tendrá sus propias instancias de las variables de usuario y no reconocerá los valores de la conversación anterior en el canal web.

Variables del Sistema

Variable Tipo Descripción
system.nlpresult Resultado de NLP Se utiliza para almacenar el resultado de NLP para la expresión del usuario. Para obtener el resultado de NLP completo, puede utilizar la expresión ${skill.system.nlpresult.value}.
system.intent.utterance Cadena Cuando esta variable tiene un valor, se utilizará para la coincidencia de intenciones en lugar del último mensaje de usuario. Para acceder a esta variable, puede utilizar la expresión ${skill.system.intent.utterance}.
system.event Asignar Cuando uno de los eventos incorporados se asigna en el flujo principal o en un subflujo, esta variable contiene propiedades de evento que puede utilizar para manejar el evento. Por ejemplo, para obtener una carga útil de evento, debe utilizar una expresión con el formato ${skill.system.event.value.EVENT_NAME}.
system.rb grupo de recursos Se utiliza para acceder a entradas de grupos de recursos de idiomas. Para acceder a una entrada de grupo de recursos, puede utilizar una expresión con el formato ${skill.system.rb.RB_ENTRY_NAME}.