Compartir por

Trabajar con variables

Puede usar variables para almacenar las respuestas de los clientes y reutilizar su contenido más adelante en la conversación.

También puede usar variables para crear expresiones lógicas que dirijan dinámicamente al cliente por diferentes rutas de conversación. Por ejemplo, guarde el nombre de un cliente en una variable llamada "customerName" y el agente puede dirigirse al cliente por su nombre mientras continúa la conversación.

Las variables también se pueden pasar y devolver desde otros temas y flujos de Power Automate.

Crear una variable

Cualquier nodo que devuelva una salida, como un nodo Pregunta , crea automáticamente una variable de salida del tipo adecuado.

Captura de pantalla de un nodo Pregunta, con el nombre predeterminado y el tipo de la variable resaltada.

Sugerencia

Cambie el nombre de los nodos para que sea más fácil identificarlos. Seleccione el campo de nombre del nodo para actualizar el nombre directamente, o seleccione el icono Más (…) del nodo y seleccione Renombrar desde el menú. También puede renombrar nodos en el editor de código.

No es posible cambiar el nombre de los nodos Gatillo y nodos Ir al paso.

Los nombres de nodo pueden tener hasta 500 caracteres de largo.

Seleccionar la entidad que se va a usar

De forma predeterminada, se crean nodos de pregunta con opciones de selección múltiple. Para usar otra entidad precompilada o personalizada, seleccione el cuadro Identificar y, a continuación, seleccione el tipo de información deseado.

Captura de pantalla de un nodo Pregunta con el panel

Cambiar el nombre de una variable

A las variables se les asigna un nombre automáticamente al crearse. Un procedimiento recomendado consiste en asignar nombres significativos a las variables para que su propósito sea claro para cualquier persona que deba mantener el agente.

  1. Seleccione la variable . Aparece el panel de Propiedades de variables.

  2. En Nombre de variable, escriba el nombre deseado para la variable.

Establecer una variable

Normalmente, se utiliza un nodo Pregunta para almacenar la entrada del usuario en una variable. Sin embargo, puede haber situaciones en las que quiera establecer el valor de una variable usted mismo. En esos casos, use un nodo Establecer valor variable.

  1. Seleccione el icono Agregar nodo en el nodo después del cual desea agregar un nodo Establecer valor de variable .

  2. Seleccione Administración de>variables Establecer un valor de variable. Aparece un nodo Establecer valor de variable en el lienzo.

  3. Seleccione el cuadro bajo Establecer variable y luego Crear una nueva variable. Se crea una nueva variable. Su tipo es desconocido hasta que le asigna un valor.

    Captura de pantalla de un nodo

  4. Para Hasta valor, asigne un valor usando una de las siguientes opciones:

    • Escriba un valor literal.
    • Seleccione una variable existente del mismo tipo.
    • Use una fórmula de Power Fx. Las fórmulas de Power Fx son útiles para tipos más complejos, donde no se pueden usar valores literales, como los tipos Tabla y Registro.

Uso de variables en nodos de acción

Cuando se usa una variable en un nodo Action , si su tipo base coincide con un tipo de parámetro especificado para un flujo o para una aptitud de Bot Framework, puede alimentarlo a ese parámetro. La salida de los nodos Action genera nuevas variables.

Para obtener más contexto, consulte los escenarios de ejemplo en Llamada a un flujo de agente desde un tema y Uso de variables de entrada y salida para pasar información.

Usar valores literales para entradas variables

En los nodos en los que puede establecer un valor para los parámetros de entrada, siempre puede introducir un valor literal en lugar de seleccionar otra variable como valor.

Captura de pantalla que muestra el uso de un valor literal para un parámetro de entrada de variable denominado productName

El nodo intenta interpretar valores literales como una cadena, un número o un valor booleano. Por ejemplo, 123 se interpreta como un número. Si desea que se interprete como un valor de cadena, puede envolver el valor entre comillas dobles, como: "123".

Para algunos escenarios (por ejemplo, escenarios que usan tipos complejos), es posible que deba usar una fórmula de Power Fx para establecer un tipo específico.

Usar variables de entorno para secretos de Azure Key Vault

