Créer un flux

Apprenez à utiliser un flux de cloud en Copilot Studio donnant à un agent la possibilité de produire une prévision météo sur demande. Dans ce premier exemple, vous allez créer un flux qui récupère une prévision météo. Dans l’exemple suivant, vous appellerez le flux en tant qu’action à partir d’un rubrique afin que le agent puisse répondre avec les prévisions lorsqu’un client pose une question sur la météo.

Pour travailler avec des agents, un flux nécessite un flux spécifique Gâchette et une action réponse. Power Automate

• 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, le Gâchette et l’action sont ajoutés pour vous. Copilot Studio Vous pouvez modifier un flux existant pour l’utiliser avec des agents en le modifiant pour utiliser ces actions.

Important

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

• Avoir le déclencheur Exécuter un flux à partir de Copilot.
• Être situé dans une solution au sein du même environnement que le 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.

Conditions préalables

• Accédez à Copilot Studio avec une licence incluant l’utilisation de flux dans le contexte des créations de Copilot Studio.

Créez un flux à utiliser avec un agent

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

2. Ouvrez le rubrique à partir duquel vous souhaitez appeler un flux.

3. Sélectionnez Ajouter un nœud (+) sous un nœud existant pour en ajouter un nouveau.

4. Dans la fenêtre de sélection de nœuds, sélectionnez Appeler une action, Action de base, puis sélectionnez Créer un flux.

   

   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 dans le même environnement que agent et utilise les mêmes identifiants d’utilisateur.

   

   Astuce

   Renommez les nœuds pour les identifier plus facilement. Sélectionnez le champ de nom du nœud pour mettre à jour le nom directement, ou sélectionnez l’icône Plus (…) du nœud et sélectionnez Renommer dans le menu. Vous pouvez également renommer des nœuds dans l’éditeur de code.

   Il n’est pas possible de renommer les nœuds Déclencher et Aller à l’étape.

   Les noms de nœud peuvent comporter jusqu’à 500 caractères.

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.

1. Sélectionnez le nom du flux et renommez-le Obtenir les prévisions météo.

   

2. Ajoutez les paramètres d’entrée suivants au déclencheur Exécuter un flux à partir de Copilot :

   • Ville (Texte)
   • Code postal (Nombre)

   

3. Sélectionnez Ajouter une action pour créer une nouvelle action sous le déclencheur de flux Exécuter un flux à partir de Copilot.

   

4. Recherchez MSN Météo, puis sélectionnez l’action Obtenir les prévisions du jour.

   

5. Dans l’action Obtenir les prévisions du jour, dans la zone Emplacement, sélectionnez Ajouter du contenu dynamique, puis sélectionnez Ville et Code postal.

   

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

   Paramètre de sortie	Type	Variable
   day_summary	Chaîne	Résumé de la journée
   location	Chaîne	Emplacement
   chance_of_rain	Nombre	Risque de pluie pendant la journée

   

7. Sélectionnez Enregistrer.

Gérer les connexions utilisées par le flux

Dans un agent authentifié pris en charge, les flux 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ératif ou appelés à partir d’un rubrique. Si vous utilisez le flux dans un canal pris en charge, cela ne nécessite aucune configuration spéciale dans votre boîte de dialogue agent, et les utilisateurs pourront gérer leurs connexions tout en utilisant agent.

Les flux 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 de l’utilisateur final dans le cadre de plans d’orchestration génératifs 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 Gâchette différent que vous souhaitez utiliser avec votre agent, vous pouvez modifier le flux pour utiliser l’action Exécuter un flux à partir de Copilot Gâchette et Répondre à Copilot réponse, et assurez-vous qu’il se trouve dans une solution dans le même environnement que le agent personnalisé.

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

2. Accédez à Mes flux sur le côté gauche et recherchez le flux.

3. Sélectionnez le flux.

   

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

Si votre flux n’inclut pas déjà les actions Copilot Gâchette et réponse, 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 renvoyer 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 tente de les exécuter. Au lieu de faire tourner le flux, le agent dira : "Quelque chose d’inattendu s’est produit. 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 Terminé.

   

Ajouter le flux à une solution

Pour être disponibles pour les agents, les flux doivent être stockés dans une solution dans le même Power Platform environnement. Si un flux se trouve dans une solution, une vignette Solutions sera visible sur la page des 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 suivant les étapes ci-dessous :

1. Accédez au portail Power Automate.

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

   Pour créer une solution, sélectionnez Nouvelle solution.

   

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

   

3. Dans l’onglet Solutions, accédez à la solution que vous souhaitez utiliser. Sélectionnez Ajouter existant pour y ajouter un flux.

   

4. Dans la page Ajouter un flux existant, sélectionnez l’onglet Depuis des solutions, sélectionnez votre flux, puis Ajouter.

   

   Pour déplacer un flux de l’onglet Mes flux à une solution, sélectionnez Solutions extérieures, puis sélectionnez Ajouter pour ajouter votre flux à la solution.

   

Contenu associé

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