Installer le kit d’agent Copilot

Copilot Agent Kit est une boîte à outils open source pour tester et évaluer les agents de 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 depuis Marketplace ou GitHub, ainsi que les étapes post-déploiement et les options de configuration.

Installer le kit d’agent Copilot depuis le Marketplace

Si vous préférez installer Copilot Agent Kit depuis GitHub, passez directement à Install Copilot Agent Kit depuis GitHub.

Déploiement depuis le Marketplace

Pour déployer le kit d’agent Copilot depuis le Marketplace, suivez ces étapes :

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

L’installation de l’agent Copilot Kit 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 d’agent Copilot depuis GitHub

Suivez ces étapes pour installer Copilot Agent Kit depuis GitHub. Si vous préférez installer depuis le Marketplace, allez sur Installer le kit d’agent Copilot 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 Power CAT Copilot Agent Kit.

Installer le fichier zip géré du Copilot Agent Kit

Pour installer la solution gérée du Copilot Agent Kit :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement où vous souhaitez installer le kit d’agent Copilot.
3. Accédez à Solutions.
4. Sélectionnez Importer la solution.
5. Cliquez sur Parcourir.
6. Sélectionnez le fichier CopilotStudioKit*_managed.zip.
7. Sélectionnez 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 Copilot Agent Kit, suivez ces étapes :

1. Connectez-vous à Power Apps.
2. Sélectionnez l’environnement où vous souhaitez améliorer le kit d’agent Copilot.
3. Accédez à Solutions.
4. Sélectionnez Importer la solution.
5. Cliquez sur Parcourir.
6. Sélectionnez CopilotStudioKit*_managed.zip.
7. Sélectionnez 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 Agent 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é.

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 d’agent Copilot, décrit précédemment 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 les agents dans Copilot Agent Kit, y compris comment configurer un nouvel agent 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 dans le locataire. Nécessite des autorisations de niveau administrateur Power Platform.
• Kit d’agent Copilot - 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 le kit d’agent Copilot, décrit précédemment 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

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

1. Installez le kit d’agent Copilot, décrit précédemment dans cet article.
2. Connectez-vous à Power Automate.
3. Assurez-vous que l’environnement avec le kit Copilot Agent est bien sélectionné.
4. Sélectionnez Solutions.
5. Sélectionnez le kit d’agent Copilot.
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 Compliance Hub, suivez les étapes de Configurer et configurer le Copilot Agent Kit Compliance Hub. 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 d’agent Copilot, décrit précédemment dans cet article.

2. TéléchargezConversation.KPIs.zip depuis le 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é Copilot Agent 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.

Découvrez comment configurer les agents dans Copilot Agent Kit, y compris comment configurer un nouvel agent pour les KPI de conversation.

Accédez à l’application Copilot Agent Kit

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

1. Connectez-vous à Power Apps et sélectionnez l’environnement où vous avez installé Copilot Agent Kit.
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.

Partagez l’application Copilot Agent Kit

Après avoir vérifié que l’application a bien été lancée, le propriétaire (ou l’administrateur système ayant installé le kit) doit partager l’application Copilot Agent Kit avec l’équipe.

1. Connectez-vous à Power Apps.
2. Sélectionnez Applications.
3. Cherchez « Copilot Agent Kit » et localisez celui avec le code de type (pas l’application modélisation).
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