Créer un flux

  • Article

Important

Les capacités et les fonctionnalités de Power Virtual Agents font maintenant partie de Microsoft Copilot Studio, suite à des investissements significatifs dans l’IA générative et des intégrations améliorées dans Microsoft Copilot.

Certains articles et captures d’écran peuvent faire référence à Power Virtual Agents pendant que nous mettons à jour la documentation et le contenu de la formation.

Découvrez comment utiliser un flux cloud dans Microsoft Copilot Studio en donnant à un copilote la possibilité de produire une 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 allez appeler le flux en tant qu’action afin que le copilote puisse répondre avec les prévisions lorsqu’un client pose des questions sur la météo.

Vous pouvez créer un flux à utiliser avec un copilote ou modifier un flux existant. Pour convenir de copilotes, un flux Power Automate nécessite un déclencheur de flux Microsoft Copilot Studio et une action de réponse.

  • Déclencheur de flux : Lorsque Microsoft Copilot Studio appelle un flux

    Capture d’écran du déclencheur de flux Microsoft Copilot Studio.

  • Action de réponse : Renvoyer des valeurs à Microsoft Copilot Studio

    Capture d’écran de l’action de réponse de Microsoft Copilot Studio.

Lorsque vous créez un flux à partir du canevas de création Microsoft Copilot Studio, le déclencheur et l’action sont ajoutés pour vous. Lorsque vous modifiez un flux existant pour l’utiliser avec un copilote, vous devez ajouter le déclencheur Microsoft Copilot Studio et l’action de réponse.

Important

Pour utiliser les flux au sein de Copilot Studio, ils doivent répondre aux exigences suivantes :

  • Un flux ne peut être appelé qu’à partir d’un sujet situé dans le même environnement Microsoft Dataverse que votre copilote.

  • Les flux doivent également être dans une solution Power Automate. Vous pouvez déplacer les flux dans des solutions, afin qu’ils soient disponibles dans le canevas de création.

  • Les valeurs de flux doivent être renvoyées de manière synchrone vers Copilot Studio.

  • Un flux de cloud appelé depuis un copilote Copilot Studio dispose d’un délai d’attente de 100 secondes pour s’exécuter et revenir au copilote. Pour être en-dessous de la limite de 100 secondes, vous devez optimiser la logique du flux, les requêtes et les données renvoyées. Si une partie de la logique du flux de cloud peut continuer à s’exécuter après l’envoi d’un résultat au copilote, envisagez de placer ces actions après l’étape « Renvoyer les valeurs à Microsoft Copilot Studio » dans votre flux de cloud.

Conditions préalables

Créer un flux à utiliser avec un copilote

  1. Accédez à la page Sujets de votre copilote.

  2. Ouvrez le canevas de création du sujet à 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 des nœuds, sélectionnez Appeler une action, puis sélectionnez Créer un flux.

    Capture d’écran de l’option Créer un flux dans le menu Appeler une action.

    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 le copilote et utilise les mêmes informations d’identification d’utilisateur.

    Capture d’écran du modèle de flux Power Automate appelé depuis Microsoft Copilot Studio.

  5. Continuez à créer le flux dans Power Automate.

Modifier un flux existant à utiliser avec un copilote

Que se passe-t-il si vous disposez déjà d’un flux et que vous ne souhaitez pas en créer un à partir de zéro pour l’utiliser avec votre copilote ? Ajouter le déclencheur de flux et l’action de réponse Microsoft Copilot Studio vous-même. Vous pouvez ouvrir un flux existant pour le modifier de plusieurs manières.

Ouvrir un flux à partir du canevas de création

  1. Dans une rubrique ouverte dans le canevas de création Microsoft Copilot Studio, sélectionnez Ajouter un nœud (+).

  2. Sélectionnez Appeler une action.

  3. Sélectionnez Afficher les détails du flux sous le flux.

    Capture d’écran du bouton Modifier un flux dans le sélecteur d’action.

Ouvrir un flux depuis un nœud Action

  1. Dans un sujet ouvert dans le canevas de création Microsoft Copilot Studio, sélectionnez le nœud Action approprié.

  2. Sélectionnez Afficher les détails du flux.

    Capture d’écran du bouton Modifier un flux dans un nœud Action.

