Partager via

Clonez votre agent Microsoft Copilot Studio dans Microsoft Visual Studio Code

Lorsque vous clonez un agent à partir de Microsoft Copilot Studio à l’aide de l’extension, vous téléchargez la définition de l’agent et les définitions de composants associées à partir de Copilot Studio sur votre ordinateur local. Vous pouvez modifier ces fichiers à l’aide de Microsoft Visual Studio Code. L’opération de clonage crée un espace de travail local avec tous les fichiers agents dans un format de répertoire structuré.

Prerequisites

Avant de commencer à cloner des agents, il y a quelques prérequis et considérations importantes.

Choisissez un lieu de travail

Sélectionnez un dossier local approprié pour vos fichiers d’agent. C’est à cet endroit que l’extension sauvegarde les fichiers agents. Voici quelques conseils importants pour choisir un lieu :

  • Assurez-vous d’un espace disque suffisant. Un agent typique peut varier en taille selon le nombre de composants.
  • Utilisez un chemin sans espaces si possible, bien que les espaces soient pris en charge.
  • Envisagez d’utiliser un emplacement déjà suivi par Git.

Comprendre ce qui est cloné

Lorsque vous clonez un agent, les fichiers de l’agent sont clonés localement à l’emplacement que vous choisissez, en créant une définition de structure comme celle-ci dans l’Explorateur Visual Studio Code :

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Méthodes de clonage

Si vous utilisez l'extension pour la première fois, ou même si vous débutez avec Visual Studio Code, le moyen le plus simple de cloner un agent consiste à sélectionner Clone Agent lorsque le volet Extension est ouvert. Cependant, cette option n’est pas disponible lorsque vous avez déjà un Agent cloné et ouvert localement. Les méthodes suivantes peuvent être utilisées à la place :

C’est la méthode la plus simple et la plus recommandée pour cloner un agent.

  1. Ouvrez l’extension Copilot Studio en sélectionnant l’icône Copilot Studio dans la barre d’activité. Vous pouvez également appuyer sur Ctrl+Shift+P et entrer « Copilot Studio : Focus on Agents View ». Le volet Copilot Studio s’ouvre dans la barre latérale.

  2. Dans le panneau Agents , sélectionnez votre environnement cible dans la liste déroulante (par exemple, « Environnement 1 ») pour voir la liste des agents présents dans l’environnement.

    > Environment 1
  Environment 2
  Environment 3

  3. Sélectionnez l’agent à cloner dans la liste. Les agents affichent leur dernière date modifiée. Faites un clic droit sur le nom de l’agent et sélectionnez Cloner l’agent.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Une boîte de dialogue de sélection de fichiers s’ouvre.

  4. Naviguez vers l’emplacement souhaité dans la boîte de dialogue du sélecteur de fichiers ou créez un nouveau dossier et sélectionnez Sélectionner le dossier. Le processus de clonage commence.

  5. Attends que le processus de clonage soit terminé. Une notification de progression apparaît affichant « Agent de clonage : Bot de support client », suivie d’un message de réussite « Agent cloné avec succès ». Ce processus prend généralement entre 10 et 30 secondes.

  6. Vérifiez que le clonage a été réalisé avec succès. Le dossier de l’agent s’ouvre dans l’explorateur Visual Studio Code, le volet de contrôle de code source affiche une arborescence de travail propre et la fenêtre de fichier affiche le nom de votre dossier.

Méthode 3 : Cloner en utilisant la palette de commandes

Utilisez cette méthode si vous préférez des flux de travail axés sur le clavier.

  1. Ouvrez la palette de commandes en appuyant sur Ctrl+Shift+P.

  2. Tapez « Copilot Studio : Clone Agent », puis appuyez sur Enter. La commande s’exécute et des messages d'invite apparaissent.

  3. Suivez les instructions pour sélectionner votre environnement, sélectionnez l’agent, choisissez le dossier de destination, et attendez que le clonage soit terminé. L’agent est cloné à l’emplacement que vous avez choisi.

Méthode 3 : Cloner à l’aide de l’URL de l’agent

