Installer Le Kit Copilot Studio

Copilot Studio Kit est un kit de ressources open source pour tester et évaluer les agents Copilot Studio. Par exemple, il vous permet de définir des cas de test, de simuler des requêtes utilisateur et de valider les réponses de l’agent. Cet article fournit des instructions étape par étape pour installer le kit depuis MarketplaceouGitHub, ainsi que des étapes post-déploiement et des options de configuration.

Installer le Copilot Studio Kit depuis le Marketplace

Si vous préférez installer Copilot Studio Kit à partir de GitHub, passez à l’installation de Copilot Studio Kit à partir de GitHub.

Déploiement depuis le Marketplace

Pour déployer Copilot Studio Kit depuis Marketplace, suivez ces étapes :

1. Naviguez vers le kit Copilot Studio sur le marché.
2. Sélectionner Obtenir maintenant.
3. Connectez-vous si nécessaire.
4. Dans la vue Installer Copilot Studio Kit , sélectionnez l’environnement dans lequel vous souhaitez déployer le Kit Copilot Studio.
5. Passez en revue les termes et les déclarations. Si vous acceptez, cochez les cases et sélectionnez Installer.

L’installation du Kit Copilot Studio commence.

Étapes post-déploiement (Marketplace)

Une fois l’installation terminée, procédez comme suit :

1. Connectez-vous à Power Apps.
2. Accédez à Solutions.
3. Sélectionnez Solution par défaut.
4. Sélectionnez Références de connexion.
5. Recherchez Copilot Studio Kit - Dataverse et ouvrez-le pour modification.
6. Vérifiez que tous les champs obligatoires sont remplis et que la connexion sélectionnée est valide. Créez une connexion à Dataverse si nécessaire.
7. Cliquez sur Enregistrer.
8. Suivez les étapes de configuration supplémentaires et facultatives.

Installer Copilot Studio Kit à partir de GitHub

Suivez ces étapes pour installer Copilot Studio Kit à partir de GitHub. Si vous préférez installer depuis le Marketplace, allez dans Installer le Kit Copilot Studio depuis le Marketplace.

Télécharger la dernière version de GitHub

Téléchargez la dernière version de la solution gérée pour le Kit Power CAT Copilot Studio.

Installer le fichier zip managé CopilotStudioKit

Pour installer la solution managée Copilot Studio Kit :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement dans lequel vous souhaitez installer Copilot Studio Kit.
3. Accédez à Solutions.
4. Sélectionnez Importer la solution.
5. Cliquez sur Parcourir.
6. Sélectionnez le fichier CopilotStudioKit*_managed.zip.
7. Cliquez sur Suivant.
8. Après avoir examiné les informations sur la solution, sélectionnez Suivant.
9. Si vous y êtes invité, créez les connexions requises, puis sélectionnez Importer.
10. Laissez les valeurs du rapport sur les KPI de conversation telles quelles pour l’instant. Vous pouvez mettre à jour ces valeurs ultérieurement.
11. Attendez la fin de l’opération d’importation.

Mettre à niveau une solution existante (GitHub)

Si vous avez installé une version antérieure du Kit Copilot Studio et que vous souhaitez effectuer une mise à niveau vers la dernière version, procédez comme suit :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement dans lequel vous souhaitez mettre à niveau Copilot Studio Kit.
3. Accédez à Solutions.
4. Sélectionnez Importer la solution.
5. Cliquez sur Parcourir.
6. Sélectionnez CopilotStudioKit*_managed.zip.
7. Cliquez sur Suivant. Power Apps reconnaît que cette mise à niveau est une solution managée existante.
8. Vérifiez que vous souhaitez mettre à niveau la solution existante en sélectionnant Suivant.
9. Laissez les valeurs du rapport sur les KPI de conversation telles quelles pour l’instant. Vous pouvez mettre à jour ces valeurs ultérieurement.
10. Cliquez sur Importer.

Étapes de configuration supplémentaires et facultatives

Ces étapes de configuration s’appliquent que vous ayez installé le Copilot Studio Kit depuis Marketplace ou GitHub.