Una variable de entorno puede hacer referencia a un secreto en Key Vault. Las variables de entorno secretas son un caso especial de variables de entorno con consideraciones únicas.

Para crear una variable de entorno secreta en el portal de Power Apps, debe configurar su Key Vault.

Para autorizar a Copilot Studio para que lea este Key Vault, debe realizar las siguientes acciones:

  1. Asigne el rol de Usuario de Secretos de Key Vault a la aplicación Microsoft Copilot Studio Service.

  2. Para autorizar a todos los agentes del entorno para acceder al secreto, cree una etiqueta AllowedEnvironments en el secreto y agregue los identificadores de entorno permitidos separados por comas.

  3. Para autorizar solo a determinados agentes del entorno a utilizar esta Key Vault, cree una etiqueta AllowedAgents y ponga el identificador del agente en el formato {envId}/{schemaName}. Para valores múltiples, separe los valores con comas.

    Si alcanza el número máximo de caracteres pero aún necesita agregar más agentes, agregue otra etiqueta con un nombre descriptivo pero único (por ejemplo: AllowedAgents2).

El valor secreto se almacena en caché en el tiempo de ejecución del diálogo durante cinco minutos. Las lecturas erróneas se almacenan en caché durante 30 segundos.

Advertencia

Al agregar el secreto al agente, podría exponer el valor de dicho secreto. Cualquier persona que pueda editar el agente en el entorno podría agregar un nodo Message y devolver el valor de las variables de entorno secretas en un mensaje.

Panel de variables

El panel Variables es donde puede ver todas las variables que están disponibles para un tema, independientemente de los nodos en los que estén definidas o se utilicen. Para cada variable, puede seleccionar si puede recibir su valor de otros temas, devolver su valor a otros temas o ambos. También puede seleccionar una variable para editar sus propiedades en el panel Propiedades de variable.

Para abrir el panel Variables , seleccione Variables en la barra de menús del tema.

Captura de pantalla del panel Variables, con el botón Variables resaltado.

Panel de propiedades de variables

En el panel Propiedades de variable, puede cambiar el nombre de una variable, ver dónde lo usa el agente o convertirlo a una variable global. Sin embargo, no puede volver a convertir una variable global en una variable de tema. También puede seleccionar si una variable de tema puede recibir valores de otros temas o pasar su valor a ellos.

Para abrir el panel Propiedades de variable de una variable, seleccione la variable deseada en el panel Variables. También puede abrir el panel Propiedades de variables desde cualquier nodo que use variables; para ello, seleccione la variable deseada.

Pasar variables entre temas

Al redirigir un tema a otro, puede pasar los valores de las variables del tema de origen al tema de destino y también devolver valores del tema de destino al tema de origen. Pasar variables entre temas es especialmente útil cuando un tema anterior ya recopiló información que un tema posterior necesita. Sin duda, los usuarios aprecian que no tienen que responder a las mismas preguntas más de una vez.

Recibir valores de otros temas

Cuando un tema define una variable (por ejemplo, en un nodo de pregunta), el agente formula al usuario la pregunta para completar el valor de la variable. Si el agente ya ha adquirido el valor en un tema anterior, no hay razón para volver a hacer la pregunta. En estos casos, puede establecer la variable como Recibir valores de otros temas. Cuando otro tema redirige a este, puede pasar el valor de una variable o valores literales a esta variable y omitir la pregunta. La experiencia del usuario que habla con el agente es perfecta.

En este ejemplo, usamos dos temas, Saludo y Hablar con el cliente. Ambos temas piden el nombre del cliente. Sin embargo, si el tema Saludo se ejecuta primero, el tema Hablar con el cliente omite su pregunta. En su lugar, utiliza el valor de la variable pasada desde el tema Saludo.

Este es el flujo del tema Conversación con el cliente:

Captura de pantalla del flujo de la conversación del tema Hablar con el cliente.

Como se muestra en el panel prueba, si este tema se desencadena primero, pregunta al usuario: "¿Cómo debo llamarle?" Almacena el valor en una variable de cadena llamada customerName. La variable customerName también está configurada para obtener su valor de otros temas. El tema concluye con el mensaje: "¡Espero que esté teniendo un día maravilloso, customerName!"

