Información general de las variables

Note

Las características de este artículo son impulsadas por el arnés estándar, que utiliza las opciones de facturación descritas en Licencias para agentes alimentados por el arnés estándar. Aprende cómo acceder a las funciones estándar en Access agentes estándar y flujos de agentes.

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. Separando los parámetros de los objetos que consumen, puedes cambiar los valores dentro del mismo entorno o cuando migras 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
Boolean 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
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"; puedes saber más en Blank 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 en el lienzo de autor. El agente considera los nodos en la parte superior del lienzo de creación antes que los nodos en la parte inferior.

Cuando creas ramas usando nodos de Condición, Copilot Studio ordena las ramas de izquierda a derecha. El agente considera los nodos en la rama más a la izquierda antes que los nodos de la rama 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 Número
Boolean Boolean
Ciudad String
Color String
Continent String
País o región String
Fecha y hora Fecha y hora
Correo electrónico String
Event String
Entero Entero
Language String
Dinero Número
Número Número
Ordinal Número
Organización String
Porcentaje Número
Nombre de la persona String
Número de teléfono String
Punto de interés String
Velocidad Número
State String
Dirección postal String
Temperatura Número
URL String
Peso Número
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 permanece exactamente igual salvo por algunas referencias externas clave que difieren entre el entorno de origen y el entorno de destino.

Utiliza variables de entorno de la misma manera que variables de tema, global y de 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 de Propiedades de Variables también tiene un vínculo a Power Apps, la experiencia de autoría para variables de entorno.

La versión publicada de un agente que utiliza variables de entorno incluye los valores que estableces para estas variables cuando publicas el agente. Cada vez que un administrador actualiza variables de entorno, debes volver a publicar cualquier agente que use estas variables para que los cambios surjan efecto 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 Escribir 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 String
Sí/No Boolean
Origen de datos String
Secreto String

Note

Ves errores en las variables de entorno en el chat de prueba y al publicar. Sin embargo, estos errores no aparecen en la lista de Temas porque las variables de entorno no son variables de tema.

Variables del sistema

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

Captura de pantalla de variables del sistema en un tema.

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 choice El ID de canal de la conversación actual.
Actividad.DatosCanal cualquier Un objeto que contiene contenido específico del canal.
Activity.ChannelId string El ID de canal de la conversación actual, como cadena de texto.
Activity.From.Id string El ID único específico del canal para el remitente.
Activity.From.Name string El nombre amigable para el usuario 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 choice Tipo de actividad.
Activity.TypeId string Tipo de actividad, como una cadena.
Activity.Value cualquier 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 choice 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 Boolean 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 number 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 Boolean Bandera booleana que representa si el temporizador debe continuar.
Nota: Esta variable solo se admite si el desencadenador es Inactivity.
InactivityTimer.Count number 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.
LastMessage.Id string El id. del mensaje anterior enviado por el usuario.
LastMessage.Texto string El mensaje anterior enviado por el usuario.
Recognizer.ExtractedEntities choice Representa las entidades extraídas del mensaje desencadenante.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
Recognizer.IntentOptions choice 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.
Recognizador.IntentSeleccionado choice ** 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.
Reconocedor.RazónDeMúltiplesTemasCoincidentes string Se utiliza para determinar por qué coincidieron varios temas.
Nota: Esta variable solo se admite si el desencadenador es On Select Intent.
SignInReason choice 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 choice Esta variable se utiliza para establecer la configuración regional del idioma del usuario por conversación.

Variables para agentes habilitados por voz

Las siguientes variables solo están disponibles en agentes habilitados para voz. Aprende más en Usar variables de voz.

Nombre Tipo Definición
Actividad.IntroducirTeclasDTMF string El valor de clave DTMF sin procesar de telefonía.
Actividad.ReconocimientoDeVoz.Confianza number La puntuación de confianza para la hipótesis de reconocimiento automático de voz es resultado completo, 0 a 1.
Activity.SpeechRecognition.MinimallyFormattedText string Texto ligeramente formateado del resultado de la hipótesis del reconocimiento automático de voz. 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 choice El tipo de entrada más reciente del agente usuario. El valor puede ser prueba, voz o DTMF.
Conversación.SoloPermitirDTMF Boolean 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.

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. Aprende más en Variables de autenticación.

Nombre Tipo Definición
User.DisplayName string El nombre visible 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.
Usuario.Nombre 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 Boolean 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.
Usuario.NombrePrincipal 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 visible 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 Boolean 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 visible 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.
Usuario.Nombre 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 Boolean 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.
Usuario.NombrePrincipal string El nombre principal del usuario que está hablando actualmente con el agente.
  • Last updated on