Configurer la synchronisation SharePoint

Les étapes suivantes sont facultatives et requises uniquement si vous envisagez d’utiliser la fonctionnalité de synchronisation SharePoint . Vous pouvez définir ces valeurs à tout moment avant d’utiliser la fonctionnalité.

Pointez la connexion à SharePoint vers le site SharePoint source. Pointez l’URL Dataverse vers l’instance Dataverse pour les agents personnalisés cibles où le contenu se synchronise.

Vous pouvez suivre ces étapes ou utiliser l’Assistant de configuration pour configurer la référence de connexion SharePoint.

Pour utiliser la fonctionnalité de synchronisation SharePoint :

1. Installez Copilot Studio Kit, décrit plus haut dans cet article.
2. Connectez-vous à Power Apps.
3. Accédez à Solutions.
4. Sélectionnez Solution par défaut.
5. Sélectionnez Références de connexion.
6. Recherchez la référence de connexion Copilot Studio Kit - SharePoint et ouvrez-la pour modification.
7. Vérifiez que tous les champs requis sont renseignés et que la connexion sélectionnée est valide. Créez une connexion à SharePoint en fonction des besoins.
8. Cliquez sur Enregistrer.

Plus d’informations : Découvrez comment configurer des agents dans Copilot Studio Kit, notamment comment configurer un nouvel agent pour la synchronisation de fichiers.

Configurer l’inventaire de l’agent

Les étapes suivantes sont facultatives et requises uniquement si vous envisagez d’utiliser la fonctionnalité Inventaire de l’agent . Vous pouvez définir ces valeurs à tout moment avant d’utiliser la fonctionnalité.

Les références de connexion dans la solution contrôlent la visibilité des agents. Bien que vous puissiez utiliser d’autres comptes, utilisez ces autorisations pour obtenir une visibilité totale.

• Kit Copilot Studio - Power Platform for Admins récupère la liste des environnements dans le client. Nécessite des autorisations de niveau administrateur Power Platform.
• Copilot Studio Kit - Dataverse collecte les informations de l’agent à partir des environnements. Nécessite des autorisations au niveau de l’administrateur système pour tous les environnements.

Vous pouvez suivre ces étapes ou utiliser l’Assistant de configuration pour configurer les références de connexion de l’inventaire des agents.

Pour utiliser la fonctionnalité Inventaire de l’agent :

1. Installez Copilot Studio Kit, décrit plus haut dans cet article.
2. Connectez-vous à Power Apps.
3. Accédez à Solutions.
4. Sélectionnez Solution par défaut.
5. Sélectionnez Références de connexion.
6. Recherchez la référence de connexion copilot Studio Kit - Power Platform for Admins et ouvrez-la pour modification.
7. Vérifiez que tous les champs requis sont remplis et que la connexion sélectionnée est valide.
8. Cliquez sur Enregistrer.
9. Recherchez la référence de connexion Copilot Studio Kit - Dataverse et ouvrez-la pour modification.
10. Vérifiez que tous les champs requis sont remplis et que la connexion sélectionnée est valide.
11. Cliquez sur Enregistrer.

Activer les métriques d’utilisation

Pour activer les métriques d’utilisation facultatives dans l’inventaire de l’agent, procédez comme suit :

1. Vérifiez que le connecteur HTTP avec l’ID Microsoft Entra (pré-autorisé) est autorisé dans votre environnement.
2. Importez le fichier AgentInventoryUsage*_managed.zip à partir du dépôt GitHub du Kit Power CAT Copilot Studio.
3. Pendant le processus d’importation, créez une connexion à l’aide de l’URL de l’hôte de licence : https://licensing.powerplatform.microsoft.com/

Activer les flux

Pour activer les flux cloud inclus dans le Copilot Studio Kit, suivez ces étapes ou utilisez l’Assistant de configuration.

