Créer un flux

Apprenez à utiliser un flux de cloud dans Copilot Studio en donnant à un agent la possibilité de produire une prévision météorologique sur demande. Dans ce premier exemple, vous créez un flux qui récupère une prévision météorologique. Dans l’exemple suivant, vous configurez une rubrique pour appeler le flux en tant qu’action afin que l’agent puisse répondre avec les prévisions lorsqu’un client pose des questions sur la météo.

Pour utiliser des agents, un flux Power Automate nécessite le déclencheur de flux et l’action de réponse suivants :

• Déclencheur de flux : Exécuter un flux à partir de Copilot
• Action de réponse : Répondre à Copilot

Lorsque vous créez un flux à partir de Copilot Studio, le déclencheur de flux et l’action de réponse requis sont ajoutés pour vous. Vous pouvez modifier un flux existant pour l’utiliser avec des agents en le mettant à jour pour utiliser ce déclencheur et cette action.

Important

Pour utiliser des flux de cloud dans des agents personnalisés dans Copilot Studio, les flux doivent :

• Avoir le déclencheur Exécuter un flux à partir de Copilot.
• Être situés dans une solution au sein du même environnement que l’agent. Les flux existants peuvent être ajoutés à une solution pour être disponibles lors de l’ajout d’actions à votre agent.
• Renvoyez une réponse de manière synchrone avec l’action Répondre à Copilot, dans la limite d’action de 100 secondes. Pour éviter les délais d’attente, optimisez la logique du flux, les requêtes et la quantité de données renvoyées afin qu’une exécution classique soit inférieure à cette limite. Les actions qui doivent s’exécuter plus longtemps peuvent être placées après l’action Répondre à Copilot pour continuer à s’exécuter jusqu’à la limite de durée d’exécution du flux, qui correspond généralement à 30 jours.

Prérequis

• Accès à Copilot Studio avec une licence qui inclut l’utilisation de flux dans Copilot Studio.

Créer un flux à utiliser avec un agent

1. Accédez à la page Rubriques pour votre agent.

2. Ouvrez la rubrique à partir de laquelle vous souhaitez appeler un flux.

3. Sélectionnez l’icône Ajouter un nœud sous n’importe quel nœud, puis sélectionnez Ajouter une action.

4. Dans l’onglet Actions de base, sélectionnez Nouveau flux Power Automate .

   Le portail Power Automate s’ouvre dans un nouvel onglet, avec un modèle de flux de démarrage ouvert aux fins de modification. Le portail s’ouvre automatiquement dans le même environnement que l’agent et utilise les mêmes informations d’identification d’utilisateur.

   Ajoutez maintenant des actions à votre flux. Dans cet exemple, vous ajoutez une action qui récupère les prévisions actuelles de MSN Météo.

5. Sélectionnez le nom du flux et remplacez-le par « Obtenir les prévisions météorologiques ».

6. Sélectionnez le déclencheur de flux Exécuter un flux depuis Copilot et ajoutez les paramètres d’entrée suivants :

   • Ville (Texte)
   • Code postal (numéro)

   

7. Sélectionnez l’icône Ajouter sous le déclencheur de flux Exécuter un flux depuis Copilot.

8. Dans Ajouter une action, recherchez « Météo MSN » et sélectionnez l’action Obtenir les prévisions du jour.

9. Dans le volet Obtenir les prévisions du jour, dans la zone Emplacement, entrez une barre oblique (/), sélectionnez Insérer du contenu dynamique, puis sélectionnez votre paramètre d’entrée Ville.

10. Procédez de la même manière pour ajouter votre paramètre d’entrée Code postal.

11. Dans l’action Répondre à Copilot, ajoutez les paramètres et variables de sortie suivants :

    Paramètre de sortie	Type	Variable
    day_summary	Text	Résumé de la journée
    location	Text	Lieu
    chance_of_rain	Chiffre	Risque de pluie pendant la journée

    

12. Enregistrer et publier le flux.

13. Revenez à votre rubrique dans Copilot Studio et suivez les instructions de la section Appeler un flux à partir d’une rubrique.

Gérer les connexions utilisées par le flux

Dans un agent authentifié pris en charge, les flux de cloud peuvent être configurés pour utiliser les informations d’identification de l’utilisateur lorsqu’ils sont exécutés dans le cadre d’un plan d’orchestration générative ou appelés à partir d’une rubrique. L’utilisation du flux dans un canal pris en charge ne nécessite aucune configuration particulière dans votre agent. Les clients peuvent gérer leurs connexions tout en utilisant l’agent.

