Appeler une action pour saisir des données Dataverse for Teams
Grâce au nœud Appeler une action, les agents peuvent interagir avec les flux Power Automate. Ces flux vous permettent de déclencher des processus automatisés ou de vous connecter avec des données Dataverse for Teams, des listes Microsoft ou d’autres sources de données.
Par exemple, l’agent Event Contacts pourrait fournir les membres de l’équipe Sales Project à partir d’une table Dataverse for Teams. Au lieu de modifier l’agent lorsque des changements sont apportés à cette équipe, vous pouvez mettre à jour la table.
Étape 1 – Créer une table Dataverse for Teams
Pour créer une table Dataverse for Teams, procédez comme suit :
Créer une table Dataverse for Teams dans la même équipe que l’agent. N’oubliez pas que vous devrez la créer à l’aide de Power Apps pour Teams. Dans Power Apps pour Teams, cliquez sur l’onglet Création, puis sélectionnez votre équipe.
Cliquez sur Afficher tout sous le paramètre Éléments créés pour [nom de votre équipe] pour afficher la liste des solutions d’équipe. La liste des solutions d’équipe comprend l’ensemble des applications, agents, flux de cloud, tables, etc. créés dans Dataverse for Teams pour l’équipe sélectionnée. Si vous avez sélectionné la même équipe dans laquelle vous avez créé votre agent Event Contacts, vous la voyez dans la liste des solutions.
Dans le ruban Solution d’équipe en haut, cliquez sur Nouveau>Table.
Nommez votre nouvelle table Sales Project Team, puis cliquez sur Enregistrer. Les colonnes et les types de données à utiliser sont les suivants :
| Colonne | Type de données |
|---|---|
| Nom | Texte |
| Adresse e-mail |
Vous devez ajouter la colonne Adresse e-mail à votre table avant de passer à l’étape suivante.
Ajoutez de nouvelles lignes pour chacun des quatre contacts.
Nom Adresse e-mail Joseph Price JosephP@contoso.com Nathan Rigby NathanR@contoso.com Amber Rodriguez AmberR@contoso.com Monica Thomson MonicaT@contoso.com Ensuite, revenez à Microsoft Copilot Studio pour Teams.
Étape 2 : créer une rubrique d’agent avec une étape d’action
Pour ajouter une action, procédez comme suit :
Dans Microsoft Copilot Studio pour Teams, cliquez sur l’onglet Agents dans le ruban, puis recherchez/sélectionnez votre agent Event Contacts pour l’ouvrir.
Accéder à votre liste de Rubriques.
Créez une rubrique en cliquant sur Nouvelle rubrique>À partir de zéro dans le ruban Rubriques. Pour nommer la rubrique, cliquez sur Détails dans le ruban. Saisissez « Sales Project Team » dans le champ Nom.
Cliquez sur Phrases déclencheur, saisissez chacun des éléments suivants et appuyez sur + après chaque saisie :
sales project teamsales project infosales team infosales project memberssales project infoSur le canevas de création dans le nœud Message, saisissez :
Let me look up the Sales Project Team!
À présent, cliquez sur le bouton Enregistrer dans le ruban pour enregistrer votre rubrique. Toutes les modifications que vous n’enregistrez pas à ce stade peuvent être perdues lorsque vous passez à Power Automate pour créer le flux.
Ajoutez un nouveau nœud après le nœud Message, puis cliquez sur Appeler une action > Créer un flux. Copilot Studio peut vous présenter une zone d’options pour vous rappeler d’enregistrer votre rubrique avant de quitter. Si vous l’avez déjà enregistrée, cliquez sur Quitter. Cette action entraîne l’ouverture du studio Power Automate dans Copilot Studio.
Vous avez le choix entre plusieurs modèles courants disponibles immédiatement. Chacun permet de transmettre des informations au flux lorsqu’il est déclenché. Une fois le flux terminé, il peut transmettre des informations à l’agent. Si vous souhaitez consulter d’autres options de modèle, vous pouvez cliquer sur Afficher plus de modèles. Voici certains modèles notables :
Modèle de flux Copilot Studio : ce modèle ne comporte que les étapes permettant de recevoir des informations et d’en envoyer à l’agent.
Envoyer un message à un canal Teams : déclenchez un message Teams depuis l’agent.
Envoyer une carte adaptative à un canal Teams : déclenchez une carte adaptative pour fournir des informations dans un canal Teams.
Sélectionnez celle nommée Modèle de flux Copilot Studio. Ce faisant, votre déclencheur est Copilot Studio et vous disposez d’une étape en dessous nommée Renvoyer une ou plusieurs valeurs à Copilot Studio.
Redéfinissez le nom du flux sur Get Sales Team Members.
Créez une variable pour conserver les informations que vous souhaitez fournir à l’agent. Entre votre déclencheur et l’étape de renvoi de valeurs, déplacez votre curseur sur la flèche, cliquez sur l’icône Insérer une nouvelle étape qui s’affiche lorsque vous survolez cet espace et sélectionnez Ajouter une action.
Dans la zone de recherche, saisissez « variable », puis sous Actions, sélectionnez Initialiser la variable.
Saisissez « varContactInfo » pour le Nom, puis sélectionnez Chaîne pour le type. Laissez le champ Valeur vide.
À présent, nous avons besoin d’une étape pour accéder aux données de Dataverse depuis Teams. Sous votre nouvelle étape Initialiser la variable, cliquez sur l’icône Insérer une nouvelle étape, puis sélectionnez Ajouter une action. Recherchez le connecteur Microsoft Dataverse, puis sélectionnez Répertorier les lignes comme déclencheur.
Pour Nom de la table, sélectionnez Sales Project Team dans la liste déroulante. (Vous pouvez saisir « sales » dans le champ de saisie pour filtrer rapidement la liste.)
L’action Répertorier les lignes extrait toutes les lignes de la table dans un tableau. Un tableau est une table. Pour ajouter des données à votre variable de chaîne, vous devez parcourir chaque ligne de la table et ajouter chaque ligne de données à votre variable varContactInfo. C’est ainsi que nous transmettons ces données à Microsoft Copilot Studio.
Cliquez sur l’icône Insérer une nouvelle étape après Répertorier les lignes. Cliquez sur Ajouter une action.
Dans la zone de recherche, saisissez Contrôle, puis sous Actions, sélectionnez Appliquer à chacun.
Dans le champ Sélectionner une sortie des étapes précédentes, cliquez dessus pour ajouter du contenu dynamique. Sélectionnez ensuite la valeur value sous l’action Répertorier les lignes Dataverse.
Cliquez sur Ajouter une action dans l’étape Appliquer à chacun pour continuer.
Dans la zone de recherche Choisir une opération, saisissez variable, puis sous Actions, sélectionnez Ajouter à la variable de chaîne.
À l’étape Ajouter à la variable de tableau, sélectionnez varContactInfo pour le Nom.
Pour la Valeur, nous allons créer une liste à puces multiligne (sous forme de données de chaîne) avec le nom et l’adresse e-mail de chaque personne. Power Automate utilise la syntaxe Markdown lors de la mise en forme du texte. Pour indiquer une liste à puces dans Markdown, vous allez utiliser le caractère astérisque * au début de la ligne. (Pour en savoir plus sur Markdown, consultez la section Résumé à la fin de ce module.)
Dans la zone de texte Valeur :
Saisissez un astérisque *, puis ajoutez une espace.
Sous le contenu dynamique Répertorier les lignes, sélectionnez Name, puis ajoutez une espace.
Sous le contenu dynamique Répertorier les lignes, sélectionnez Email Address.
Appuyez sur Entrée pour commencer une nouvelle ligne.
Nous avons terminé cette étape.
Cliquez sur l’étape Renvoyer une ou plusieurs valeurs à Microsoft Copilot Studio en bas du flux, puis sur + Ajouter une sortie.
Sélectionnez Texte comme type de sortie.
Dans la zone de texte Entrer le titre, saisissez ContactData.
Pour le champ Entrer la valeur pour répondre, cliquez sur le champ de saisie, puis sélectionnez varContactInfo sous la section Variables.
Votre flux devrait maintenant ressembler à l’image suivante :
Cliquez sur Enregistrer dans le ruban Power Automate pour terminer la modification du flux. Power Automate exécute automatiquement le Vérificateur de flux à la recherche d’éventuels problèmes. Un message d’avertissement « …Requêtes de filtre OData... » peut s’afficher, mais vous pouvez l’ignorer. Des filtres OData vous permettent de limiter les données récupérées par votre étape Répertorier les lignes, mais nous n’avons que quelques lignes dans notre source de données, donc un filtre n’est pas nécessaire. Cliquez sur Fermer pour quitter Power Automate et revenir à l’éditeur d’agents.
De retour dans votre éditeur d’agents, examinez votre étape Action. Vous devriez voir le flux que vous venez de créer, à savoir Get Sales Team Members, comme action, et la variable de chaîne ContactData que vous avez créée répertoriée comme sortie.
Ajoutez une étape Afficher un message après le nœud Action.
Cliquez dans la zone de texte pour afficher le menu. Sélectionnez ContactData sous Insérer une variable {X}.
Cliquez sur Enregistrer dans le ruban d’édition de la rubrique et attendez que la rubrique soit enregistrée. Si le volet Copilote de test n’est pas visible, cliquez sur l’option de menu Tester votre copilote.
En haut du volet Tester le copilote, assurez-vous que l’option Suivi des rubriques est activée.
Saisissez l’une des phrases déclencheur pour tester votre agent Sales Project Team. Votre agent de test vous fournit une liste à puces des quatre noms et adresses e-mail de votre équipe Sales Project Team.
Félicitations ! Vous venez de créer une méthode permettant à votre agent d’accéder aux informations de tables de données au moyen d’un flux Power Automate intégré.