Reutilizar variables en temas
De forma predeterminada, el valor de una variable solo se puede usar en el tema en el que se crea la variable. Por ejemplo, si crea una variable UserCity en un tema Comprobar el tiempo, solo podrá incluirla en elementos como nodos de mensajes dentro del tema Comprobar el tiempo. Este tipo de variables se denominan variables de tema (ámbito limitado). Sin embargo, puede haber situaciones en las que le interesará utilizar el mismo valor en varios temas. Los copilotos pueden recordar el contexto de una variable cuando una conversación abarca varios temas. Por ejemplo, un tema Bienvenido podría solicitar el nombre y la dirección de correo electrónico del cliente. Cuando la conversación pasa a otro tema, como Reserva de citas, es posible que desee que el copiloto recuerde el nombre y la dirección de correo electrónico del cliente. En Microsoft Copilot Studio, estas variables se conocen como variables del copiloto. Cualquier tema del copiloto puede acceder a ellas.
Las variables del copiloto se aplican durante la sesión de chat actual. No se pueden transferir de una sesión de chat de cliente a otra. Puede especificar qué variables deben tratarse como variables de copiloto, para distinguirlas de las variables en el nivel de tema.
Crear una variable de copiloto
Para definir una variable como variable del copiloto, ábrala en el lienzo de creación. Abra el nodo Formular una pregunta que almacena la variable con la que desea trabajar. En el panel Propiedades de variable, en Uso, seleccione Copilot (cualquier tema puede acceder). Se dará una cadena de prefijo de copiloto al nombre de la variable para diferenciarlo de las variables en el nivel de tema.
Por ejemplo, la variable UserName ahora aparece como bot.UserName. Cuando convierta una variable en una variable de copiloto, asegúrese de que el nombre de la variable sea único en todos los temas. Si hay un conflicto de nombres, deberá cambiar el nombre de la variable antes de guardar su cambio.
Para obtener más información, consulte Usar variables globales en todos los temas de un copiloto.
Establecer variables de copiloto
Después de crear una variable de copiloto, estará disponible para todos los temas. Al trabajar con un nodo de mensaje o pregunta, seleccione el botón {x}. Esto mostrará una lista de todas las variables disponibles en este tema. Las variables están ordenadas por orden alfabético, así que verá que todas las variables del copiloto están agrupadas en el menú de variables, ya que todas comienzan por la palabra copiloto.
Al utilizar un nodo de condición, un nodo de acción de flujo o un nodo de capacidad, también podrá ver las variables del copiloto disponibles allí.
Administrar variables de copiloto
Después de crear una variable de copiloto que pueda usar en varios temas, debería entender dónde se usa. Puede ver fácilmente dónde se definió la variable por primera vez (Origen) y los otros temas que la utilizan. Esto puede resultar útil si trabaja en un nuevo copiloto o si tiene varias variables y bifurcaciones de temas complejos.
Existen dos elementos primarios disponibles en el panel Propiedades de variable.
Ir al origen: va al nodo donde se creó inicialmente la variable.
Usado por: muestra todos los temas en los que se usa la variable, para que pueda ir directamente a ese tema y nodo.
Establecer el valor de una variable de copiloto desde orígenes externos
Puede configurar una variable de copiloto para que se inicialice con un origen externo. Esto permite al copiloto iniciar la conversación con algo de contexto.
Por ejemplo, un cliente abre un chat desde su sitio web. Si el usuario ha iniciado sesión en su sitio web, usted ya sabrá el nombre del cliente. Al pasar esa información al copiloto antes de iniciar la conversación, puede tener una conversación más inteligente con el cliente sin tener que volver a preguntarle su nombre.
Puede especificar que una variable pueda obtener sus valores de un origen externo. Abra el panel Propiedades de variables y, en la sección Uso, seleccione el cuadro Los orígenes externos pueden establecer valores.
Para obtener más información sobre el trabajo con variables de copiloto, consulte Reutilizar variables en todos los temas.