Créer des plug-ins à code faible à utiliser avec un copilote (préversion)

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Les actions copilot sont un moyen d’étendre les fonctionnalités de vos bots copilotes. Avec les actions d’IA générative Copilot, vous créez des actions personnalisées déclenchées par votre bot copilot. Ces actions sont utilisées pour effectuer un large éventail de tâches, telles que l’envoi d’e-mails, la création d’enregistrements dans Microsoft Dataverse ou l’appel d’API externes. Dans cet article, vous créez un plug-in à faible code de base qui ajoute deux entiers ensemble et un plug-in plus complexe qui peut être utilisé pour envoyer une notification qui peut être utilisée pour créer une action dans Microsoft Copilot Studio.

Important

• Les plug-ins low-code instantanés ne sont plus prioritaires et ne sont pas fournis en tant que fonctionnalité. Les plug-ins low-code instantanés sont remplacés par des fonctions. Pour plus d’informations, voir Fonctions dans Microsoft Dataverse (version préliminaire)
• Il s’agit d’une fonctionnalité en préversion.
• Les fonctionnalités d'évaluation ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent obtenir un accès anticipé et fournir des commentaires.

Conditions préalables à l’utilisation du plug-in avec Microsoft Copilot

Avant de commencer, assurez-vous que vous avez les conditions préalables suivantes :

• Accès à un environnement Dataverse qui inclut l’application Dataverse Accelerator pour créer des plug-ins à code faible.
• Accédez à Copilot Studio dans le même environnement que votre environnement Dataverse.

Exemple de plug-in low-code de base

Dans cet exemple, vous créez un plug-in instantané à code faible qui ajoute deux nombres et retourne la somme de ces nombres. Vous créez ensuite une action Copilot qui appelle ce plug-in à code faible pour effectuer l’ajout. Le copilote que vous créez fonctionne pour les nombres et les requêtes de texte arbitraires qui contiennent des nombres et des fractions écrits en toutes lettres.

Pour créer votre plug-in instantané à faible code de base, procédez comme suit :

1. Ouvrez l’application Dataverse Accelerator dans votre environnement Dataverse en accédant à>Apps All>Dataverse Accelerator App , puis sélectionnez Play.

2. Dans l’application Dataverse Accelerator, sélectionnez Nouveau plug-in et sélectionnez Plug-in instantané.

3. Entrez un nom d’affichage descriptif pour votre plug-in. Par exemple Somme des nombres, puis sélectionnez Créer.

4. Dans la section Paramètres :

   • Ajoutez les paramètres d’entrée suivants :
     • Nom du paramètre : Number1, Type : Float
     • Nom du paramètre : Number2, Type : Float
   • Ajoutez le paramètre de sortie suivant :
     • Nom du paramètre : Résultat, Type : Float

5. Dans la section Expression , entrez le code suivant :

   {Result: Number1 + Number2}
   

   

6. Sélectionnez Enregistrer pour enregistrer votre plug-in.

Créer un adjoint pour appeler votre plug-in simple avec peu de code

Accédez à Copilot Studio et ouvrez l’environnement avec le plug-in.

1. Créez un copilote. Plus d’informations : Créer et configurer des plug-ins copilot
2. Activez les actions de génération sur le copilote. Plus d’informations : Activer les actions génératives
3. Ajoutez une action d’IA générative. Lorsque vous ajoutez l’action, recherchez « Effectuer une action indépendante dans l’environnement sélectionné » et sélectionnez l’action. Plus d’informations : Utiliser des actions génératives dans Microsoft Copilot Studio
4. Configurez l’action avec les détails suivants :
   • Ajoutez une description de modèle qui permet au copilote de savoir quand appeler cette action. Utilisez l’anglais brut pour décrire les conditions dans lesquelles cette action doit être appelée. Par exemple, vous pouvez entrer « Ajoute des nombres et retourne la somme de ces nombres à partir de deux valeurs à virgule flottante ». Pour plus d'informations : Descriptions de création
   • Utilisez ces entrées :
     • Changez comment le copilote remplira cette entrée pour que le paramètre Organisationsoit défini comme valeur.
     • Sélectionnez votre environnement actuel (l’environnement dans lequel vous avez créé votre plug-in à code faible) comme valeur pour le paramètre Organisation .
     • Changez comment le copilote remplira cette entrée pour que le paramètre Nom de l’actionsoit défini comme valeur.
     • Sélectionnez le plug-in à code faible que vous avez créé comme valeur pour le paramètre Nom de l’action . Si vous ne savez pas quel est le nom de votre plug-in, vous pouvez le trouver dans l’application Accélérateur Dataverse en le sélectionnant dans la liste et en sélectionnant Copier l’extrait de code , puis en collant le code dans un éditeur de texte.
   • Entrées supplémentaires :
     • Ajoutez les paramètres d’entrée suivants. L’ajout d’entrées supplémentaires n’affiche actuellement pas les détails dans Copilot Studio. Vous pouvez vérifier que les entrées ont été ajoutées correctement en sélectionnant Ouvrir le code modifier et examiner le code, ce qui doit afficher les entrées supplémentaires sous la section entrées de l’action YAML :
       • Nom du paramètre : Number1
       • Nom du paramètre : Number2
