Installer le kit d’agent Copilot

Le kit assistant Copilot est une boîte à outils open source pour tester et évaluer les assistants Copilot Studio. Par exemple, il vous aide à définir des cas de test, à simuler des requêtes utilisateur et à valider les réponses de l’agent. Cet article fournit des instructions étape par étape pour installer le kit à partir de Marketplace ou GitHub, ainsi que des étapes après le déploiement et des options de configuration.

Note

Avant de télécharger et d’installer le kit assistant Copilot, assurez-vous que tous les prérequis sont remplis.

Installer le kit assistant Copilot depuis Marketplace

Si vous préférez installer le kit assistant Copilot depuis GitHub, passez directement à Installer le kit assistant Copilot à partir de GitHub.

Déploiement depuis le Marketplace

Pour déployer le kit assistant Copilot depuis Marketplace, procédez comme suit :

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

L’installation du kit assistant Copilot 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. Localiser le kit d’agent Copilot - Dataverse et l’ouvrir pour la 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 le kit assistant Copilot à partir de GitHub

Pour installer le kit assistant Copilot à partir de GitHub, procédez comme suit. Si vous préférez installer depuis Marketplace, allez dans Installer le Kit assistant Copilot depuis 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 Power CAT Copilot Agent Kit.

Installer le fichier ZIP managé Copilot Agent Kit

Pour installer la solution gérée du kit d’agent Copilot :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement où vous souhaitez installer le kit assistant Copilot.
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)

Pour passer à la dernière version du Kit assistant Copilot, suivez ces étapes :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement où vous souhaitez mettre à niveau le kit assistant Copilot.
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.

Note

Lors de la mise à jour du Copilot Agent Kit, vous pourriez rencontrer l’erreur suivante : Solution « Power CAT Copilot Agent Kit » n’a pas importé : ImportAsHolding a échoué avec exception : Impossible de supprimer l’attribut : cat_copilottestrunid d’Entity : cat_CopilotTestRun puisque l’attribut n’est pas un champ personnalisé.

Ce problème est connu et en cours d’investigation. Pour contourner ce problème, préparez la mise à niveau avant de l’appliquer. En savoir plus sur la mise à niveau ou la mise à jour d’une solution.

Étapes de configuration supplémentaires et facultatives

Peu importe si vous avez installé le kit assistant Copilot à partir de Marketplace ou de GitHub, ces étapes de configuration s’appliquent.

Tip

Le kit assistant Copilot comprend un assistant de configuration permettant de configurer les références de connexion, les variables d’environnement et les flux de cloud. En savoir plus dans Utilisation de l’Assistant Installation.

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é.

Dirigez la connexion SharePoint vers le site source SharePoint. 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 Setup pour configurer la référence de connexion SharePoint.

Pour utiliser la fonctionnalité de synchronisation SharePoint :

1. Installez le kit assistant Copilot, 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. Localisez la référence de connexion Copilot Agent Kit - SharePoint et ouvrez-la pour édition.
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 assistants dans le kit assistant Copilot, notamment comment configurer un nouvel assistant pour la synchronisation des 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.

• Copilot Agent Kit - Power Platform for Admins récupère la liste des environnements du locataire. Nécessite des autorisations de niveau administrateur Power Platform.
• Kit d’agents Copilot - Dataverse collecte les informations sur les agents depuis les 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.

Une fois les références de connexion configurées, vous configurez le périmètre de l’environnement, les types d’agents, les groupes d’environnement, les options d’inventaire et le planning de synchronisation depuis l’Agent Inventory. Pour plus d’informations, consultez Configurer l’inventaire de l’agent.

Pour utiliser la fonctionnalité Inventaire de l’agent :

1. Installez le kit assistant Copilot, 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. Localisez la référence de connexion Copilot Agent Kit - Power Platform for Admins et ouvrez-la pour la 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. Localisez la référence de connexion Copilot Agent Kit - Dataverse et ouvrez-la pour édition.
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 flux

Note

Si vous envisagez d’utiliser la synchronisation SharePoint, configurez la synchronisation SharePoint avant d’activer les flux associés (les noms commencent par la synchronisation SharePoint).

Pour activer les flux de cloud inclus dans le kit assistant Copilot, procédez comme suit ou utilisez l’Assistant Installation.

1. Installez le kit assistant Copilot, décrit plus haut dans cet article.
2. Connectez-vous à Power Automate.
3. Vérifiez que l’environnement avec le kit assistant Copilot est sélectionné.
4. Sélectionnez Solutions.
5. Sélectionnez Copilot Agent Kit.
6. Sélectionnez 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 hub de conformité, suivez les étapes de Configurer et définir le hub de conformité du kit assistant Copilot. Le Compliance Hub exige l’inventaire des agents.

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

Suivez ces étapes uniquement si vous envisagez d’utiliser le tableau de bord incorporé des KPI de conversation.

Pendant les étapes, notez les valeurs suivantes :

• Nom de l’espace de travail
• Espace de travail GUID
• Nom du rapport
• GUID de rapport

Publier le rapport

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

1. Installez le kit assistant Copilot, décrit plus haut dans cet article.

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

3. Extrayez le contenu du fichier .zip.

4. Ouvrez le fichier Conversation KPIs.pbit 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é le kit assistant Copilot.
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.

Découvrez la configuration des assistants dans le kit assistant Copilot, notamment comment configurer un nouvel assistant pour les indicateurs clés de performance de conversation.

Accédez à l’application du kit d’agent Copilot

Pour accéder à l’application du kit assistant Copilot :

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

Partager l’application Copilot Agent Kit

Après avoir vérifié que l’application se lance correctement, le propriétaire (ou l’administrateur système ayant installé le Kit) doit partager l’application du kit assistant Copilot avec l’équipe.

1. Connectez-vous à Power Apps.
2. Sélectionnez Applications.
3. Recherchez « Copilot Agent Kit » et repérez celui de type Code (et non l’application pilotée par modèle).
4. Sélectionnez les trois points (...), puis sélectionnez Partager en regard du nom de l’application.
5. Recherchez et ajoutez les utilisateurs ou les groupes de sécurité qui ont besoin d’un accès.
6. Sélectionnez Partager pour confirmer.

En savoir plus dans Partager une application canevas avec votre organisation.

Étape suivante

Configurer des utilisateurs et des équipes