Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Utilice variables para almacenar las respuestas de los clientes y así poder reutilizarlas 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.
Puede pasar variables y devolverlas desde otros temas y flujos de Power Automate.
Crear una variable
Cualquier nodo que devuelva una salida, como un nodo de Pregunta, crea automáticamente una variable de salida del tipo correspondiente.
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 los tres puntos (…) del nodo y seleccione Cambiar nombre en 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
Los nodos de pregunta usan opciones de selección múltiple de forma predeterminada. Para usar una entidad precompilada o personalizada diferente, seleccione el cuadro "Identificar" y luego seleccione el tipo de información que desee.
Cambiar el nombre de una variable
Para facilitar el mantenimiento de tus agentes, reemplaza el nombre predeterminado de cada variable por un nombre significativo.
Seleccione la variable . Aparece el panel de Propiedades de variables.
En Nombre de variable, ingrese el nombre que desea asignar a su variable.
Establecer una variable
Normalmente, se utiliza un nodo Pregunta para almacenar la entrada del usuario en una variable. Sin embargo, conviene que usted mismo establezca el valor de una variable. En esos casos, use un nodo Establecer valor variable.
Seleccione el icono Agregar nodo
situado debajo del nodo tras el cual desea agregar un nodo Establecer valor de variable.Seleccione Administración de variables>Establecer un valor de variable. En el lienzo aparece un nodo Establecer valor de variable.
Seleccione el cuadro bajo Establecer variable. Aparece el panel Seleccionar una variable.
Si la variable que desea establecer ya existe, selecciónela.
De lo contrario, seleccione Crear nuevo. Esta acción crea una nueva variable. Su tipo es desconocido hasta que le asigna un valor.
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.
Usar variables en nodos de acción
Cuando usa una variable en un nodo Acción, si su tipo base coincide con un tipo de parámetro que se especifica para un flujo o para una capacidad de Bot Framework, puede alimentarlo a ese parámetro. La salida de los nodos Acción genera nuevas variables.
Más información en:
Usar valores literales para entradas variables
En un nodo en el que puede establecer un valor para los parámetros de entrada, puede introducir un valor literal en lugar de seleccionar otra variable como valor.
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 el nodo interprete el valor como 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 Power Apps, debe configurar un almacén de Key Vault.
Para autorizar a Copilot Studio para que lea este Key Vault, realice las siguientes acciones:
Asigna el rol Key Vault Secrets User a la aplicación Microsoft Copilot Studio Service.
Para autorizar a todos los agentes del entorno a acceder al secreto, crea una etiqueta
AllowedEnvironmentsen el secreto y agrega los IDs de entorno permitidos separados por comas.Para autorizar solo a determinados agentes del entorno a utilizar este almacén, cree una etiqueta
AllowedAgentsy 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 tiempo de ejecución del diálogo almacena en caché el valor secreto durante cinco minutos. Almacena en caché las lecturas erróneas durante 30 segundos.
Advertencia
Al agregar el secreto al agente, podría exponer el valor de dicho secreto. Cualquiera 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 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 abrir el panel Variables, seleccione Variables en la barra de menú del tema.
Para cada variable del tema, 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.
Panel de propiedades de variables
En el panel Propiedades de variable, puede cambiar el nombre de una variable, ver dónde la usa su agente o convertirla en una variable global. 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 de Propiedades de variable desde cualquier nodo que utilice variables, seleccionando 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. Sus usuarios sin duda aprecian no tener que responder 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.
Este ejemplo usa 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:
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:
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:
Veamos los pasos para configurar un tema para recibir valores de otros temas. Este 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 recibe valores de otros temas. En este ejemplo, es Hable con el cliente.
Cree un nuevo tema y llámelo "Hablar al Cliente".
Añada frases desencadenadoras como "hábleme", "hable conmigo" y "chatea conmigo".
Agregue un nodo Pregunta y escriba "¿Cómo le puedo llamar?" para el mensaje.
En Identificar, seleccione la entidad preconstruida Nombre de la persona.
Seleccione el nombre de la variable. El panel Propiedades de variables se abre.
Reemplace el nombre predeterminado por
customerNamey, a continuación, seleccione Recibir valores de otros temas.
Agregue un nodo Mensaje.
En el cuadro de mensaje, escriba "Espero que esté teniendo un día maravilloso, ".
Seleccione el icono Insertar variable ({x}) y después seleccione customerName.
Seleccione el espacio después de la variable e introduzca un signo de exclamación (!).
Guarde el tema.
Establecer el tema de origen
El tema de origen es el que redirige a otro tema. Proporciona el valor y lo pasa al tema de destino. En este ejemplo, es Saludo.
Vaya al tema Saludo y elimine los nodos predeterminados, excepto el nodo Desencadenador.
Agregue un nodo Pregunta y escriba "¿Cómo se llama?" para el mensaje.
En Identificar, seleccione la entidad preconstruida Nombre de la persona.
Reemplace el nombre predeterminado por
customerNameFromGreeting.Agregue un nodo Mensaje.
En el cuadro de mensaje, escriba "Encantado de conocerle, ".
Seleccione el icono Insertar variable ({x}) y después seleccione customerNameFromGreeting.
Seleccione el espacio después de la variable e introduzca un signo de exclamación (!).
Agregue un nodo Redireccionamiento y seleccione el tema de destino Hablar con el cliente.
Seleccione Agregar entrada y luego seleccione la variable del tema de destino al que desea pasar el valor.
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:
Guarde el tema.
Devolver valores a temas originales
En un agente, un tema recopila información específica. Varios otros temas pueden llamarlo y esperar que devuelvan la información como una variable. La variable también pasa a formar parte del tema original y se puede utilizar como cualquier otra variable. Al proporcionar la información que obtiene el agente a todos los temas, este enfoque reduce la necesidad de variables globales.
Continuemos con el ejemplo de la sección anterior. Formule una nueva pregunta en el tema Hablar con el cliente y, a continuación, devuelva la respuesta al tema Saludo.
Configure la fuente tema para una variable devuelta
Cuando devuelve 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.
Vaya al tema de origen.
Agregue un nodo Pregunta y escriba "¿En qué ciudad vive?" para el mensaje.
En Identificar, seleccione la entidad preconstruida Ciudad.
Seleccione la variable para abrirla en el panel Propiedades de variable. Asígnele el nombre
customerCityy luego seleccione Devolver valores a los temas originales.
Agregue un nodo Mensaje.
Seleccione el icono Insertar variable ({x}) y después seleccione customerCity.
Después de la variable en el cuadro de mensaje, escriba "¡En esta época del año tiene que ser una maravilla!".
Guarde el tema.
Configurar el tema de destino para una variable devuelta
Cuando devuelve una variable a un tema, el tema de destino recibe valores del tema actual. En el ejemplo siguiente, el tema de destino es Saludo.
Vaya al tema de destino.
La variable que seleccionó en el tema de origen aparece en el nodo Redireccionamiento como variable de salida.
Guarde el tema.
Analizar valores
El nodo Analizar valor +convierte un valor de un tipo a otro. Un caso de uso común para el nodo Analizar valor es convertir JSON sin formato. Por ejemplo, un agente llama a un flujo que llama a una API. La API devuelve un resultado. Necesita una forma de analizar este resultado y devolver una o varias variables primitivas. Al usar el nodo Analizar valor, puede enviar el resultado completo de la API como una cadena, como el siguiente:
{
"Name": "Parker",
"Position": "Product manager",
"Company": "Contoso",
"FormerPositions": [{
"Position": "Customer service representative"
}
]
}
El nodo Analizar valor convierte la variable de cadena en una variable de tipo Registro. El editor de Power Fx proporciona finalización de código de IntelliSense y sugerencias para este tipo.
Además de analizar las 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 bien, es posible que desee analizar la System.Activity.ChannelData propiedad, que varía en tiempo de 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 de cómo se espera que sea el evento. 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:
Seleccione el icono Agregar nodo
situado debajo del nodo bajo tras el que desea analizar un valor. Apunte a Administración de variables y seleccione Analizar valor.Agregue un nodo Analizar valor y seleccione la variable que desea analizar.
Para el tipo de datos, seleccione A partir de datos de muestra.
Seleccione Obtener esquema de JSON de muestra, escriba el ejemplo de JSON deseado en el editor que se abre y seleccione Confirmar.
Selecciona la variable que almacenará el valor parseado. Normalmente, se crea una nueva variable.
La variable de salida ahora tiene el tipo esperado: registro.