Este es el flujo del tema de saludo:

Captura de pantalla del flujo de la conversación del tema Saludar.

Como se muestra en el panel prueba, si este tema se desencadena primero, pregunta al usuario: "¿Cómo se llama?" almacena el valor en una variable de cadena llamada customerName. El tema envía el mensaje: "¡Encantado de conocerle, customerName!" A continuación, redirige al tema Hablar al Cliente , que envía el mensaje: "¡Espero que esté teniendo un día maravilloso, customerName!". Sin embargo, tenga en cuenta que el tema Hablar al Cliente omitió volver a solicitar el nombre del usuario. En su lugar, utiliza el valor de la variable customerName pasada desde el tema Saludo.

Finalmente, aquí está esa segunda conversación nuevamente, esta vez desde la perspectiva del tema Hablar al cliente:

Captura de pantalla del flujo de conversación Hablar con el cliente cuando se activa primero el tema Saludar.

Veamos los pasos para configurar un tema para recibir valores de otros temas. Nuestro escenario de ejemplo usa el tema predefinido Saludo como tema de origen y un nuevo tema Hablar al Cliente como tema de destino, pero los mismos pasos funcionan para cualquier tema que deba usar un valor de un tema anterior cuando sea posible.

Configure el destino tema

El tema de destino es el tema al que se redirige, el que recibe valores de otros temas. En nuestro ejemplo, es Hablar con el cliente.

  1. Cree un nuevo tema y llámelo "Hablar al Cliente".

  2. Añada frases desencadenadoras como "hábleme", "hable conmigo", "chatea conmigo".

  3. Agregue un nodo Pregunta y escriba "¿Cómo le puedo llamar?" para el mensaje.

  4. En Identificar, seleccione la entidad preconstruida Nombre de la persona.

  5. Seleccione el nombre de la variable. El panel Propiedades de variables se abre.

  6. Reemplace el nombre predeterminado por "customerName" y, a continuación, seleccione Recibir valores de otros temas.

    Captura de pantalla del panel

  7. Agregue un nodo Mensaje.

  8. En el cuadro de mensaje, escriba "Espero que esté teniendo un día maravilloso, ".

  9. Seleccione el icono Insertar variable ({x}) y después seleccione customerName.

  10. Seleccione el espacio después de la variable y escriba "!".

  11. Guarde el tema.

Establecer el tema de origen

El tema de origen es el tema que realiza la redirección, el que proporciona el valor y lo pasa al tema de destino. En nuestro ejemplo, es Saludo.

  1. Vaya al tema Saludo y elimine los nodos predeterminados, excepto el nodo Desencadenador.

  2. Agregue un nodo Pregunta y escriba "¿Cómo se llama?" para el mensaje.

  3. En Identificar, seleccione la entidad preconstruida Nombre de la persona.

  4. Reemplace el nombre predeterminado por "customerNameFromGreeting".

  5. Agregue un nodo Mensaje.

  6. En el cuadro de mensaje, escriba "Encantado de conocerle, ".

  7. Seleccione el icono Insertar variable ({x}) y después seleccione customerNameFromGreeting.

  8. Seleccione el espacio después de la variable y escriba "!".

  9. Agregue un nodo Redireccionamiento y seleccione el tema de destino Hablar con el cliente.

  10. Seleccione Agregar entrada y luego seleccione la variable del tema de destino al que desea pasar el valor.

    Captura de pantalla del tema Saludo con la variable customerName agregada como entrada en un nodo de redireccionamiento.

  11. Seleccione el icono > y, a continuación, seleccione la variable cuyo valor desea pasar, customerNameFromGreeting, en este ejemplo.

    El nodo de Redireccionamiento debería tener el siguiente aspecto:

    Captura de pantalla del nodo Redireccionamiento completado en el tema Saludo.

  12. Guarde el tema.

Devolver valores a temas originales

En un agente, un tema está diseñado para recopilar información específica. Varios otros temas pueden llamarlo y esperar que devuelvan la información como una variable. La variable se convierte en parte del tema de origen y se puede usar como cualquier otra variable. Información que obtiene el agente y que por tanto está disponible en todos los temas, lo que reduce la necesidad de variables globales.

