Agregar variables de entrada y salida

  • Artículo

Importante

Las capacidades y características de Power Virtual Agents son ahora parte de Microsoft Copilot Studio tras importantes inversiones en IA generativa e integraciones mejoradas en Microsoft Copilot.

Algunos artículos y capturas de pantalla pueden hacer referencia a Power Virtual Agents mientras actualizamos la documentación y el contenido de capacitación.

Utilice variables como parámetros de entrada y salida para pasar información entre flujos Power Automate y copilotos de Microsoft Copilot Studio.

Importante

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

En este ejemplo, creará un flujo con un parámetro de entrada y lo devolverá a un copiloto como parámetro de salida.

Requisitos previos

  • Comprender cómo crear un flujo desde el lienzo de creación de Copilot Studio

Tipos de parámetros admitidos

Los copilotos pueden usar los siguientes tipos de entradas y salidas con los flujos de Power Automate:

  • Number
  • String
  • Booleana

No se admiten los siguientes tipos:

  • Objecto
  • Date
  • 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 de temas de su copiloto.

  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. Para Guardar respuesta como, seleccione el icono de lápiz y cambie el nombre de la variable a userResponse.

    Captura de pantalla de un nodo Pregunta.

  7. En el lienzo de creación, seleccione Agregar nodo (+). Seleccione Llamar una acción y seleccione Crear un flujo.

  8. En el portal Power Automate, asigne un nombre al flujo Parámetro de eco.

Añada parámetros de entrada al flujo

  1. En el desencadenador de flujos Microsoft Copilot Studio, seleccione Agregar una entrada.

    Captura de pantalla de un deseencadenador de flujos de Microsoft Copilot Studio, con Agregar una entrada resaltado.

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

    Captura de pantalla de la entrada del desencadenador de flujo.

Añada parámetros de salida al flujo

  1. En la acción de respuesta Devolver valores a Microsoft Copilot Studio, seleccione Agregar una salida.

    Captura de pantalla de la acción de respuesta de flujo, con Agregar una salida resaltada.

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

    Captura de pantalla de la salida de la acción de respuesta.

  3. Para el valor de Salida_cadena, seleccione la variable Entrada_cadena.

    Captura de pantalla de un parámetro de entrada seleccionado como valor de un parámetro de salida.

  4. Seleccione Guardar.

Seleccionar variables en el tema de copiloto

  1. En el lienzo de creación de Microsoft Copilot Studio, seleccione Agregar nodo (+) y luego seleccione Llamar a una acción.

  2. Seleccione el flujo que ha creado anteriormente, Parámetro de eco.

  3. Para String_Input(text) gets value from, seleccione userResponse.

  4. Agregue un nodo Mensaje. Seleccione Insertar variable y, a continuación, Salida_cadena.

    Captura de pantalla de un nodo de acciones para el flujo de parámetro de eco.

  5. Pruebe su tema en el panel Probar copiloto.

    Captura de pantalla de la conversación de copiloto.

También puede usar valores literales para los parámetros de entrada

Alternativamente, en lugar de usar una variable como parámetro de entrada de una acción, puede escribir el valor directamente en el recuadro "obtiene el valor de".

Captura de pantalla de un valor literal pasado como parámetro de entrada.

Utilizar variables