Creación de un flujo

Aprenda a usar un flujo de nube en Copilot Studio dando a un agente la capacidad de producir un pronóstico del tiempo a pedido. En este primer ejemplo, creará un flujo que obtiene una previsión meteorológica. En el siguiente ejemplo, define un tema para llamar al flujo como una acción de un tema para que el agente pueda responder con la previsión cuando un cliente pregunte por el tiempo.

Para trabajar con agentes, un flujo de Power Automate requiere el siguiente desencadenador de flujo y acción de respuesta:

• Desencadenador de flujo: Ejecutar un flujo desde Copilot
• Acción de respuesta: Responder a Copilot

Cuando crea un flujo desde Copilot Studio, se agregan el desencadenador de flujo y la acción de respuesta necesarios. Puede modificar un flujo existente para usarlo con agentes actualizándolo para usar este desencadenador y esa acción.

Requisitos previos

• Acceso a Copilot Studio con una licencia que incluya el uso de flujos en Copilot Studio.

Crear un flujo para usarlo con un agente

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

2. Abra el tema desde el que desea llamar a un flujo.

3. Seleccione el icono Agregar nododebajo de cualquier nodo y seleccione Agregar una acción.

4. En la pestaña Acciones básicas, seleccione Nuevo flujo de Power Automate.

   El portal de Power Automate se abre en una nueva pestaña, con una plantilla de flujo inicial abierta para editar. El portal se abre en el mismo entorno que el agente y usa las mismas credenciales de usuario.

   Ahora, agregue acciones a su flujo. En este ejemplo, agrega una acción que recupera el pronóstico actual de MSN El Tiempo.

5. Seleccione el nombre del flujo y reemplácelo por "Obtener pronóstico del tiempo".

6. Seleccione el desencadenador de flijo Ejecutar un flujo desde Copilot y luego agregue los parámetros de entrada:

   • Ciudad (texto)
   • Código postal (número)

   

7. Seleccione el icono Agregar debajo del desencadenador de flujo Ejecutar un flujo desde Copilot.

8. En Agregar una acción, busque «El tiempo en MSN» y seleccione la acción Obtener previsión para hoy.

9. En el panel Obtener previsión para hoy, en el cuadro Ubicación, escriba una barra diagonal (/), seleccione Insertar contenido dinámico y, a continuación, seleccione el parámetro de entrada Ciudad.

10. Proceda de la misma manera para agregar el parámetro de entrada de su Código postal.

11. En la acción Responder a Copilot, agregue los siguientes parámetros y variables de salida:

    Parámetro de salida	Type	Variables
    day_summary	Text	Resumen del día
    location	Text	Ubicación
    chance_of_rain	Number	Probabilidad de lluvia durante el día

    

12. Guardar y publicar el flujo.

13. Vuelva al tema en Copilot Studio y siga las instrucciones de Llamar a un flujo desde un tema.

Administrar qué conexiones utiliza el flujo

En un agente autenticado compatible, los flujos de nube se pueden configurar para usar credenciales de usuario cuando se ejecutan como parte de un plan de orquestación generativa o se les llama desde un tema. El uso del flujo en un canal compatible no requiere ninguna configuración especial en el agente. Los clientes pueden administrar sus conexiones mientras usan el agente.

Los flujos de nube en entornos que utilizan claves administradas por el cliente (CMK) aún no se pueden ejecutar con credenciales de cliente como parte de planes de orquestación generativa o desde temas. Asegúrese de que la configuración de solo ejecución para flujos de nube en entornos de CMK esté configurada para conexiones específicas en lugar de Proporcionado por el usuario de solo ejecución.

Modificar un flujo existente para usarlo con un agente

Si tiene un flujo con un desencadenador diferente que desea usar con su agente, puede cambiar el flujo para usar el desencadenador Ejecutar un flujo desde Copilot y la acción de respuesta Responder a Copilot , y asegurarse de que esté en una solución en el mismo entorno que el agente personalizado.

1. Vaya al Portal de Power Automate y use el selector de entorno en la parte superior derecha para elegir el entorno donde se almacena su flujo.

2. Seleccione Mis flujos en el panel de navegación izquierdo y busque el flujo que desea modificar.

3. Seleccione su flujo y, a continuación, seleccione Editar.

   

Agregar el desencadenador Copilot y la acción de respuesta

Si su flujo aún no incluye el desencadenador de flujo y la acción de respuesta requeridos, debe agregarlos antes de poder usar el flujo con su agente.

1. Seleccione Nuevo paso.

2. Busque Copilot y seleccione Ejecutar un flujo desde Copilot.

3. Seleccione Nuevo paso.

4. Busque el conector Copilot y seleccione Responder a Copilot. La acción de respuesta se puede utilizar en varias ramas del flujo, pero debe tener las mismas salidas en cada uso.

5. Guardar y publicar el flujo.

Asegúrese de que la acción de respuesta esté configurada para regresar en tiempo real

Los flujos que desee utilizar en un agente deben devolver valores en tiempo real o de forma sincrónica. Los flujos que se ejecutan en segundo plano o de forma asincrónica pueden provocar un error cuando el agente intente ejecutarlos. En lugar de ejecutar el flujo, el agente dice «Se ha producido un error inesperado. Lo estamos investigando. Código de error: 3000".

Cuando crea un flujo desde Copilot Studio, las respuestas asíncronicas están desactivadas de forma predeterminada. Si modificó un flujo existente que tiene activadas las respuestas asincrónicas, siga estos pasos para comprobar la configuración y asegurarse de que esté desactivada:

1. Abra su flujo y busque las acciones Responder a Copilot.

2. Seleccione la pestaña Configuración.

3. Establezca Respuesta asincrónica en Desactivado y luego seleccione Guardar.

   

Agregar el flujo a una solución

Para que estén disponibles para sus agentes, los flujos deben almacenarse en una solución en el mismo entorno de Power Platform. Si un flujo está en una solución, se ve un mosaico de soluciones en la página de detalles del flujo que enumera en qué soluciones se encuentra el flujo. Se pueden agregar flujos a la Solución predeterminada para usar con agentes, o trasladarse a una solución diferente siguiendo los pasos a continuación:

1. Vaya a Power Automate.

2. Vaya a Soluciones y seleccione una solución existente o cree una solución para su flujo.

3. Si quiere crear una nueva solución:

   1. Seleccione Nueva solución.

   2. Asigne un nombre a su nueva solución, seleccione Editor predeterminados de CDS en el campo Editor e introduzca un número de versión.

      

   3. Seleccione Crear.

4. Si desea agregar su flujo a una solución existente, seleccione la solución deseada y seleccione Editar.

5. Seleccione Agregar>Automatización>Flujo de nube.

   

   Aparece el panel Agregar flujos existentes.

6. Seleccione su flujo y, a continuación seleccione Agregar.

   

Contenido relacionado

• Llamar a un flujo como una acción
• Usar variables para la entrada y salida de información
• Agregar autenticación de usuario a temas