Creación de un flujo

Aprenda a utilizar un flujo de nube en Copilot Studio dándole 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ás al flujo como una acción desde un tema para que el agente pueda responder con el pronóstico cuando un cliente pregunte sobre el clima.

Para trabajar con agentes, un flujo requiere acciones de flujo específicas Gatillo y respuesta. Power Automate

• Desencadenador de flujo: Ejecutar un flujo desde Copilot

  

• Acción de respuesta: Responder a Copilot

  

Cuando creas un flujo desde, Gatillo y la acción se agregan automáticamente. Copilot Studio Puede modificar un flujo existente para usarlo con agentes cambiándolo para que use estas acciones.

Importante

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

• Tener el desencadenador Ejecutar un flujo desde Copilot.
• Estar ubicado en una solución dentro del mismo ambiente que el agente. Los flujos existentes se pueden agregar a una solución para que estén disponibles 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.

Crea un flujo para usar con un agente

1. Vaya a la página de Temas para 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 ambiente que el agente y utiliza 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 y 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 llaman desde un tema. Si está utilizando el flujo en un canal compatible, esto no requiere ninguna configuración especial en su cuadro de diálogo agente y los usuarios podrán administrar sus conexiones mientras usan agente.

Los flujos de nube en entornos que utilizan claves administradas por el cliente (CMK) aún no se pueden ejecutar con credenciales de usuario final 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 utilizarlo con un agente

Si tiene un flujo con un Gatillo diferente que desea usar con su agente, puede cambiar el flujo para usar la acción Ejecutar un flujo desde Copilot Gatillo y Responder a Copilot respuesta y asegurarse de que esté en una solución en el mismo ambiente 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 tu flujo aún no incluye las acciones Copilot Gatillo y respuesta, debes agregarlas antes de poder usar el flujo con tu 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 desea 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 agente intenta ejecutarlos. En lugar de ejecutar el flujo, agente dirá: "Algo inesperado sucedió. 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. Abre tu flujo y encuentra las acciones 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 estar disponibles para los agentes, los flujos deben almacenarse en una solución en el mismo Power Platform ambiente. 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 moverlos 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 final a temas