Trabajar con variables

Completado

Microsoft Copilot Studio le permite almacenar información importante introducida por el cliente para su uso posterior, mediante el uso de variables. Por ejemplo, puede guardar un nombre de cliente en una variable denominada UserName. Esta variable se puede insertar en nodos de conversación para crear una experiencia más personal para el cliente, como si se inserta en el nodo de mensaje, para permitir que el copiloto se dirija al cliente por su nombre mientras continúa la conversación.

Las variables se pueden utilizar para dirigir dinámicamente a los clientes por diferentes rutas de conversación. También pueden suministrarse a flujos de Power Automate o Capacidades de Bot Framework como parámetros de entrada. Por ejemplo, la ciudad en la que vive el cliente podría almacenarse en una variable. Cuando se ejecuta un flujo de Power Automate, la variable podría pasarse como parámetro de entrada para garantizar que el servicio meteorológico obtenga la previsión correcta.

Muchos tipos de variables están asociados con entidades personalizadas y listas para usar definidas en el copiloto. Para su referencia, está disponible una lista completa de tipos de entidad y variable.

Creación de variables

Las variables se crean automáticamente al agregar un nodo de pregunta a un tema. De forma predeterminada, cuando se inserta un nodo de pregunta, se creará utilizando opciones de Selección múltiple. Sin embargo, se puede utilizar cualquier entidad precompilada o personalizada si la selecciona en Identificar.

Captura de pantalla de la variable definida

Cambiar el nombre de una variable

Cuando una variable se crea automáticamente, se le dará un nombre predeterminado o algún otro, como var. No es descriptivo. Si lo desea, puede cambiar el nombre de una variable seleccionándola e introduciendo después un nombre nuevo. Esto hará que sea más fácil identificarla más adelante, cuando sea necesario.

Captura de pantalla del campo Nombre

Pasar variables entre temas

Una acción común en los copilotos de Microsoft Copilot Studio es redirigir de un tema a otro, como enviar a alguien al tema Horario de la tienda después de saludarle. Al redirigir a otro tema, puede pasar valores a variables en el tema de destino. También puede devolver valores a las variables en el tema original. Pasar variables entre temas es especialmente útil cuando ya tiene información que necesita el tema. Los usuarios agradecerán no tener que volver a responder a la pregunta. Por ejemplo, si ya ha capturado el nombre del usuario en el tema Saludo y sabe que el nombre de usuario se usará en el tema Horario de tienda al que se le está redirigiendo. Puede pasar fácilmente el nombre de usuario al tema Horario de tienda al redirigir al tema.

Recibir valores de otros temas

Al definir una variable en un tema (por ejemplo, al insertar un nodo de pregunta), la respuesta del usuario a las preguntas se rellena con la variable asociada con esa pregunta. Como ya tiene el valor, no hay motivo para volver a hacer la pregunta. En estos casos, puede definir la variable como Recibir valores de otros temas.

Captura de pantalla de los valores recibidos de la configuración de uso de otros temas

Esto significa que, cuando otro tema se redirige a este, puede pasar una variable a esta variable y omitir la pregunta. La experiencia del usuario que habla con el copiloto es perfecta.

Al configurar su nodo de redirección, deberá definir qué variable desea rellenar en el tema de destino. Después de especificar qué variable desea establecer en el tema de destino, deberá especificar qué valor se usará en el tema actual. Por ejemplo, en la imagen siguiente, estamos redirigiendo a un tema denominado Lista de restaurantes. La variable Área del tema Lista de restaurantes se establece en una variable de texto denominada Var para el tema redireccionador.

Captura de pantalla de la configuración de entrada de variable

Para obtener más información e instrucciones paso a paso sobre cómo recibir valores de otros temas, consulte Recibir valores de otros temas.

Devolver valores a los temas originales

Cuando un tema formula una pregunta u obtiene una variable de una acción de alguna otra manera, la variable puede devolverse al tema original que la redirigió a este.

En este caso, la variable también pasa a formar parte del tema original y se puede utilizar como cualquier otra variable. Esto le ayuda a construir el tema para que la información que obtiene el copiloto esté disponible en todos los temas, lo que reduce la necesidad de variables globales. Trataremos sobre las variables globales en la siguiente unidad.

Captura de pantalla de los valores devueltos a la selección de uso de temas originales

Para obtener más información sobre el particular e instrucciones paso a paso, consulte Devolver valores a los temas originales.

Para obtener más información sobre cómo trabajar con variables, consulte Usar variables.