Compartir a través de

Información general de las variables

Las variables existen en cuatro niveles o ámbitos:

  • Las variables de tema solo se pueden usar en los temas en los que se crean. Este es el ámbito predeterminado para las variables que crea.
  • Variables globales que se pueden usar en todos los temas. Puede cambiar el alcance de una variable de tema para convertirla en una variable global.
  • Las variables del sistema Copilot Studio se crean automáticamente para un agente. Proporcionan más información contextual sobre la conversación o el usuario. Están disponibles en todos los temas.
  • Variables de entorno que se crean en Power Platform. Son de solo lectura en Copilot Studio. Almacenan las claves y los valores de los parámetros, que pueden servir como entrada para otros diversos objetos de la aplicación, incluyendo Copilot Studio. Separar los parámetros de los objetos consumidores le permite cambiar los valores dentro del mismo entorno o cuando migra soluciones a otros entornos. La alternativa es dejar valores de parámetros codificados de forma rígida dentro de los componentes que los utilizan.

Tipos de variables

Cada variable tiene un tipo base. El tipo determina los valores que la variable puede contener y los operadores que puede usar cuando crea una expresión lógica con ella.

Tipo Descripción
Cadena Una secuencia de caracteres utilizados para representar texto
Booleana Un valor lógico que sólo puede ser true o false
Número Cualquier número real
Tabla Una lista de valores, pero todos los valores deben ser del mismo tipo
Grabar Una colección de pares de nombre y valor donde los valores pueden ser de cualquier tipo
Fecha y hora Una fecha, hora, día de la semana o mes relativo a un punto en el tiempo
Opción Una lista de valores de cadena con sinónimos asociados
Vacío Un marcador de posición para "sin valor" o "valor desconocido"; para obtener más información, consulte Vacío en la documentación de Power Fx

El tipo de variable se establece la primera vez que se le asigna un valor. Después de eso, el tipo se fija y no se pueden asignar valores de ningún otro tipo. Por ejemplo, si asigna el valor 1 inicial a una variable, establezca su tipo en Number. Si, a continuación, intenta asignar un valor de tipo Cadena como "apples", se produce un error.

Al probar un agente, puede aparecer temporalmente una variable con el tipo desconocido. Una variable desconocida aún no tiene un valor.

El orden de las variables se determina de arriba a abajo del lienzo de creación. Los nodos de la parte superior del lienzo de creación se consideran antes que los nodos de la parte inferior.

Cuando crea ramas con nodos de condición, las ramas se ordenan de izquierda a derecha. Los nodos de la rama situada más a la izquierda se consideran antes que los nodos de la rama situada más a la derecha.

Entidades

Copilot Studio usa entidades para identificar un tipo específico de información de las respuestas de un usuario. La información identificada se guarda en una variable del tipo apropiado para la información. En la tabla siguiente se muestra el tipo base de variable asociado a las entidades precompiladas.

Entidad Tipo base de variable
Opciones de elección múltiple Opción
Respuesta completa del usuario Cadena
Edad Número
Booleana Booleana
Ciudad Cadena
Color Cadena
Continente Cadena
País o región Cadena
Fecha y hora Fecha y hora
Correo electrónico Cadena
Evento Cadena
Entero Número entero
Lenguaje Cadena
Dinero Número
Número Número
Ordinal Número
Organización Cadena
Porcentaje Número
Nombre de la persona Cadena
N.º de teléfono Cadena
Punto de interés Cadena
Velocidad Número
Valor Cadena
Dirección postal Cadena
Temperatura Número
Dirección URL Cadena
Grosor Número
Código postal Cadena
Entidad personalizada Opción

Variables de entorno

Las variables de entorno son un concepto de Power Platform. Las variables de entorno habilitan el escenario básico de administración del ciclo de vida de la aplicación (ALM) de mover una aplicación entre entornos de Power Platform. En este escenario, la aplicación se mantiene exactamente igual salvo por unas pocas referencias externas clave que son diferentes entre el entorno de origen y el de destino.

Utilice variables de entorno de la misma forma que las variables de Tema, Global y Sistema. Una diferencia notable es que las variables de entorno son de solo lectura en Copilot Studio. Los autores de agentes no pueden modificar las variables de entorno en Copilot Studio. Sin embargo, los administradores pueden cambiar el valor de las variables de entorno en Power Apps. En Copilot Studio, puede utilizar el panel Variables para ver información sobre una variable de entorno. El panel Propiedades de variables también tiene un vínculo a Power Apps, la experiencia de creación de variables de entorno.