5. Enregistrez et publiez le copilote.

Tester l'action de votre copilote

Suivez ces étapes dans le volet Copilot de test dans Copilot Studio.

1. Sélectionnez l’icône sparkle en haut de la fenêtre de conversation pour démarrer le mode de suivi. Cela vous permet de confirmer que votre action est appelée et vérifie les entrées et sorties de votre action. Plus d’informations : Tester votre copilote à l’aide d’actions génératives
2. Entrez le texte dans la fenêtre de conversation Ajouter 5.2 et 10.3 , puis sélectionnez Envoyer.

Si tout est configuré correctement, vous voyez le résultat attendu de la sortie 15.5 dans la fenêtre de conversation et le volet de trace affiche les entrées et sorties de votre action. Le volet de trace ressemble à l’exemple suivant. Vous pouvez essayer d’autres instructions pour tester l’action davantage et modifier la langue pour voir comment l’action répond. Voici quelques exemples :

• Si j’ai 3 pommes et mon ami me donne 4 autres, combien de pommes ai-je au total ?
• Si j’ai 1/2 livres de fromage et que je commande un autre 1/4 livres, combien de fromage ai-je total ?

Exemple de plug-in d’envoi de notification à faible code

Dans cet exemple, vous créez un plug-in instantané à code faible qui encapsule une API existante à utiliser avec un copilote. L’action envoie une notification à l’utilisateur spécifié dans l’action copilote lorsque l’utilisateur qui crée l’action le teste dans Copilot Studio. Le copilote détermine les paramètres requis de la requête en langage brut de l’utilisateur et envoie une notification à l’aide d’un plug-in Dataverse low-code à une application pilotée par modèle dans Power Apps.

Pour créer votre plug-in instantané à faible code, procédez comme suit :

1. Ouvrez l’application Dataverse Accelerator dans votre environnement Dataverse en accédant à>Toutes les applications> Dataverse Accelerator App et sélectionnez exécuter.

2. Dans l’application Accélérateur Dataverse, sélectionnez Nouveau plug-in, puis sélectionnez Plug-in instantané.

3. Entrez un nom d’affichage descriptif pour votre plug-in. Par exemple, envoyez une notification dans l’application à l’utilisateur et sélectionnez Créer.

4. Dans la section Paramètres :

   • Ajoutez les paramètres d’entrée suivants :
     • Nom du paramètre : UserName, Type : Chaîne
     • Nom du paramètre : Titre, Type : Chaîne
     • Nom du paramètre : corps, type : chaîne
     • Nom du paramètre : URL, Type : Chaîne
   • Ajoutez le paramètre de sortie suivant :
     • Nom du paramètre : Résultat, Type : Chaîne

5. Dans la section Expression , entrez le code suivant. Notez que nous encapsulons l’API existante XSendAppNotification avec le plug-in pour permettre de trouver des utilisateurs par nom. Ce comportement est utile lorsqu’il est appelé depuis le copilote, qui ne peut fournir que les informations que l’utilisateur connaît sur la personne et non les identifiants plus ésotériques des enregistrements attendus par l’API sous-jacente :

   XSendAppNotification(Title,
   First(Filter(Users, UserName in 'Full Name')), 
   Body,
   [XCreateUrlAction("Click Here", Url)]
   );
   {Result: "Success"}
   

   