Continuemos con el ejemplo de la sección anterior. Hacemos una nueva pregunta en el tema Hablar con el cliente y, a continuación, devolvemos la respuesta al tema Saludo.

Configure la fuente tema para una variable devuelta

Cuando retorna una variable a un tema, el tema de origen es el tema que proporciona el valor para retornar al tema original. En este ejemplo, el tema de origen es Hablar con el cliente.

  1. Vaya al tema de origen.

  2. Agregue un nodo Pregunta y escriba "¿En qué ciudad vive?" para el mensaje.

  3. En Identificar, seleccione la entidad preconstruida Ciudad.

  4. Seleccione la variable para abrirla en el panel Propiedades de variable. Asígnele el nombre "customerCity" y, a continuación, seleccione Retornar valores a los temas originales.

    Captura de pantalla del tema Hablar con el cliente con la variable customerCity y sus propiedades resaltadas.

  5. Agregue un nodo Mensaje.

  6. Seleccione el icono Insertar variable ({x}) y después seleccione customerCity.

  7. Después de la variable en el cuadro de mensaje, escriba "¡En esta época del año tiene que ser una maravilla!".

  8. Guarde el tema.

Configurar el tema de destino para una variable devuelta

Cuando devuelve una variable a un tema, el tema de destino es el tema que recibe valores del tema actual. En nuestro ejemplo, el tema de destino es Saludo.

  1. Vaya al tema de destino.

  2. La variable que seleccionó en el tema de origen debería aparecer en el nodo Redireccionamiento como variable de salida.

    Captura de pantalla del flujo de conversación del tema Saludar con una variable devuelta en un nodo Redirigir.

  3. Guarde el tema.

Análisis de valores

El nodo Analizar valor le permite convertir un valor de un tipo en un valor de otro tipo. Un uso habitual para el nodo Analizar valor es convertir JSON crudo. Por ejemplo, un agente llama a un flujo, que a su vez llama a una API. La API devuelve un resultado. Ahora necesita una manera de analizar este resultado y devolver una o varias variables primitivas. Con el nodo Analizar valor , puede enviar todo el resultado de la API como una cadena, como la siguiente:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

El nodo Analizar valor puede convertir la variable de cadena que tiene ahora en una variable de tipo Record, para la que el editor de Power Fx proporciona sugerencias y finalización de código de IntelliSense.

Además de analizar cadenas JSON, un uso clave del nodo Analizar valor es analizar objetos sin tipo en tiempo de ejecución. El caso de uso más común es cuando recibe un evento y necesita analizar el valor del evento. O podría querer analizar la propiedad System.Activity.ChannelData, que varía durante la ejecución según el canal.

Si necesita analizar información de un evento procedente de Teams, consulte la documentación para desarrolladores de Teams para encontrar un ejemplo del aspecto que podría tener el evento esperado. A continuación, puede seguir las instrucciones de esta sección utilizando el evento de ejemplo como datos de muestra.

Para agregar un nodo Analizar valor a un tema:

  1. Seleccione el icono Agregar nodo en el nodo después del cual desea analizar un valor, seleccione Administración de variables y seleccione Analizar valor.

  2. Agregue un nodo Analizar valor y seleccione la variable que desea analizar.

    Captura de pantalla que muestra la selección de la variable a analizar.

  3. Seleccione el tipo de datos. En este caso, elija De datos de muestra.

    Captura de pantalla que muestra la selección del tipo de datos para un nodo Analizar valor.

  4. Seleccione Obtener esquema desde el JSON de ejemplo, escriba el ejemplo JSON deseado en el editor que se abre y seleccione Confirmar.

    Captura de pantalla que muestra el editor donde se escriben datos JSON de ejemplo.

  5. Por último, seleccione la variable para contener el valor analizado. Normalmente, se crearía una nueva variable.

    Captura de pantalla que muestra cómo crear una variable para contener un valor analizado directamente desde el nodo Analizar valor.

    La variable de salida ahora tiene el tipo esperado: record.

    Captura de pantalla que muestra que la variable que contiene los datos analizados tiene el tipo esperado: registro.

Contenido relacionado

  • Last updated on