Ouvrir un flux dans Power Automate

  1. Accédez au portail Power Automate.

  2. Accédez à Solutions, puis sélectionnez Solution par défaut. Si vous avez déplacé votre flux vers une autre solution, sélectionnez celle-ci à la place.

    Capture d’écran de la Solution par défaut dans la liste Solutions.

  3. Sélectionnez le flux.

    Capture d’écran du flux Obtenir les prévisions météo dans la Solution par défaut.

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

Si votre flux n’inclut pas déjà le déclencheur de flux spécial Microsoft Copilot Studio et l’action de réponse, vous devez les ajouter avant de pouvoir utiliser le flux avec votre copilote.

  1. Sélectionnez Nouvelle étape.

  2. Recherchez le connecteur Microsoft Copilot Studio, puis sélectionnez Quand Microsoft Copilot Studio appelle un flux.

  3. Cliquez sur Nouvelle étape.

  4. Recherchez le connecteur Microsoft Copilot Studio et sélectionnez Renvoyer des valeurs à Microsoft Copilot Studio.

  5. Cliquez sur Enregistrer.

Créer le flux dans le portail Power Automate

Ajoutez maintenant des actions à votre flux. Dans l’exemple actuel, l’action que vous allez ajouter 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.

    Capture d’écran du nom du flux sélectionné.

  2. Ajoutez les paramètres d’entrée suivants au déclencheur de flux Microsoft Copilot Studio :

    • Ville (Texte)
    • Code postal (Nombre)

    Capture d’écran des paramètres d’entrée pour un flux Power Automate.

  3. Sélectionnez Ajouter une action pour créer une action sous le déclencheur de flux Microsoft Copilot Studio.

    Capture d’écran du bouton Ajouter une action de flux.

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

    Capture d’écran de l’action Obtenir les prévisions du jour sous le connecteur MSN Météo.

  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.

    Capture d’écran des variables ajoutées à l’action Obtenir les prévisions du jour.

  6. Dans l’action Renvoyer des valeurs à Microsoft Copilot Studio, ajoutez les paramètres et variables de sortie suivants :

    Nom du paramètre de sortie Type Variable
    day_summary String Résumé de la journée
    location String Emplacement
    chance_of_rain Chiffre Risque de pluie pendant la journée

    Capture d’écran des variables de sortie dynamiques ajoutées à l’action de réponse du flux.

  7. Cliquez sur Enregistrer.

La prochaine étape consiste à désactiver les réponses asynchrones dans votre flux.

Déplacer éventuellement le flux vers une autre solution

Pour être disponibles pour vos copilotes dans votre environnement, les flux doivent être stockés dans une solution dans Power Automate. Si vous ne souhaitez pas utiliser la Solution par défaut, vous pouvez déplacer vos flux vers une autre solution.

  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.

    Capture d’écran du bouton 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.

    Capture d’écran des propriétés de la solution.

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

    Capture d’écran du bouton Ajouter existant.

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

    Capture d’écran de la liste des flux existants dans les solutions.

    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.

    Capture d’écran de la liste des flux existants en dehors des solutions.

Désactiver les réponses asynchrones dans le flux

Les flux que vous souhaitez utiliser dans un copilote doivent renvoyer des valeurs en temps réel ou de manière synchrone. Les flux exécutés en arrière-plan ou de manière asynchrone peuvent provoquer une erreur lorsque votre copilote tente de les exécuter. Au lieu d’exécuter le flux, le copilote dira « 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 Microsoft 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, vous devrez modifier le paramètre.

  1. Ouvrez votre flux et recherchez l’étape Renvoyer des valeurs à Microsoft Copilot Studio.

  2. Sélectionnez l’icône Menu (...), puis sélectionnez Paramètres.

    Capture d’écran du menu des paramètres d’une action.

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

    Capture d’écran du bouton à bascule Réponse asynchrone.

Appeler le flux en tant qu’action.

En savoir plus sur les variables d’entrée et de sortie.