Installer l’extension Microsoft Copilot Studio pour Microsoft Visual Studio Code

Prerequisites

Avant d’installer l’extension Microsoft Copilot Studio pour Microsoft Visual Studio Code, vérifiez que vous répondez aux exigences suivantes :

Configuration système requise

• Système d’exploitation:
  • Windows (architecture x64)
    • Windows 10 version 1809 ou ultérieure
    • Windows 11 (n’importe quelle version)
  • macOS
• Visual Studio Code : version 1.80 ou ultérieure (version stable la plus récente recommandée)
• Connexion Internet : Nécessaire pour l’installation et l’authentification

Exigences du compte

• Compte Microsoft : compte Microsoft actif avec licence ou accès Copilot Studio
• licence Copilot Studio : licence appropriée affectée à votre compte
• Environment access : Autorisations pour accéder à au moins un environnement Copilot Studio
• Autorisations d’agent : Lisez et écrivez l’accès à tous les agents que vous prévoyez de modifier

Procédure d’installation :

Vous pouvez installer l’extension Copilot Studio dans Visual Studio Code de deux manières :

• Installer à partir de Visual Studio Code
• Installer à partir du site web de la Place de marché Visual Studio Code

Méthode 1 : Installer à partir de Visual Studio Code

1. Sélectionnez l’icône Extensions dans la barre d’activités ou appuyez sur Ctrl+Shift+X. Le volet Extensions s’ouvre dans Visual Studio Code.

2. Dans la barre de recherche, entrez « Copilot Studio ». Recherchez l’extension officielle Copilot Studio dans la liste des résultats. Vérifiez que l’éditeur est « Microsoft ».

3. Une fois que vous avez trouvé la bonne extension, sélectionnez-la pour ouvrir la page des détails de l’extension.

4. Sélectionnez Installer pour commencer l’installation.

5. Attendez la fin de l’installation. Vous pouvez voir une invite à recharger Visual Studio Code, auquel cas, sélectionnez Reload lorsque vous y êtes invité.

6. Vérifiez l’installation. Recherchez l’icône Copilot Studio dans la barre d’activité. L’icône s’affiche avec la marque Copilot Studio.

Méthode 2 : Installer à partir du site web de la Place de marché Visual Studio Code

1. Accédez à https://marketplace.visualstudio.com/ et recherchez « Copilot Studio ». Vous pouvez également utiliser le lien direct : https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

2. Sélectionnez Installer sur la page du marché. Vos invites de navigateur peuvent vous inviter à télécharger Visual Studio Code avant de vous demander d’ouvrir Visual Studio Code.

3. Autoriser le navigateur à ouvrir Visual Studio Code et confirmer l’installation en recherchant l’icône d’extension dans la barre d’activité.

Configuration initiale

Premier lancement

1. Sélectionnez l’icône Copilot Studio dans la barre d’activité. L’extension s’ouvre sous forme de volet d’application. Une notification contextuelle apparaît, indiquant que l’extension Copilot Studio exige que vous vous connectiez.

2. Sélectionnez Se connecter dans la fenêtre contextuelle, puis sélectionnez Autoriser. Votre navigateur par défaut s’ouvre sur une page d’authentification Microsoft.

3. Saisissez vos identifiants d’authentification et complétez toute authentification multifacteur si nécessaire.

4. Examinez les autorisations demandées :

   • Lecture et écriture des assistants Copilot Studio
   • Accéder aux informations sur l’environnement
   • Synchroniser les fichiers vers le cloud

   Sélectionnez Accepter ou Autoriser. Le navigateur vous invite à fermer la fenêtre et à revenir à Visual Studio Code.

5. Revenez à Visual Studio Code. Le panneau d’extension charge les environnements auxquels vous avez accès, ainsi que les agents dans ces environnements.

Vérifier la mise en place réussie

Après l’authentification, vous voyez une structure sous le volet Agents dans l’extension Copilot Studio dans Visual Studio Code. Vous voyez une liste de groupes d’environnements, avec des environnements imbriqués et des agents, similaire à la structure suivante :

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Résoudre les problèmes d’installation

Les étapes suivantes abordent certains problèmes pouvant survenir lors de l’installation ou de la configuration de l’extension Copilot Studio Visual Studio Code.

L’extension n’apparaît pas

Problem : L'icône Copilot Studio n'apparaît pas dans la barre d'activité.

Solution:

1. Redémarrez Visual Studio Code.
2. Sélectionnez Extensions et cherchez l’extension dans la liste Installés. Assurez-vous que la prolongation n’est pas désactivée.
3. Mettez à jour Visual Studio Code vers la dernière version.
4. Réinstallez l’extension.

Échecs d’authentification

Problème : L’authentification échoue ou se boucle à plusieurs reprises.

Solution:

1. Videz le cache de votre navigateur et les cookies pour microsoft.com.

2. Essayez de vous connecter avec un autre navigateur. Définissez temporairement ce navigateur par défaut.

3. Désactivez les extensions de navigateur qui pourraient bloquer l’authentification.

4. Vérifiez les paramètres du pare-feu et du proxy d’entreprise.

5. Assurez-vous d’utiliser un type de compte pris en charge.

Extension introuvable dans Visual Studio Code Place de marché

Problème : Vous ne trouvez pas l'extension Copilot Studio en cherchant.

Solution:

1. Assurez-vous de chercher dans le volet Extensions , pas dans la recherche web.

2. Vérifiez l’orthographe : « Copilot Studio ».

3. Contactez votre administrateur pour voir si votre organisation limite Visual Studio Code l’accès à la Place de marché.

Désinstaller l’extension

Pour supprimer l’extension :

1. Ouvre le panneau Extensions.

2. Recherchez Copilot Studio dans les extensions installées.

3. Sur l’entrée de la liste, sélectionnez l’icône Gérer , puis sélectionnez Désinstaller.

4. Relancez Visual Studio Code lorsque vous y êtes invité.

Étapes suivantes

Après avoir installé l'extension et l'authentification avec Copilot Studio, vous êtes prêt à :

• Clonez votre premier agent
• Découvrez les composants de l’agent de montage