Variables y entidades
Ámbitos y tipos de variables; entidades precompiladas y personalizadas; slot filling.
¿Qué aprenderás?
- Elegir el ámbito correcto de una variable
- Reconocer información con entidades y sinónimos
- Usar llenado proactivo de espacios
Explicación
Cuando un usuario dice "Cuesta 1000 dólares" ante un nodo Pregunta configurado con la entidad Dinero, el agente reconoce "1000 dólares" como tipo dinero y guarda "1000" como número. Las entidades personalizadas enseñan al agente conocimiento de dominio, como categorías de producto de una tienda con sinónimos ("trekking" se corresponde con "senderismo"). El llenado proactivo permite que "Quiero comprar un par de botas de montaña por menos de 100$" rellene a la vez actividad y rango de precio.
Conceptos principales
- Ámbitos: tema, global, sistema, entorno (solo lectura; se cambian en Power Apps; los agentes deben republicarse tras cambios salvo variables secretas).
- Tipos base: String, Booleano, Número, Tabla, Registro, DateTime, Elección (lista con sinónimos), En blanco. El tipo se fija en la primera asignación.
- Entidades precompiladas: edad, booleano, ciudad, color, país, fecha y hora, correo electrónico, entero, dinero, número, porcentaje, nombre de persona, teléfono, estado, dirección postal, URL, código postal, etc.; cada una con su tipo base asociado (p. ej., Dinero -> Número).
- Entidades personalizadas: lista cerrada (valores + sinónimos + coincidencia inteligente que corrige erratas) y expresión regular (regex; sintaxis .NET para NLU/CLU, JavaScript para NLU+; (?i) para ignorar mayúsculas).
- Llenado de espacios (slot filling): guardar el valor de la entidad extraída en la variable del nodo Pregunta.
- Llenado proactivo de espacios: el usuario da varias informaciones a la vez y el agente rellena varias entidades, omitiendo preguntas innecesarias; controlable con "Omitir pregunta" (Preguntar cada vez).
- Varios valores: un nodo Pregunta puede aceptar varios valores de una entidad y devolver una tabla (iterable con "Recorrer en iteración una lista").
- Una de varias entidades: hasta cinco entidades diferentes en un nodo Pregunta; la variable es un registro; se identifica solo la primera entidad coincidente en el mensaje.
- Listas abiertas: valores rellenados en tiempo de ejecución desde datos externos (máx. 100 entradas); útiles en agentes de voz.
- Metadatos: activar "Incluir metadatos" expone Literal, Value y ConfidenceScore (p. ej., StartDate.Literal "mañana").
- Variables del sistema destacadas: Activity.Text (último mensaje), Conversation.Id, User.DisplayName, User.Email, Bot.Name, Error.Code, FallbackCount, etc.
- Power Fx: fórmulas para expresiones (variables ocultas del sistema con prefijo System.).
Ejemplo práctico
- Variable global User.Nombre guardada en un tema de bienvenida y usada en otros temas.
- Entidad regex para números de licencia y condición de validación.
Caso de uso empresarial
El usuario dice 'quiero botas de montaña por menos de 100$' y el agente rellena a la vez producto y presupuesto.
Buenas prácticas
- Elegir el ámbito más pequeño posible (tema antes que global).
- Añadir sinónimos y coincidencia inteligente en listas cerradas.
- Usar ConfidenceScore para pedir aclaración cuando el reconocimiento es débil.
Errores comunes
- Intentar asignar valores de otro tipo a una variable tipada (error).
- Esperar que las variables de entorno sean editables desde Copilot Studio (son de solo lectura).
- Olvidar republicar tras cambiar variables de entorno.
Resumen
Las variables almacenan información durante la conversación y existen en cuatro ámbitos: de tema (por defecto), globales (todos los temas), de sistema (propias del agente, con contexto de conversación y usuario) y de entorno (creadas en Power Platform, de solo lectura en Copilot Studio). Las entidades permiten identificar tipos de información (dinero, fechas, ciudades...) en la entrada del usuario y guardarlas en variables del tipo adecuado; el llenado de espacios (slot filling) coloca el valor extraído en la variable.
Puntos importantes para recordar
- Variable = contenedor con tipo y ámbito; entidad = reconocedor de información.
- Slot filling + llenado proactivo hacen las conversaciones más naturales.
Fuentes oficiales
Microsoft Learn / Microsoft Support · consultado el 2026-09-17