Usar variables para la entrada y salida de información

Utilice variables como parámetros de entrada y salida para pasar información entre los flujos de agentes y los agentes de Copilot Studio.

Importante

Un agente solo puede recibir hasta 1 MB de datos de un flujo en una sola acción. Sin embargo, no hay límite en el número de variables ni en la cantidad de datos que puede enviar un agente.

En este ejemplo, se crea un flujo con un parámetro de entrada y se lo devuelve a un agente como parámetro de salida.

Requisitos previos

• Comprender cómo crear un flujo a partir del lienzo de creación de Copilot Studio

Tipos de parámetros admitidos

Los agentes de Copilot Studio admiten los siguientes tipos de parámetros de entrada y salida para los flujos de agentes:

• Número
• Cadena
• Booleana

Actualmente no se admiten los siguientes tipos de datos:

• Objeto
• Fecha
• Marca de tiempo
• Lista [cadena]
• Lista [Número]
• Lista [Booleano]
• Lista [Objeto]
• Lista [Fecha]
• Lista [Marca de tiempo]

Crear un tema y un flujo

1. Vaya a la página Temas de su agente.

2. Cree un nuevo tema llamado Mensaje de eco.

3. Agregue la frase desencadenadora eco.

4. Agregue un nodo Pregunta e ingrese el mensaje «Dígame algo y yo le responderé».

5. En Identificar, escoja Respuesta completa del usuario.

6. En Guardar respuesta del usuario como, cambie el nombre de la variable a userResponse.

   

7. Seleccione el icono Agregar nododebajo del nodo Pregunta y seleccione Agregar una herramienta.

8. En la pestaña Acciones básicas, seleccione Nuevo flujo de agente. La pestaña Diseñador de flujos de agente se abre con una plantilla inicial para un flujo de agente llamado por un agente. El flujo incluye dos acciones: Cuando un agente llama al flujo y Responder al agente.

9. Seleccione Publicar para guardar el flujo antes de realizar cambios. Aparece una notificación cuando el flujo se crea correctamente.

10. Seleccione Volver al agente para volver al tema. Se agrega un nuevo nodo Acción al tema para el flujo.

11. Seleccione Guardar para terminar de agregar el flujo como una herramienta al agente.

Editar como detalles del flujo

1. En el nodo Acción con el flujo, seleccione el vínculo Ver detalles del flujo para volver al flujo del agente.

2. En la pestaña Información general del flujo, edite los detalles del flujo y reemplace el nombre por parámetro Echo. Seleccione Guardar.

3. Vuelva a la pestaña Diseñador.

Agregar un parámetro de entrada del flujo

1. Seleccione el desencadenador Cuando un agente llama al flujo y seleccione Agregar una entrada.

2. Seleccione Texto e ingrese el nombre Entrada de cadena.

   

Agregar un parámetro de salida al flujo

1. Seleccione la acción de respuesta Responder al agente y luego elija Agregar una salida.

2. Seleccione Texto e ingrese el nombre Salida de cadena.

   

3. Para el valor, escriba una barra (/) en el cuadro, seleccione Insertar contenido dinámico y luego seleccione la variable Entrada de cadena.

4. Seleccione Guardar borrador y, a continuación, Publicar. Copilot Studio le informa cuando se publica el flujo del agente.

5. Seleccione Volver al agente para volver al editor de temas del agente. El nuevo flujo de acción se añade al tema.

Llamada al flujo desde el tema

1. Seleccione el nuevo nodo de acción.

2. Establezca el parámetro de entrada de flujo en la variable de salida del nodo Pregunta: Entrada de cadena (cadena) obtiene su valor de la variable userResponse.

   

3. Agregue un nodo Mensaje.

4. Seleccione Insertar variable y, a continuación, Salida_cadena.

   

5. Seleccione Guardar.

6. Pruebe el agente.

   

Contenido relacionado

• Información general de las variables