La versión publicada de un agente que utiliza variables de entorno tiene los valores que se establecen para estas variables cuando se publica el agente. Cada vez que un administrador actualiza variables de entorno, debe volver a publicar los agentes que utilizan estas variables para que los cambios sean efectivos en tiempo de ejecución. Sin embargo, hay una excepción: no es necesario volver a publicar los agentes cuando cambia el valor de una variable de entorno de tipo secreto. A diferencia de otras variables de entorno, las variables secretas se recuperan en tiempo de ejecución.

Los tipos de variables de entorno en Copilot Studio se asignan a tipos de datos Power Apps de la siguiente manera:

Tipo en Copilot Studio Tipo en Power Apps
Número decimal Número
JSON Detectar el tipo a partir del valor. Si no es JSON=> No especificado (error de validación)
Texto Cadena
Sí/No Booleana
Origen de datos Cadena
Secreto Cadena

Nota

Los errores de las variables de entorno son visibles en el chat de Prueba y al publicar. Sin embargo, estos errores no se muestran en la lista de Temas porque no son variables de tema.

Variables del sistema

Cada agente viene con variables de sistema integradas que proporcionan información adicional sobre una conversación.

Captura de pantalla de variables del sistema en un tema de agente

Nota

Para obtener más información sobre las variables agente habilitadas para voz, consulte Uso de variables de voz.

Copilot Studio no muestra todas las variables del sistema. Para acceder a las variables ocultas del sistema, use una fórmula Power Fx.

Para usar variables del sistema en una fórmula Power Fx, agregue System. antes del nombre de la variable. Por ejemplo, para incluir la variable del sistema User.DisplayName en una fórmula, haga referencia a ella como System.User.DisplayName.

Nombre Tipo Definición
Activity.Attachments tabla Los archivos adjuntos que proporciona el usuario.
Canal de actividades opción El ID de canal de la conversación actual.
Activity.ChannelData cualquiera Un objeto que contiene contenido específico del canal.
Activity.ChannelId cadena El ID de canal de la conversación actual, como cadena.
Activity.From.Id cadena El ID único específico del canal para el remitente.
Activity.From.Name cadena El nombre descriptivo del remitente específico del canal.
Activity.Name cadena Nombre del evento.
Activity.Recipient.Id cadena Tipo de propiedad de la actividad entrante.
Activity.Recipient.Name cadena Representa el nombre para mostrar del agente dentro del canal. En el contexto del canal de telefonía, el valor de esta variable será el número de teléfono al que está asociado el agente.
Activity.Text cadena El mensaje más reciente enviado por el usuario.
Activity.Type opción Tipo de actividad.
Activity.TypeId cadena Tipo de actividad, como una cadena.
Activity.Value cualquiera Valor con extremo abierto.
Bot.EnvironmentId cadena El Id. del entorno del agente.
Bot.Id cadena Id. del agente.
Bot.Name cadena El nombre del agente.
Bot.SchemaName cadena El nombre del esquema del agente.
Bot.TenantId cadena El id. de inquilino del agente.
ClientPluginActions opción Colección de acciones de complemento de cliente dinámico que se deben tener en cuenta para la orquestación generativa.
Conversation.Id cadena El id. exclusivo de la conversación actual.
Conversation.InTestMode Booleana Bandera booleana que representa si la conversación está sucediendo en el lienzo de prueba.
Conversation.LocalTimeZone cadena Nombre de la zona horaria que utilizará el usuario en el formato de la base de datos de zonas horarias de IANA.
Conversation.LocalTimeZoneOffset datetime La diferencia horaria con respecto a UTC para la zona horaria local actual.
Error.Code cadena El código del error actual.
El mensaje de error del error actual.
Error.Message cadena El mensaje de error del error actual.
Nota: Esta variable solo se admite si el desencadenador es On Error.
FallbackCount Número Esta variable cuenta las veces que un tema no pudo coincidir con la entrada del usuario.
Nota: Esta variable solo se admite si el desencadenador es On Unknown Intent.
InactivityTimer.Continue Booleana Bandera booleana que representa si el temporizador debe continuar.
Nota: Esta variable solo se admite si el desencadenador es Inactivity.
InactivityTimer.Count Número Número de veces que el temporizador OnInactivity se activó debido a la inactividad del usuario después del tiempo configurado.
Nota: Esta variable solo se admite si el desencadenador es Inactivity.
LastMessage.Id cadena El id. del mensaje anterior enviado por el usuario.
LastMessage.Text cadena El mensaje anterior enviado por el usuario.
Recognizer.ExtractedEntities opción Representa las entidades extraídas del mensaje desencadenante.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
Recognizer.IntentOptions opción Representa las opciones de intención cuando el reconocedor devuelve resultados ambiguos.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
Recognizer.SelectedIntent opción Representa la intención seleccionada del reconocedor.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
Recognizer.TriggeringMessage.Id cadena El id. del mensaje de usuario que activó el tema actual.
Recognizer.TriggeringMessage.Text cadena El mensaje de usuario que activó el tema actual.
Recognizer.MultipleTopicsMatchedReason cadena Se utiliza para determinar por qué coincidieron varios temas.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
SignInReason opción Se utiliza para determinar qué opción de inicio de sesión se necesita cuando se activa tema.
Nota: Esta variable solo se admite si el desencadenador es On Sign In.
User.Language opción Esta variable se utiliza para establecer la configuración regional del idioma del usuario por conversación.

