Installation de l'extension pour Visual Studio Code

watsonx Code Assistant

Créez une clé API et ajoutez l'extension watsonx Code Assistant à votre éditeur Microsoft Visual Studio Code

Compatibilité

L'extension est compatible avec Visual Studio Code 1.101 et les versions ultérieures, en utilisant la version Node.js 22.15 ou les versions ultérieures.

Pour vérifier votre version de Node.js dans Visual Studio Code, cliquez sur le menu Code, puis choisissez About Visual Studio Code. Assurez-vous que Node.js est la version 22.15 ou une version ultérieure.

L'installation de l'extension dans un conteneur de développement n'est pas possible.

Systèmes d'exploitation :

  • macOS
  • Windows 11
  • Fedora Linux 41
  • Red Hat Enterprise Linux 8
  • Ubuntu 20.04

Créer une clé API sur IBM Cloud

Au lieu d'un nom d'utilisateur et d'un mot de passe, chaque développeur utilise une clé API personnelle pour se connecter.

Pour créer une clé API :

  1. Connectez-vous à IBM Cloud Clés API.

    Assurez-vous que vous utilisez le compte IBM Cloud sur lequel l'instance d' watsonx Code Assistant de votre organisation est fournie.

  2. Cliquez sur Créer.

  3. Saisissez " IBM watsonx Code Assistant API key comme nom de votre clé API. Si vous le souhaitez, entrez une description.

  4. Cliquez sur Créer.

  5. Cliquez sur Télécharger ou Copier et conservez la clé API dans un endroit sûr.

    La clé n'est disponible que pendant 296 secondes. Rangez-le à un endroit où vous pourrez le retrouver plus tard.

Installation de l'extension

Choisissez l'installation correspondant au plan que vous utilisez.

Description des plans
Plan Description Nom d'extension Prise en charge de la langue d'affichage
Plan d'essai Essai gratuit limité avec chat génératif intégré pour le code. watsonx Code Assistant Anglais (en), japonais (ja), coréen (ko)
Plan Essentials IA générative intégrée pour les suggestions de code, les explications de code, la documentation de code et les tests unitaires. watsonx Code Assistant Anglais (en), japonais (ja), coréen (ko)
Forfait standard Toutes les caractéristiques du plan Essentials, plus les capacités de modernisation de l'entreprise Java, l'explication améliorée du code, la génération améliorée de tests unitaires et la génération augmentée de récupération (RAG).

Pour l'installation du plan standard, deux entrées apparaissent dans votre panneau Visual Studio Code Extensions, l'une pour watsonx Code Assistant et une pour watsonx Code Assistant for Enterprise Java Applications. Les deux extensions sont des dépendances pour cette installation. La version 1.6.2 ou une version ultérieure de watsonx Code Assistant et la version 1.1.0 ou une version ultérieure de watsonx Code Assistant for Enterprise Java Applications sont nécessaires.		 watsonx Code Assistant for Enterprise Java Applications Anglais (en) uniquement

Pour plus de détails sur le plan, voir :

A partir de la place de marché de Visual Studio

Pour l'installer à partir de la place de marché Visual Studio :

  1. Choisissez l'installation correspondant au plan que vous utilisez.

  2. Cliquez sur Installer sur la page Marketplace.

  3. Dans Visual Studio Code, cliquez sur Installer dans l'extension.

Dans l'éditeur Visual Studio Code

Pour l'installer à partir de votre éditeur Visual Studio Code:

  1. Dans votre éditeur Visual Studio Code, cliquez sur l'icône Extensions.

  2. Choisissez l'installation correspondant au plan que vous utilisez :

    • Plan d'essai Plan essentiel Pour installer les plans d'essai et essentiel, recherchez " watsonx Code Assistant.
    • Plan Standard Pour installer le plan Standard, recherchez watsonx Code Assistant for Enterprise Java Applications.

  3. Sélectionnez l'extension dont vous avez besoin, puis cliquez sur Installer.

Ouvrir l'extension

Pour ouvrir watsonx Code Assistant:

  1. Cliquez sur l'icône watsonx Code Assistant watsonx Code Assistant icône.

  2. Cliquez sur Se connecter avec votre clé API, puis saisissez votre clé API IBM watsonx Code Assistant.

    Si votre compte est associé à plus d'un centre de données IBM Cloud, choisissez également l'emplacement.

Configurer l'environnement Java de l'entreprise

Plan standard Si vous utilisez le plan standard et souhaitez travailler avec des applications Java d'entreprise, vous devez configurer votre environnement. Pour plus d'informations, voir Configuration de l'environnement Java de l'entreprise.

Mise à jour des paramètres du proxy HTTP

Si votre organisation utilise un serveur proxy d' HTTP, vous devez mettre à jour vos paramètres d' Visual Studio Code s afin qu'il puisse se connecter correctement. Vous pourriez recevoir des erreurs de console lorsque vous essayez de vous connecter et que ce paramètre est manquant.

  1. Ouvrez le paramètre « http.proxy » dans les paramètres d' Visual Studio Code.
  2. Entrez le URL de votre serveur proxy HTTP au format https://proxy_server:port. Vous devrez peut-être inclure des informations d'authentification, telles que http://user:pass@proxy_server:port.

Mise en place de la vérification des certificats personnalisés

Si votre serveur proxy utilise des certificats personnalisés, vous devez configurer la vérification pour Visual Studio Code. Effectuez les étapes suivantes :

