Reutilizar variables en temas
De forma predeterminada, el valor de una variable solo se puede usar en el tema en el que se crea la variable. Por ejemplo, si crea una variable UserCity en un tema Comprobar el tiempo, solo podrá incluirla en elementos como nodos de mensajes dentro del tema Comprobar el tiempo. Este tipo de variables se denominan variables de tema (ámbito limitado). Sin embargo, puede haber situaciones en las que le interesará utilizar el mismo valor en varios temas. Los agentes pueden recordar un contexto variable cuando una conversación abarca varios temas. Por ejemplo, un tema Bienvenido podría solicitar el nombre y la dirección de correo electrónico del cliente. Cuando la conversación pasa a otro tema, como Reserva de citas, es posible que desee que el agente recuerde el nombre y la dirección de correo electrónico del cliente. En Microsoft Copilot Studio, estas variables se conocen como variables del agente. Cualquier tema del agente puede acceder a ellas.
Las variables del agente se aplican durante la sesión de chat actual. No se pueden transferir de una sesión de chat de cliente a otra. Puede especificar qué variables deben tratarse como variables de agente, para distinguirlas de las variables en el nivel de tema.
Crear una variable de agente
Para definir una variable como variable del agente, ábrala en el lienzo de creación. Abra el nodo Formular una pregunta que almacena la variable con la que desea trabajar. En el panel Propiedades de variable, en Uso, seleccione Global (cualquier tema puede acceder). Se dará una cadena de prefijo de agente al nombre de la variable para diferenciarlo de las variables en el nivel de tema.
Por ejemplo, la variable UserName ahora aparece como Global.UserName. Cuando convierta una variable en una variable de agente, asegúrese de que el nombre de la variable sea único en todos los temas. Si hay un conflicto de nombres, deberá cambiar el nombre de la variable antes de guardar su cambio.
Para más información, consulte Usar variables globales en todos los temas de un agente.
Establecer variables de agente
Después de crear una variable de agente, estará disponible para todos los temas. Al trabajar con un nodo de mensaje o pregunta, seleccione el botón {x}. Esto mostrará una lista de todas las variables disponibles en este tema. Las variables están ordenadas por orden alfabético, así que verá que todas las variables del agente están agrupadas en el menú de variables, ya que todas comienzan por la palabra agente.
Al utilizar un nodo de condición, un nodo de acción de flujo o un nodo de capacidad, también podrá ver las variables del agente disponibles allí.
Administrar variables de agente
Después de crear una variable de agente que pueda usar en varios temas, debería entender dónde se usa. Puede ver fácilmente dónde se definió la variable por primera vez (Origen) y los otros temas que la utilizan. Esto puede resultar útil si trabaja en un nuevo agente o si tiene varias variables y bifurcaciones de temas complejos.
Existen dos elementos primarios disponibles en el panel Propiedades de variable.
Referencia: va al nodo donde se creó inicialmente la variable.
Usado por: muestra todos los temas en los que se usa la variable, para que pueda ir directamente a ese tema y nodo.
Establecer el valor de una variable de agente desde orígenes externos
Puede configurar una variable de agente para que se inicialice con un origen externo. Esto permite al agente iniciar la conversación con algo de contexto.
Por ejemplo, un cliente abre un chat desde su sitio web. Si el usuario ha iniciado sesión en su sitio web, usted ya sabrá el nombre del cliente. Al pasar esa información al agente antes de iniciar la conversación, puede tener una conversación más inteligente con el cliente sin tener que volver a preguntarle su nombre.
Puede especificar que una variable pueda obtener sus valores de un origen externo. Abra el panel Propiedades de variables y, en la sección Uso, seleccione el cuadro Los orígenes externos pueden establecer valores.
Para obtener más información sobre el trabajo con variables de agente, consulte Reutilizar variables en todos los temas.