Trabajar con variables globales

1. Cree una variable o utilice el panel de Variables para abrir una variable existente.

2. En el panel de propiedades de variable, seleccione Global (cualquier tema puede acceder).

   Se agregará al nombre de la variable un prefijo para diferenciarla de las variables de nivel de tópico. Por ejemplo, ahora la variable se muestra como .

3. Guarde el tema.

1. Seleccione la variable deseada.

2. En el panel Propiedades de las variables, debajo de Uso, seleccione Bot (cualquier tema puede acceder).

3. Se marcará al nombre de la variable con un prefijo , para diferenciarla de las variables de nivel de tema. Por ejemplo, ahora la variable se muestra como .

Cuando compone un mensaje en un nodo Mensaje o Pregunta, seleccione el icono {x} para ver las variables disponibles para el tema. Las variables globales aparecen en la pestaña Personalizado junto con cualquier variable de tema. Las variables se enumeran en orden alfabético.

Cuando compone un mensaje en un nodo Mensaje o Pregunta, seleccione el icono {x} para ver las variables disponibles para el tema. Las variables se enumeran en orden alfabético y todas las variables globales aparecen juntas porque todas comienzan con .

Cuando usa un nodo de condición, un nodo de acción de flujo o un nodo de capacidad, también verá las variables globales allí disponibles.

1. Seleccione la variable global deseada en el lienzo de creación o en el panel Variables.

2. En el panel Propiedades de la variable, en la sección Referencia , seleccione Ver todas las referencias.

3. Cambie a la pestaña Otros y seleccione cualquier tema en el que se utilice la variable para ir directamente a ese tema y nodo.

Seleccione la variable deseada en el entorno de creación. Aparece el panel de Propiedades de variables.

• Para ir directamente al nodo en el que se creó la variable global, seleccione Ir al origen.

• Para ir a un tema que use esta variable, seleccione el tema deseado en la sección Usado por.

De forma predeterminada, el valor de una variable global persiste hasta que finaliza la sesión. El nodo Borrar valores de variables restablece los valores de las variables globales y se utiliza en la conversación de reinicio del sistema. Cuando una redirección desencadena ese tema (o cuando el usuario escribe una frase como "Empezar de nuevo"), se restablecen todas las variables globales.

Las variables globales son accesibles desde cualquier tema, y su valor asignado persiste en todo momento de la sesión.

El valor solo se borra cuando el usuario del agente es redirigido al tema Comenzar de nuevo o cuando el usuario desencadena este tema directamente (por ejemplo, escribiendo "Comenzar de nuevo"). En este caso, todas las variables globales se restablecerán y no tendrán valor.

Inicialización de una variable global

Si se desencadena una variable global antes de que se haya inicializado (o "rellenado"), el agente desencadenará automáticamente la parte del tema en la que se define la variable global, aunque esté en un tema diferente, antes de volver al tema original. Este comportamiento le permite al agente rellenar todas las variables sin interrumpir la conversación.

Por ejemplo, el cliente inicia la conversación sobre el tema "Reserva de cita", en el que se usa una variable global . Sin embargo, la variable se define primero en el tema de «Bienvenida».

Cuando la conversación llega a un punto en el tema "Reserva de cita" donde se hace referencia a, el agente cambia de manera fluida al nodo de pregunta donde se define por primera vez.

Cuando el cliente responda la pregunta, el agente reanudará el tema "Reserva de cita".

Comportamiento de variables globales al implementar acciones a través de flujos o aptitudes de Power Automate

A veces, puede usar un flujo o una habilidad para inicializar o completar una variable.

Sin embargo, cuando un usuario interactúa con el agente, la variable puede haberse completado en un punto anterior de la conversación, o puede que haya configurado ya las variables externamente.

En esta situación, el flujo o la habilidad seguirá ejecutándose y completará la variable, sobrescribiendo lo que estuviera almacenado previamente en la variable.

Para asegurarse de que el agente inicia una conversación con cierto contexto, puede utilizar una variable global y establecer su valor desde una fuente externa. Digamos que su sitio requiere que los usuarios inicien sesión. Si almacena el nombre de un usuario en una variable global y se lo pasa al agente, este podrá saludar a los clientes por su nombre antes de que empiecen a escribir su primera pregunta. Otro escenario de ejemplo es pasar el contexto de Dynamics 365 Customer Service a un agente para que pueda iniciar la conversación con el conocimiento de lo que el cliente quiere lograr.

Para evitar latencias no deseadas, puede especificar cuánto tiempo puede esperar el agente por un valor. También puede establecer un valor predeterminado para usar cuando la fuente externa no responda de manera oportuna.

1. Cree un tema dedicado para contener la configuración de todas las variables destinadas a establecerse desde fuentes externas. Podría llamar a este tema "Establecer variables de contexto", por ejemplo. Este tema no sirve para ningún otro propósito, por lo que no es necesario que tenga frases desencadenadoras establecidas.

2. Agregue un nodo de establecimiento del valor de variable a su tema dedicado.

3. En Establecer variable, abra el selector de variable y seleccione Crear una nueva variable.

4. Seleccione el nombre predeterminado de la nueva variable. Aparece el panel de Propiedades de variables.

5. Reemplace el nombre predeterminado por uno que coincida exactamente con el nombre de la variable que se pasa desde el sistema externo.

