Compartir por

Usar variables para la entrada y salida de información

Use variables como parámetros de entrada y salida para pasar información entre los flujos de agente 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 desde el 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 flujos de agente:

  • Number
  • String
  • Booleana

Actualmente no se admiten los siguientes tipos de datos:

  • 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 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.

    Captura de pantalla de un nodo Pregunta que recopila la respuesta del usuario.

  7. Seleccione el icono Agregar nodo en el nodoPregunta y seleccione Agregar una herramienta.

  8. En la pestaña Acciones básicas , seleccione Nuevo flujo del agente. Se abre la pestaña Diseñador de flujo de agente con una plantilla de inicio para un flujo de agente llamado por un agente. El flujo incluye dos acciones: cuando un agente llama al flujo y responde al agente.

  9. Seleccione Guardar borrador.

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

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

Agregar un parámetro de entrada del flujo

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

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

    Captura de pantalla de los parámetros de entrada para el desencadenador de flujo.

Agregar un parámetro de salida al flujo

  1. Seleccione la acción Responder a la respuesta del agente y seleccione Agregar una salida.

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

    Captura de pantalla del parámetro salida de acción de respuesta.

  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 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 agrega al tema.

Llamar 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.

    Captura de pantalla del nodo Acción que llama al flujo «Echo Parámetro».

  3. Agregue un nodo Mensaje.

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

    Captura de pantalla del nodo de mensaje que hace eco de la entrada del usuario

  5. Seleccione Guardar.

  6. Pruebe el agente.

    Captura de pantalla de conversaciones de un agente.

Contenido relacionado

  • Last updated on