Cette méthode est utile lorsque quelqu’un partage une URL d’agent avec vous.

  1. Ouvrez votre agent dans le portail web Copilot Studio.

  2. Sélectionnez>Paramètres Détails de l’agent, et copiez l’URL de l’agent. L’URL doit avoir le format : https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. L’URL est maintenant dans votre clipboard.

  3. Revenez à Visual Studio Code et ouvrez l’extension Copilot Studio.

  4. Sélectionnez Agent clone. L’extension détecte l’URL dans votre presse-papiers et affiche l’agent marqué comme « (depuis le clipboard) ».

  5. Sélectionnez l’agent marqué « (depuis le clipboard), sélectionnez un dossier de destination, et attendez que le clonage soit terminé. L’agent est cloné à l’emplacement que vous avez choisi.

Scénarios courants de clonage

Voici quelques scénarios courants où cloner des agents est utile, avec des détails généraux sur le flux de travail suggéré.

Scénario 1 : Clone pour le développement solo

Objectif : Utiliser un assistant par vous-même

  1. Clonez l’agent dans un dossier local.

  2. Initialiser un dépôt Git depuis le Contrôle de Sources dans la navigation.

  3. Apportez des modifications localement.

  4. Faites vos engagements.

  5. Appliquez les modifications à Copilot Studio lorsque vous êtes prêt.

Scénario 2 : Clone pour la collaboration en équipe

But : Plusieurs développeurs travaillant sur le même agent

  1. Le premier développeur clone l’agent.

  2. Le premier développeur initialise Git et envoie (push) le contenu vers un référentiel partagé (GitHub, Azure DevOps).

  3. D’autres développeurs clonent depuis le dépôt Git partagé.

  4. Chaque développeur exécute Copilot Studio : Rattacher l’agent pour connecter son dossier local à Copilot Studio.

  5. L’équipe utilise Git pour collaborer et suivre les modifications, et utilise l’extension Visual Studio Code pour travailler sur l’agent.

  6. Chaque développeur applique ensuite des modifications à Copilot Studio pour tester ou envoyer (push) vers un autre environnement en aval en fonction de leur cycle de vie de développement logiciel ou de pipelines automatisés.

Scénario 3 : Cloner plusieurs environnements

But : Gérer le développement, les tests et les versions de production

L’approche recommandée pour le déploiement dans plusieurs environnements est d’utiliser des solutions. Considérons un processus de déploiement automatisé avec des processus organisationnels auditables et évolutifs, comme les pipelines. Pour les utilisateurs qui choisissent de ne pas utiliser de solutions, l’extension Copilot Studio offre la possibilité de synchroniser une définition d’agent Copilot Studio d’un ordinateur local vers un autre environnement. Vous devez toujours envisager le processus organisationnel de transfert des actifs techniques vers des environnements en aval afin de fournir audit, télémétrie et autres composants critiques dans le cycle de vie du développement logiciel lors de la livraison de logiciels à vos clients et utilisateurs finaux.

  1. Clonez l’assistant de l’environnement de développement vers un dossier local.

  2. Apportez des modifications dans le dossier de développement.

  3. Appliquez ces changements et testez les changements dans le même environnement.

  4. Utilisez Copilot Studio : réattacher l’agent pour connecter l’agent à l’environnement alternatif.

  5. Testez l’agent dans le volet de test Copilot Studio.

Meilleures pratiques

Faites

  • Clonez tous les agents vers un emplacement cohérent.
  • Initialisez Git juste après le clonage.
  • Utilisez un nom de dossier significatif.
  • Vérifiez que le clone fonctionne avant de faire des modifications.
  • Conservez l’emplacement de votre clone sauvegardé (par exemple, dans GitHub ou Azure DevOps).
  • Documentez la localisation de votre clone dans le wiki interne de votre équipe ou dans la documentation.

À ne pas faire

  • Ne clonez pas vers des répertoires temporaires.
  • Ne clonez pas plusieurs fois à différents endroits. Cela peut semer la confusion.

Étapes suivantes

Après avoir cloné votre agent :

  • Last updated on