1. Installez Copilot Studio Kit, décrit plus haut dans cet article.
2. Se connecter à Power Automate.
3. Vérifiez que l’environnement avec le kit Copilot Studio est sélectionné.
4. Sélectionnez Solutions.
5. Sélectionnez Copilot Studio Kit.
6. Cliquez sur Flux de cloud.
7. Vérifiez que tous les flux sont activés (État = Activé).
8. Activez tous les flux qui ne sont pas activés, dans l’ordre suivant :
   1. Les flux qui se terminent par Grandchild.
   2. Flux qui se terminent par Enfant.
   3. Les autres flux selon les nécessités, dans n’importe quel ordre.

Mettre en place un Compliance Hub

Pour configurer le Compliance Hub, suivez les étapes de Configurer et configurer le Copilot Studio Kit Compliance Hub. Le Compliance Hub exige l’inventaire des agents.

Configurer le tableau de bord KPI de conversation intégré

Ces étapes sont requises uniquement si vous avez l'intention d'utiliser le tableau de bord des KPIs de conversation incorporé.

Pendant les étapes, notez les valeurs suivantes :

• Nom de l’espace de travail
• Espace de travail GUID
• Nom de l’état
• GUID de rapport

Publier le rapport

Pour publier le rapport des indicateurs clés de performance de la conversation :

1. Installez Copilot Studio Kit, décrit plus haut dans cet article.

2. Téléchargez Conversation.KPIs.zip à partir du dépôt GitHub de Power CAT Copilot Studio Kit.

3. Extrayez le contenu du fichier .zip.

4. Ouvrez le fichier KPI.pbit conversation dans l’application Power BI Desktop.

5. Entrez l’URL dataverse comme URL d’environnement dans la boîte de dialogue qui s’affiche et sélectionnez Charger (par exemple, org3c23948.crm.dynamics.comsans préfixe https:// ).

   Si la boîte de dialogue n’apparaît pas, entrez l’URL de l’environnement dans Accueil>Transformez les données>Modifiez les paramètres.

6. Actualisez les données et connectez-vous en fonction des besoins.

7. Enregistrez et publiez dans un espace de travail.

8. Notez le nom du rapport et le nom de l’espace de travail.

9. Connectez-vous à Power BI.

10. Ouvrez le rapport que vous avez publié et notez le GUID de l’espace de travail et le GUID de rapport dans l’URL.

    Si vous publiez sur « Mon espace de travail », le GUID de l’espace de travail est 00000000-0000-0000-0000-000000000000.

11. Sélectionnez les trois points (...) puis Afficher le modèle sémantique.

12. Ouvrezles paramètres>.

13. Vérifiez que les informations d’identification de la source de données n’ont aucun problème. Connectez-vous pour résoudre les problèmes.

14. Accédez à Actualiser et définissez la planification d’actualisation.

Mettre à jour la variable d’environnement de rapport

Pour configurer le tableau de bord des indicateurs clés de performance de conversation intégrés, mettez à jour la variable d’environnement associée avec les identificateurs appropriés. Vous pouvez soit suivre ces étapes, soit utiliser l’Assistant de configuration.

1. Connectez-vous à Power Apps et sélectionnez l’environnement où vous avez installé Copilot Studio Kit.
2. Sélectionnez Solutions>Solution par défaut.
3. Sélectionnez Variables d’environnement.
4. Recherchez et sélectionnez Rapport des KPIs de Conversation.
5. Remplacez les espaces réservés dans la valeur par défaut par le nom de l’espace de travail, le GUID de l’espace de travail, le nom du rapport et les valeurs GUID de rapport que vous avez notées pendant le processus de publication.
6. Cliquez sur Enregistrer.

Plus d’informations : Découvrez comment configurer des agents dans Copilot Studio Kit, notamment comment configurer un nouvel agent pour les indicateurs de performance clés conversation.

Accéder à l’application Copilot Studio Kit

Pour accéder à l’application Copilot Studio Kit :

1. Connectez-vous à Power Apps et sélectionnez l’environnement où vous avez installé Copilot Studio Kit.
2. Accédez à Applications.
3. Recherchez et sélectionnez le Power CAT Copilot Studio Kit.
4. Sélectionnez Lire.
5. (Facultatif) Ajouter aux favoris l’application.

Étape suivante