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 obtenga un pronóstico del tiempo. En el siguiente ejemplo, 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 una acción específica de respuesta y desencadenador de flujo.

• Desencadenador de flujo: Ejecutar un flujo desde Copilot

  

• Acción de respuesta: Responder a Copilot

  

Cuando crea un flujo desde Copilot Studio, el desencadenador y la acción se agregan por usted. Puede modificar un flujo existente para usarlo con agentes cambiándolo para usar estas acciones.

Importante

Para utilizar flujos de nube en agentes personalizados Copilot Studio, los flujos deben:

• Tener el desencadenador Ejecutar un flujo desde Copilot.
• Estar ubicado en una solución dentro del mismo entorno que el agente. Los flujos existentes se pueden agregar a una solución para que esté disponible al agregar acciones a su agente.
• Devolver una respuesta sincrónicamente con la acción Responder al Copilot, dentro del límite de acción de 100 segundos. Para evitar tiempos de espera, optimice la lógica del flujo, las consultas y la cantidad de datos devueltos para que una ejecución típica esté por debajo de este límite. Las acciones que deben ejecutarse por más tiempo se pueden colocar después de la acción Responder a Copilot para continuar ejecutándose hasta el límite de duración de ejecución del flujo, que suele ser de 30 días.

Requisitos previos

• Acceso a Copilot Studio con licencia que incluye el uso de flujos dentro del contexto de creaciones de 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 Agregar nodo (+) debajo de un nodo existente para agregar un nuevo nodo.

4. En la ventana de selección de nodo, seleccione Llamar a una acción, Acción básica y, a continuación, seleccione Crear un flujo.

   

   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.

   

   Propina

   Cambie el nombre de los nodos para que sea más fácil identificarlos. Seleccione el campo de nombre del nodo para actualizar el nombre directamente, o seleccione el icono Más (…) del nodo y seleccione Renombrar desde el menú. También puede renombrar nodos en el editor de código.

   No es posible cambiar el nombre de los nodos Gatillo y nodos Ir al paso.

   Los nombres de nodo pueden tener hasta 500 caracteres de largo.

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

1. Seleccione el nombre del flujo y cámbiele el nombre Obtener pronóstico del tiempo.

   

2. Agregue los siguientes parámetros de entrada al desencadenador Ejecutar un flujo desde Copilot:

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

   

3. Seleccione Agregar una acción para crear una nueva acción debajo del desencadenador de flujo de Ejecutar un flujo desde Copilot.

   

4. Busque MSN weather y luego seleccione la acción Obtener previsión para hoy.

   

5. En la acción Obtener pronóstico para hoy, en el recuadro Ubicación, seleccione Agregar contenido dinámico y luego seleccione Ciudad y Código postal.

   

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

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

   

7. Seleccione Guardar.

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. Si está utilizando el flujo en un canal admitido, esto no requiere ninguna configuración especial en el diálogo de su agente, y los usuarios finales podrán administrar sus conexiones mientras utilizan 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. Navegue a Mis flujos en el lado izquierdo y busque el flujo.

3. Seleccione el flujo.

   

Agregar el desencadenador Copilot y la acción de respuesta

Si el flujo aún no incluye el desencadenador Copilot y la acción de respuesta, debe agregarlos antes de poder usar el flujo con el 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 intenta ejecutarlos. En lugar de ejecutar el flujo, el agente dirá "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 respuestas asincrónicas activadas, siga estos pasos para verificar la configuración y asegurarse de que esté desactivada:

1. Abra su flujo y busque la/las acción/acciones de Responder a Copilot.

2. Seleccione la pestaña Configuración.

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

   

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 verá 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 al portal de Power Automate.

2. Vaya a Soluciones y seleccione una solución existente o cree una solución para sus flujos.

   Para crear una solución, seleccione Nueva solución.

   

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

   

3. En la pestaña Soluciones, vaya a la solución que desea usar. Seleccione Agregar existente para agregar un flujo.

   

4. En la página Agregar flujo existente, seleccione la pestaña De soluciones, seleccione su flujo y seleccione Agregar.

   

   Para mover un flujo desde la pestaña Mis flujos a una solución, seleccione Soluciones externas y Agregar para agregar su flujo a la solución.

   

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