Les flux de cloud dans les environnements utilisant des clés gérées par le client (CMK) ne peuvent pas encore être exécutés avec les informations d’identification du client dans le cadre de plans d’orchestration générative ou à partir de rubriques. Assurez-vous que les paramètres en exécution seule pour les flux de cloud dans les environnements CMK sont définis sur des connexions spécifiques au lieu de Fourni par l’utilisateur en exécution seule.

Modifier un flux existant pour l’utiliser avec un agent

Si vous avez un flux avec un déclencheur différent que vous souhaitez utiliser avec votre agent, vous pouvez modifier le flux pour utiliser le déclencheur Exécuter un flux à partir de Copilot et l’action de réponse Répondre à Copilot. Assurez-vous également qu’il se trouve dans une solution dans le même environnement que l’agent personnalisé.

1. Accédez au portail Power Automate et utilisez le sélecteur d’environnements en haut à droite pour choisir l’environnement dans lequel votre flux est stocké.

2. Sélectionnez Mes flux dans le volet de navigation de gauche et recherchez le flux que vous souhaitez modifier.

3. Sélectionnez votre flux et sélectionnez Modifier.

   

Ajouter le déclencheur Copilot et l’action de réponse

Si votre flux n’inclut pas déjà le déclencheur de flux et l’action de réponse requis, vous devez les ajouter avant de pouvoir utiliser le flux avec votre agent.

1. Sélectionnez Nouvelle étape.

2. Recherchez Copilot et sélectionnez Exécuter un flux à partir de Copilot.

3. Sélectionnez Nouvelle étape.

4. Recherchez le connecteur Copilot et sélectionnez Répondre à Copilot. L’action de réponse peut être utilisée dans plusieurs branches du flux, mais doit avoir les mêmes sorties à chaque utilisation.

5. Enregistrer et publier le flux.

Assurez-vous que l’action de réponse est définie pour renvoyer en temps réel

Les flux que vous souhaitez utiliser dans un agent doivent retourner des valeurs en temps réel ou de manière synchrone. Les flux qui s’exécutent en arrière-plan ou de manière asynchrone peuvent provoquer une erreur lorsque votre agent essaie de les exécuter. Au lieu d’exécuter le flux, l’agent dit, « Une erreur inattendue s’est produite. Nous sommes en train de l’étudier. Code d’erreur : 3000 ».

Lorsque vous créez un flux à partir de Copilot Studio, les réponses asynchrones sont désactivées par défaut. Si vous avez modifié un flux existant pour lequel les réponses asynchrones sont activées, procédez comme suit pour vérifier le paramètre et vous assurer qu’il est désactivé :

1. Ouvrez votre flux et recherchez les actions Répondre à Copilot.

2. Sélectionnez l’onglet Paramètres.

3. Définissez Réponse asynchrone sur Désactivé, puis sélectionnez Enregistrer.

   

Ajouter le flux à une solution

Pour être disponibles pour les agents, les flux doivent être stockés dans une solution dans le même environnement Power Platform. Si un flux se trouve dans une solution, une vignette Solutions est visible sur la page de détails du flux qui répertorie les solutions dans lesquelles se trouve le flux. Les flux peuvent être ajoutés à la solution par défaut pour être utilisés avec des agents, ou déplacés vers une autre solution en procédant comme suit :

1. Accédez à Power Automate.

2. Accédez à Solutions et sélectionnez une solution existante ou créez une solution pour votre flux.

3. Si vous souhaitez créer une solution :

   1. Sélectionnez Nouvelle solution.

   2. Donnez un nom à votre nouvelle solution, sélectionnez Éditeur par défaut CDS dans le champ Éditeur et entrez un numéro de Version.

      

   3. Sélectionnez Créer.

4. Si vous souhaitez ajouter votre flux à une solution existante, sélectionnez la solution souhaitée, puis sélectionnez Modifier.

5. Sélectionnez Ajouter un flux de cloud>Automatisation>Flux de cloud.

   

   Le volet Ajouter des flux existantss’affiche.

6. Sélectionnez votre flux, puis sélectionnez Ajouter.

   

Contenu associé

• Appeler un flux en tant qu’action
• Utiliser des variables d’entrée et de sortie pour transmettre des informations
• Ajouter l’authentification de l’utilisateur à des rubriques