6. Sélectionnez Enregistrer pour enregistrer votre plug-in.

Créer un copilote pour appeler votre plug-in d’envoi de notification à faible code

Accédez à Copilot Studio et ouvrez l’environnement avec le plug-in.

1. Créez un copilote. Plus d’informations : Créer et configurer des plug-ins copilot
2. Activez les actions de génération sur le copilote. Plus d’informations : Activer les actions génératives
3. Ajoutez une action d’IA générative. Lorsque vous ajoutez l’action, recherchez « Effectuer une action indépendante dans l’environnement sélectionné » et sélectionnez l’action. Plus d’informations : Utiliser des actions génératives dans Microsoft Copilot Studio
4. Configurez l’action avec les détails suivants :
   • Ajoutez une description de modèle qui permet au copilote de savoir quand appeler cette action. Utilisez l’anglais brut pour décrire les conditions dans lesquelles cette action doit être appelée. Par exemple, vous pouvez entrer « Appelle une API Dataverse pour envoyer une notification à un utilisateur dans Dataverse afin de lui rappeler ou de l'avertir d’un élément important, accompagné d'un titre, d'un message et éventuellement d'un lien pour plus de détails ». Plus d'informations : Descriptions de création
   • Utilisez ces entrées :
     • Changez comment le copilote remplira cette entrée pour que le paramètre Organisationsoit défini comme valeur.
     • Sélectionnez votre environnement actuel dans la liste déroulante (l’environnement dans lequel vous avez créé votre plug-in à code faible) comme valeur pour le paramètre Organisation . Vous devez placer votre curseur dans la zone de texte pour que la liste des environnements disponibles s’affiche.
     • Changez comment le copilote remplira cette entrée pour que le paramètre Nom de l’actionsoit défini comme valeur.
     • Sélectionnez le plug-in à code faible que vous avez créé comme valeur pour le paramètre Nom de l’action . Vous devez placer votre curseur dans la zone de texte pour que la liste des API disponibles s’affiche. La valeur à entrer ici est le nom du schéma du plug-in low-code, tel que org_SendInAppNotificationToUser. Si vous ne savez pas quel est le nom de schéma de votre plug-in, vous pouvez le trouver dans l’application Accélérateur Dataverse en le sélectionnant dans la liste et en sélectionnant Copier l’extrait de code , puis en collant le code dans un éditeur de texte.
   • Entrées supplémentaires :
     • Sélectionnez Ajouter et ajouter les paramètres d’entrée suivants. Notez que l’ajout d’entrées supplémentaires n’affiche actuellement pas les détails dans Copilot Studio. Il s’agit d’un problème connu. Vous pouvez vérifier que les entrées ont été ajoutées correctement en sélectionnant Ouvrir le code modifier et examiner le code, ce qui doit afficher les entrées supplémentaires sous la section entrées de l’action YAML :
       • Nom du paramètre : UserName
       • Nom du paramètre : Titre
       • Nom du paramètre : corps
       • Nom du paramètre : URL
5. Enregistrez et publiez le copilote.

Tester votre action de copilote pour l'envoi de notifications

Suivez ces étapes dans le volet Copilot de test dans Copilot Studio.

1. Sélectionnez l’icône sparkle en haut de la fenêtre de conversation pour démarrer le mode de suivi. Cela vous permet de confirmer que votre action est appelée et vérifie les entrées et sorties de votre action. Plus d’informations : Tester votre copilote à l’aide d’actions génératives
2. Entrez le texte dans la fenêtre de conversation Envoyer une notification à mon utilisateur pour extraire cette URL https://copilotstudio.microsoft.com, puis sélectionnez Envoyer.

Si tout est configuré correctement, vous voyez qu’une notification a été envoyée dans le volet Copilot de test . La notification est envoyée en tant que notification basée sur un modèle dans l’application lorsque l’utilisateur spécifié lit l’application.

Vous pouvez essayer d’autres invites pour tester l’action davantage et vous pouvez modifier le plugin pour qu’il soit plus intelligent dans la façon dont il recherche les utilisateurs ayant reçu un nom pour voir comment l’action répond. Par exemple, vous pouvez ajouter une étape pour rechercher l’utilisateur par adresse e-mail si le nom ne retourne pas de résultat.

Voir aussi

Utiliser des plug-ins à code faible dans Dataverse