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.
  • Copilot Studio crea automáticamente las variables del sistema 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. Solo se pueden leer 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 Description
String Una secuencia de caracteres utilizados para representar texto
Booleano Un valor lógico que sólo puede ser true o false
Number Cualquier número real
Tabla Una lista de valores, pero todos los valores deben ser del mismo tipo
Record Una colección de pares de nombre y valor donde los valores pueden ser de cualquier tipo
DateTime Una fecha, hora, día de la semana o mes relativo a un punto en el tiempo
Elección Una lista de valores de cadena con sinónimos asociados
En blanco 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.

Entities

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 Elección
Respuesta completa del usuario String
Edad Number
Booleano Booleano
Ciudad String
Color String
Continente String
País o región String
Fecha y hora DateTime
Correo electrónico String
Event String
Número entero Número entero
Language String
Dinero Number
Number Number
Ordinal Number
Organización String
Porcentaje Number
Nombre de la persona String
Número de teléfono String
Punto de interés String
Velocidad Number
State String
Dirección postal String
Temperatura Number
URL String
Peso Number
Código postal String
Entidad personalizada Elecció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:

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

Note

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 tópico de agente

Note

Para obtener más información sobre las variables de agentes 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
Actividad.Adjuntos table Los archivos adjuntos que proporciona el usuario.
Canal de actividades opción El ID de canal de la conversación actual.
Activity.ChannelData any Un objeto que contiene contenido específico del canal.
Activity.ChannelId string El ID de canal de la conversación actual, como cadena.
Activity.From.Id string El ID único específico del canal para el remitente.
Activity.From.Name string El nombre descriptivo del remitente específico del canal.
Actividad.Nombre string Nombre del evento.
Activity.Recipient.Id string Tipo de propiedad de la actividad entrante.
Activity.Recipient.Name string Representa el nombre mostrado 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.
Actividad.Texto string El mensaje más reciente enviado por el usuario.
Activity.Type opción Tipo de actividad.
Activity.TypeId string Tipo de actividad, como una cadena.
Activity.Value any Valor con extremo abierto.
Bot.EnvironmentId string El Id. del entorno del agente.
Bot.Id string Id. del agente.
Bot.Name string El nombre de tu agente.
Bot.SchemaName string El nombre del esquema del agente.
Bot.TenantId string El ID de arrendatario 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 string El identificador exclusivo de la conversación actual.
Conversación.EnModoDePrueba Booleano Bandera booleana que representa si la conversación está sucediendo en el lienzo de prueba.
Conversation.LocalTimeZone string 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.
Código de Error string El código del error actual.
El mensaje de error del error actual.
Mensaje de error string 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.
TemporizadorDeInactividad.Continuar Booleano 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. Obtenga más información en Desencadenador de inactividad sobre la configuración de desencadenadores de inactividad y el uso de estas variables.
LastMessage.Id string El id. del mensaje anterior enviado por el usuario.
LastMessage.Text string 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 string El id. del mensaje de usuario que activó el tema actual.
TextoDelMensajeDeActivaciónDelReconocedor string El mensaje de usuario que activó el tema actual.
Recognizer.MultipleTopicsMatchedReason string 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é método de autenticación se necesita cuando se activa el tópico.
Nota: Esta variable solo se admite si el desencadenador es On Sign In.
Usuario.Idioma 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 string El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Email string La dirección de correo electrónico del usuario que está hablando actualmente con el agente.
User.FirstName string El nombre de pila del usuario que está hablando actualmente con el agente.
User.Id string Id. único del usuario que está hablando actualmente con el agente.
Usuario.EstáConectado Booleano Indicador booleano que representa si el usuario que está hablando actualmente con el agente está autenticado o no.
User.LastName string El nombre de familia del usuario que está hablando actualmente con el agente.
User.PrincipalName string 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 string El token de acceso del usuario que se autentica con el agente.
User.DisplayName string El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Id string Id. único del usuario que está hablando actualmente con el agente.
Usuario.EstáConectado Booleano 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 string El token de acceso del usuario que se autentica con el agente.
User.DisplayName string El nombre para mostrar del usuario que está hablando actualmente con el agente.
User.Email string La dirección de correo electrónico del usuario que está hablando actualmente con el agente.
User.FirstName string El nombre de pila del usuario que está hablando actualmente con el agente.
User.Id string Id. único del usuario que está hablando actualmente con el agente.
Usuario.EstáConectado Booleano Indicador booleano que representa si el usuario que está hablando actualmente con el agente está autenticado o no.
User.LastName string El nombre de familia del usuario que está hablando actualmente con el agente.
User.PrincipalName string 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.

Note

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

Nombre Tipo Definición
Actividad.IntroducirTeclasDTMF string El valor de clave DTMF sin procesar de telefonía.
Actividad.ReconocimientoDeVoz.Confianza 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 string Texto ligeramente formateado del resultado de la hipótesis de Azure Site Recovery. Por ejemplo, "Quinientos dólares". Las palabras están escritas con letras, 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 Booleano Bandera booleana que representa si el IVR debe configurarse en modo solo DTMF en tiempo de ejecución.
Conversation.SipUuiHeaderValue string La cadena de encabezado UUI utilizada para pasar contexto a IVR al iniciar la llamada.
  • Last updated on