6. En Uso, seleccione Global (cualquier tema puede acceder) y Fuentes externas pueden establecer valores.

7. En Referencia, seleccione los tres puntos (⋮) en la esquina superior derecha y seleccione Obtener valor de este nodo si está vacío.

8. (Opcional) Establezca un retardo de tiempo de espera, en milisegundos. Este valor determina cuánto tiempo puede esperar el agente a que una fuente externa establezca la variable antes de agotar el tiempo de espera y continuar con el valor predeterminado establecido en el nodo Establecer valor de variable. Esta configuración es pertinente en escenarios en los que la variable depende de un proceso asincrónico o de larga duración, pero el agente debe respetar una latencia máxima para garantizar una buena experiencia de usuario.

   Para las variables procedentes de Omnicanal para Customer Service, sugerimos un valor de 10 segundos (10 000 ms) como tiempo de espera máximo.

9. En el nodo Establecer valor de variable, introduzca el valor predeterminado que se utilizará si se alcanza el tiempo de espera. En tiempo de ejecución, el agente esperará valores con el mismo tipo de datos. Si desea que este valor predeterminado sea una cadena vacía, use como fórmula.

   Captura de pantalla de la configuración de una variable global que se establecerá desde un origen externo

10. Para cualquier otro valor que espere que provenga de un sistema externo, agregue más nodos de Establecimiento de valor de variable a su tópico dedicado y configure las variables globales requeridas de la misma manera.

Así configurado, el agente está listo para realizar pruebas. Cuando se invoca el agente, en lugar de esperar indefinidamente a que se rellenen todas las variables, el agente puede comenzar a enviar inmediatamente cualquier mensaje que no dependa de las variables que se pasan. Cuando el agente intenta acceder a una variable que se está configurando externamente, se detiene hasta que llega el valor o se agota el tiempo de espera. Obtenga más información sobre cómo optimizar los agentes para minimizar la latencia.

Puede configurar una variable de global para que se inicialice desde un origen externo. Esta acción permite al agente iniciar la conversación con algo de contexto.

Por ejemplo, un cliente inicia un chat de agente desde su sitio web, y el sitio ya sabe el nombre del cliente. Indique al agente el nombre del usuario antes de empezar la conversación, para que el agente pueda tener una conversación más inteligente con el cliente sin tener que preguntárselo otra vez.

1. Seleccione la variable global deseada.

2. En el panel Propiedades de variables, seleccione Los orígenes externos pueden establecer valores.

Si está incrustando su agente en una página web simple, puede añadir variables y sus definiciones a la URL del agente. O, si desea tener un poco más de control, puede usar un bloque de código para llamar y usar variables programáticamente.

El nombre de la variable en la cadena de consulta de la URL debe coincidir con el nombre de la variable global, sin el prefijo . Por ejemplo, una variable global se denominaría en la consulta.

En los ejemplos siguientes se utiliza una declaración básica para las variables. En un escenario de producción, puede pasar como parámetro de consulta o definición de variable otra variable que ya ha almacenado el nombre del usuario (por ejemplo, si tiene el nombre de usuario de un script de inicio de sesión).

Anexe las variables y sus definiciones a la URL del agente como parámetros de cadena de consulta con el formato .

Por ejemplo:

• Tiene una variable global llamada .
• La dirección URL de su agente es .
• Para pasar el nombre de usuario al iniciar una conversación de agente en un sitio web, asocie la cadena de consulta como: .

El nombre de parámetro no distingue entre mayúsculas y minúsculas. también funcionaría en este ejemplo.

Puede agregar las variables y sus definiciones, si solo va a insertar el agente en una página web sencilla, o puede usar un bloque de código para llamar a variables y usarlas mediante programación.

En los ejemplos que se describen aquí se realiza una declaración sencilla para las variables. En un escenario de producción, puede pasar como parámetro de consulta o definición de variable otra variable que ya ha almacenado el nombre del usuario (por ejemplo, si tiene el nombre de usuario de un script de inicio de sesión).

1. Anexe las variables y sus definiciones a la URL del agente como parámetros de cadena de consulta (con el formato ). Por ejemplo:

   • Tiene una variable global llamada .
   • La dirección URL de su agente es .
   • Para pasar el nombre de usuario al iniciar una conversación de agente en un sitio web, puede adjuntar la cadena de consulta como: .

2. El nombre del parámetro no distingue entre mayúsculas y minúsculas. Esto significa que también funcionará en este ejemplo.

1. En la sección de la página donde está su agente, defina las variables de la siguiente manera, sustituyendo [nombre_variable] por el nombre de la variable sin el prefijo y [definición] por la definición. Separe múltiples variables con comas ().

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. En su sección, llame a cuando inserte su agente, tal como se muestra en el siguiente ejemplo en el que se invoca a justo antes de donde se invoca a (deberá sustituir por la identificación de su agente):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

1. En la sección de la página donde está su agente, defina las variables de la siguiente manera, sustituyendo [nombre_variable] por el nombre de la variable sin el prefijo y [definición] por la definición. Separe múltiples variables con comas: .

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. En tu sección, llama a al insertar tu agente, como en el siguiente ejemplo donde se llama a justo antes de donde se llama a (debes reemplazar por tu identificación):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));