Variables para autenticación integrada (predeterminado)

Las siguientes variables están disponibles para agentes configurados para autenticarse con Microsoft. Esta configuración utiliza la autenticación Microsoft Entra ID y es la predeterminada para los nuevos agentes.

Para obtener más información, consulte Variables de autenticación.

Nombre Tipo Definición
User.DisplayName cadena El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Email cadena La dirección de correo electrónico del usuario que está hablando actualmente con el agente.
User.FirstName cadena El nombre de pila del usuario que está hablando actualmente con el agente.
User.Id cadena Id. único del usuario que está hablando actualmente con el agente.
User.IsLoggedIn Booleana Indicador booleano que representa si el usuario que está hablando actualmente con el agente está autenticado o no.
User.LastName cadena El nombre de familia del usuario que está hablando actualmente con el agente.
User.PrincipalName cadena El nombre principal de usuario del usuario que está hablando actualmente con el agente.

Variables para la autenticación manual con OAuth genérico 2

Las siguientes variables están disponibles para los agentes configurados para utilizar el proveedor de servicios genérico OAuth 2.

Nombre Tipo Definición
User.AccessToken cadena El token de acceso del usuario que se autentica con el agente.
User.DisplayName cadena El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Id cadena Id. único del usuario que está hablando actualmente con el agente.
User.IsLoggedIn Booleana Indicador booleano que representa si el usuario que está hablando actualmente con el agente está autenticado o no.

Variables para la autenticación manual con Microsoft Entra ID

Las siguientes variables están disponibles para los agentes configurados para utilizar los proveedores de servicios Microsoft Entra ID (anteriormente Azure Active Directory).

Nombre Tipo Definición
User.AccessToken cadena El token de acceso del usuario que se autentica con el agente.
User.DisplayName cadena El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Email cadena La dirección de correo electrónico del usuario que está hablando actualmente con el agente.
User.FirstName cadena El nombre de pila del usuario que está hablando actualmente con el agente.
User.Id cadena Id. único del usuario que está hablando actualmente con el agente.
User.IsLoggedIn Booleana Indicador booleano que representa si el usuario que está hablando actualmente con el agente está autenticado o no.
User.LastName cadena El nombre de familia del usuario que está hablando actualmente con el agente.
User.PrincipalName cadena El nombre principal del usuario que está hablando actualmente con el agente.

Variables para agentes habilitados por voz

Las siguientes variables solo están disponibles en agentes habilitados para voz.

Nota

Para obtener más información sobre las variables agente habilitadas para voz, consulte Uso de variables de voz.

Nombre Tipo Definición
Activity.InputDTMFKeys cadena El valor de clave DTMF sin procesar de telefonía.
Activity.SpeechRecognition.Confidence Número La puntuación de confianza para el resultado completo de la hipótesis del Azure Site Recovery, de 0 a 1.
Activity.SpeechRecognition.MinimallyFormattedText cadena Texto ligeramente formateado del resultado de la hipótesis de Azure Site Recovery. Por ejemplo, "Quinientos dólares". Las palabras se deletrean, pero se incluyen mayúsculas y signos de puntuación básicos.
Activity.UserInputType opción El tipo de la entrada más reciente del usuario del agente. El valor puede ser prueba, voz o DTMF.
Conversation.OnlyAllowDTMF Booleana Bandera booleana que representa si el IVR debe configurarse en modo solo DTMF en tiempo de ejecución.
Conversation.SipUuiHeaderValue cadena La cadena de encabezado UUI utilizada para pasar contexto a IVR al iniciar la llamada.
  • Last updated on