Pour exporter le certificat SSL de votre serveur :

  1. Utilisez Google Chrome pour ouvrir votre instance watsonx Code Assistant sur IBM Cloud.

  2. Cliquez sur l'icône Afficher les informations sur le site à côté de l'adresse web dans le navigateur.

  3. Cliquez sur Connexion sécurisée, puis sur Certificat valide pour ouvrir la visionneuse de certificats.

  4. Cliquez sur Détails, sélectionnez le certificat du proxy, puis cliquez sur Exporter.

A mettre en place pour MacOS:

  1. Utilisez Spotlight pour rechercher et ouvrir Keychain Access.

  2. Cliquez sur Système, puis sur l'onglet Certificats.

  3. Faites glisser le fichier de certificat dans l'onglet Certificats.

  4. Cliquez avec le bouton droit de la souris sur le certificat, puis cliquez sur Obtenir des informations.

  5. Dans la section Confiance, définissez l'option Lors de l'utilisation de ce certificat sur Always Trust.

  6. Redémarrez l'extension pour appliquer les modifications. Vous devriez pouvoir vous connecter en utilisant votre clé API.

Pour configurer Windows :

  1. Ouvrez Microsoft Management Console.

  2. Ouvrez Certificats (ordinateur local) > Autorités de certification racine de confiance > Certificats.

  3. Cliquez avec le bouton droit de la souris sur Certificats, cliquez sur Toutes les tâches, puis choisissez Importer.

  4. Cliquez sur Détails, sélectionnez le certificat du proxy, puis cliquez sur Exporter.

  5. Redémarrez Visual Studio Code et l'extension watsonx Code Assistant pour appliquer les changements. Vous devriez pouvoir vous connecter en utilisant votre clé API.

Sécurisez votre installation

IBM watsonx Code Assistant ne fournit pas de contrôles de sécurité supplémentaires. Suivez ces étapes pour sécuriser correctement votre installation.

Votre environnement Visual Studio Code

Appliquez toutes les mises à jour d' Visual Studio Code s pour vous assurer de disposer des dernières mises à jour de sécurité et de correction de bugs. Pour plus d'informations, voir la documentation Microsoft.

Les journaux de l'extension watsonx Code Assistant sont stockés dans des fichiers *.log sous " <your home directory>/.wca. Ces fichiers ne sont pas cryptés, à l'exception du cryptage fourni par votre système de fichiers. Protéger les journaux contre tout accès inapproprié.

Stockage des conversations par chat

IBM watsonx Code Assistant stocke l'historique de toutes vos conversations de chat localement dans votre système de fichiers dans <your home directory>/.wca/chat.db, dans un format de base de données défini par SQLite. IBM watsonx Code Assistant ne partage ces conversations avec personne. Ce fichier n'est pas crypté, à l'exception du cryptage fourni par votre système de fichiers. Protégez ce fichier contre tout accès inapproprié.

Données télémétriques

IBM watsonx Code Assistant ne collecte aucune donnée de télémétrie. En général, watsonx Code Assistant n'envoie aucune donnée qu'il traite à un tiers, y compris IBM.

Déconnexion de votre clé API

Si nécessaire, vous pouvez vous déconnecter de votre clé API. Déconnectez-vous puis reconnectez votre clé API pour résoudre les problèmes d'authentification que vous pourriez rencontrer.

Pour se déconnecter :

  1. Dans Visual Studio Code, cliquez sur l'icône Comptes.

  2. Cliquez sur le paramètre Votre nom (clé API WCA), puis cliquez sur Déconnexion.

Utilisation de la vue de sortie pour voir les détails de l'activité

Vous pouvez utiliser la vue de sortie de Visual Studio Code pour voir les détails de ce que l'extension fait et enregistre, et vérifier s'il y a des erreurs.

Pour ouvrir la vue de sortie :

  1. Dans Visual Studio Code, cliquez sur View, puis sur Output.

  2. Dans la vue Sortie, utilisez la liste déroulante pour sélectionner WCA ou WCA Language Server. Les deux fournissent plus de détails sur ce que fait l'extension.

Pour ajuster la vue de sortie et la journalisation pour l'extension Visual Studio Code:

  1. Dans Visual Studio Code, ouvrez les paramètres d'extension pour watsonx Code Assistant

  2. Dans Wca : Log level, passez de la valeur par défaut de INFO à une autre valeur telle que WARN.

Désactivation ou désinstallation de l'extension

Si nécessaire, vous pouvez désactiver l'extension et la laisser installée, ou vous pouvez la désinstaller complètement.

Pour désactiver ou désinstaller l'extension :

  1. Dans Visual Studio Code, cliquez sur l'icône Extensions pour ouvrir le panneau.

  2. Cliquez sur l'extension watsonx Code Assistant

  3. Cliquez sur Désactiver ou Désinstaller.

Changement de la langue d'affichage

L'extension watsonx Code Assistant est disponible en anglais (en), en japonais (ja) et en coréen (ko).

L'extension watsonx Code Assistant for Enterprise Java Applications n'est disponible qu'en anglais (en).

Pour changer la langue d'affichage :

  1. Dans Visual Studio Code, cliquez sur View, puis sur Command Palette.

  2. Recherchez display, puis cliquez sur Configurer la langue d'affichage.

  3. Choisissez l'anglais (en), le japonais (ja) ou le coréen (ko).

Pour plus d'informations, voir la section Langue d'affichage dans la documentation Visual Studio Code.