Installation der Erweiterung für Visual Studio Code

watsonx Code Assistant

Erstellen Sie einen API-Schlüssel und fügen Sie die Erweiterung watsonx Code Assistant zu Ihrem Microsoft Visual Studio Code Editor hinzu.

Kompatibilität

Die Erweiterung ist kompatibel mit Visual Studio Code 1.101 und höher, mit Node.js Version 22.15 oder höher.

Um Ihre Node.js Version in Visual Studio Code zu überprüfen, klicken Sie auf das Menü Code und wählen Sie dann Über Visual Studio Code. Stellen Sie sicher, dass Node.js die Version 22.15 oder höher hat.

Die Installation der Erweiterung in einem Entwicklungscontainer wird nicht unterstützt.

Betriebssysteme:

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

Erstellen Sie einen API-Schlüssel für IBM Cloud

Anstelle eines Benutzernamens und eines Passworts verwendet jeder Entwickler einen persönlichen API-Schlüssel, um sich anzumelden.

So erstellen Sie einen API-Schlüssel:

  1. Melden Sie sich bei IBM Cloud API-Schlüssel an.

    Stellen Sie sicher, dass Sie das IBM Cloud-Konto verwenden, in dem die Instanz von watsonx Code Assistant Ihrer Organisation bereitgestellt wird.

  2. Klicken Sie auf Erstellen.

  3. Geben Sie " IBM watsonx Code Assistant API key als Namen für Ihren API-Schlüssel ein. Geben Sie optional eine Beschreibung ein.

  4. Klicken Sie auf Erstellen.

  5. Klicken Sie auf Herunterladen oder Kopieren und speichern Sie den API-Schlüssel an einem sicheren Ort.

    Die Taste ist nur 296 Sekunden lang verfügbar. Bewahren Sie es an einem Ort auf, an dem Sie es später wiederfinden können.

Erweiterung installieren

Wählen Sie die Installation für den von Ihnen genutzten Tarif.

Planbeschreibungen
Planen Beschreibung Erweiterungsname Unterstützung der Anzeigesprache
Testplan Begrenzte, kostenlose Testversion mit integriertem generativen KI-Chat für Code. watsonx Code Assistant Englisch (en), Japanisch (ja), Koreanisch (ko)
Essentials-Plan Integrierte generative KI für Code-Vorschläge, Code-Erklärungen, Code-Dokumentation und Unit-Tests. watsonx Code Assistant Englisch (en), Japanisch (ja), Koreanisch (ko)
Standard-Plan Alle Funktionen des Essentials-Pakets plus die Modernisierungsfunktionen für Unternehmen Java, erweiterte Code-Erklärung, erweiterte Unit-Test-Generierung und Retrieval Augmented Generation (RAG).

Bei der Installation des Standardplans erscheinen zwei Einträge in Ihrem Visual Studio Code Erweiterungen-Panel, einer für watsonx Code Assistant und einen für watsonx Code Assistant for Enterprise Java Applications. Die beiden Erweiterungen sind Abhängigkeiten für diese Installation. Version 1.6.2 oder höher von watsonx Code Assistant und Version 1.1.0 oder höher von watsonx Code Assistant for Enterprise Java Applications sind erforderlich.		 watsonx Code Assistant for Enterprise Java Applications Nur Englisch (en)

Vollständige Informationen zum Plan finden Sie unter:

Vom Visual Studio-Marktplatz

Zur Installation vom Visual Studio Marketplace:

  1. Wählen Sie die Installation für den von Ihnen genutzten Tarif.

  2. Klicken Sie auf der Marketplace-Seite auf Installieren.

  3. Klicken Sie in Visual Studio Code auf Installieren der Erweiterung.

Über den Visual Studio Code

So installieren Sie von Ihrem Visual Studio Code aus:

  1. Klicken Sie in Ihrem Visual Studio Code auf das Symbol Erweiterungen.

  2. Wählen Sie die Installation für den von Ihnen genutzten Tarif:

    • Schnupperangebot Essentials-Angebot Für die Installation von Schnupper- und Essentials-Angeboten suchen Sie nach ' watsonx Code Assistant.
    • Standard-Abo Um für das Standard-Abo zu installieren, suchen Sie nach watsonx Code Assistant for Enterprise Java Applications.

  3. Wählen Sie die gewünschte Erweiterung aus, und klicken Sie auf Installieren.

Öffnen Sie die Erweiterung

Um watsonx Code Assistant zu öffnen:

  1. Klicken Sie auf das watsonx Code Assistant watsonx Code Assistant symbol.

  2. Klicken Sie auf Mit Ihrem API-Schlüssel anmelden und geben Sie dann Ihren IBM watsonx Code Assistant API-Schlüssel ein.

    Wenn Ihr Konto mit mehr als einem IBM Cloud Rechenzentrum verbunden ist, wählen Sie auch den Standort.

Einrichten Ihrer Java für Unternehmen

Standardplan Wenn Sie den Standardplan verwenden und mit Java arbeiten möchten, müssen Sie Ihre Umgebung einrichten. Weitere Informationen finden Sie unter Einrichten Ihrer Java.

HTTP Proxy-Einstellungen aktualisieren

Wenn Ihre Organisation einen HTTP-Proxy-Server verwendet, müssen Sie Ihre Visual Studio Code-Einstellungen aktualisieren, damit eine korrekte Verbindung hergestellt werden kann. Wenn Sie versuchen, eine Verbindung herzustellen, und diese Einstellung fehlt, werden möglicherweise Konsolenfehler angezeigt.

  1. Öffnen Sie die http.proxy-Einstellung in den Visual Studio Code-Einstellungen.
  2. Geben Sie die URL Ihres HTTP Proxyservers im Format https://proxy_server:port ein. Möglicherweise müssen Sie Authentifizierungsinformationen wie http://user:pass@proxy_server:port angeben.

Einrichten der Überprüfung für benutzerdefinierte Zertifikate

Wenn Ihr Proxy-Server benutzerdefinierte Zertifikate verwendet, müssen Sie die Überprüfung für Visual Studio Code konfigurieren. Führen Sie die folgenden Schritte aus:

So exportieren Sie Ihr Server-SSL-Zertifikat:

  1. Verwenden Sie Google Chrome, um Ihre Instanz watsonx Code Assistant auf IBM Cloud zu öffnen.

  2. Klicken Sie auf das Symbol Website-Informationen anzeigen neben der Webadresse im Browser.

  3. Klicken Sie auf Verbindung ist sicher und dann auf Zertifikat ist gültig, um die Zertifikatsanzeige zu öffnen.

  4. Klicken Sie auf Details, wählen Sie das Zertifikat des Proxys aus und klicken Sie dann auf Exportieren.

Zum Einrichten für MacOS:

  1. Verwenden Sie Spotlight, um nach Keychain Access zu suchen und es zu öffnen.

  2. Klicken Sie auf System und dann auf die Registerkarte Zertifikate.

  3. Ziehen Sie die Zertifikatsdatei auf die Registerkarte "Zertifikate".

  4. Klicken Sie mit der rechten Maustaste auf das Zertifikat und dann auf Informationen abrufen.

  5. Setzen Sie im Abschnitt Vertrauen die Option Bei Verwendung dieses Zertifikats auf Always Trust.

  6. Starten Sie die Erweiterung neu, um die Änderungen zu übernehmen. Sie sollten sich mit Ihrem API-Schlüssel anmelden können.

Zum Einrichten für Windows:

  1. Öffnen Sie die Microsoft Management Console.

  2. Öffnen Sie Zertifikate (Lokaler Computer) > Vertrauenswürdige Stammzertifizierungsstellen > Zertifikate.

  3. Klicken Sie mit der rechten Maustaste auf Zertifikate, klicken Sie auf Alle Aufgaben und wählen Sie dann Importieren.

  4. Klicken Sie auf Details, wählen Sie das Zertifikat des Proxys aus und klicken Sie dann auf Exportieren.

  5. Starten Sie Visual Studio Code und die Erweiterung watsonx Code Assistant neu, damit die Änderungen übernommen werden. Sie sollten sich mit Ihrem API-Schlüssel anmelden können.

Sichern Sie Ihre Einrichtung

IBM watsonx Code Assistant bietet keine zusätzlichen Sicherheitskontrollen. Führen Sie diese Schritte aus, um Ihre Einrichtung ordnungsgemäß zu sichern.

Ihre Visual Studio Code

Wenden Sie alle Visual Studio Code-Updates an, um sicherzustellen, dass Sie über die neuesten Sicherheits- und Fehlerbehebungen verfügen. Weitere Informationen finden Sie in der Microsoft-Dokumentation.

Die Protokolle der watsonx Code Assistant Erweiterung werden in *.log Dateien unter ' <your home directory>/.wca gespeichert. Diese Dateien sind nicht verschlüsselt, abgesehen von der Verschlüsselung, die Ihr Dateisystem bietet. Sichern Sie die Protokolle vor unberechtigtem Zugriff.

Speicherung von Chat-Konversationen

IBM watsonx Code Assistant speichert Ihren gesamten Chat-Konversationsverlauf lokal in Ihrem Dateisystem in <your home directory>/.wca/chat.db, in einem von SQLite definierten Datenbankformat. IBM watsonx Code Assistant gibt diese Konversationen an niemanden weiter. Diese Datei ist nicht verschlüsselt, abgesehen von der Verschlüsselung, die Ihr Dateisystem bietet. Schützen Sie diese Datei vor unberechtigtem Zugriff.

Telemetriedaten

IBM watsonx Code Assistant sammelt keine Telemetriedaten. Im Allgemeinen sendet watsonx Code Assistant keine Daten, die es verarbeitet, an Dritte, einschließlich IBM.

Abmelden von Ihrem API-Schlüssel

Falls erforderlich, können Sie sich von Ihrem API-Schlüssel abmelden. Das Abmelden und erneute Eingeben Ihres API-Schlüssels kann bei Authentifizierungsproblemen helfen.

Zum Abmelden:

  1. Klicken Sie in Visual Studio Code auf das Symbol Konten.

  2. Klicken Sie auf die Einstellung Ihr Name (WCA-API-Schlüssel) und dann auf Abmelden.

Verwendung der Ausgabeansicht zur Anzeige von Aktivitätsdetails

Sie können die Ausgabeansicht von Visual Studio Code verwenden, um Details zu sehen, was die Erweiterung tut und protokolliert, und um nach Fehlern zu suchen.

So öffnen Sie die Ansicht Ausgabe:

  1. Klicken Sie in Visual Studio Code auf Ansicht und dann auf Ausgabe.

  2. Wählen Sie in der Ansicht Ausgabe in der Dropdown-Liste WCA oder WCA Language Server aus. Beide enthalten weitere Einzelheiten über die Funktion der Erweiterung.

So passen Sie die Ausgabeansicht und die Protokollierung für die Visual Studio Code an:

  1. Öffnen Sie in Visual Studio Code die Erweiterungseinstellungen für watsonx Code Assistant.

  2. Unter Wca: Log level wechseln Sie von der Standardeinstellung INFO zu einer anderen Einstellung wie WARN.

Deaktivieren oder Deinstallieren der Erweiterung

Falls erforderlich, können Sie die Erweiterung deaktivieren und sie installiert lassen, oder Sie können sie vollständig deinstallieren.

Zum Deaktivieren oder Deinstallieren der Erweiterung:

  1. Klicken Sie in Visual Studio Code auf das Symbol Erweiterungen, um das Panel zu öffnen.

  2. Klicken Sie auf die Erweiterung watsonx Code Assistant.

  3. Klicken Sie auf Deaktivieren oder Deinstallieren.

Ändern der Anzeigesprache

Die Erweiterung watsonx Code Assistant ist in Englisch (en), Japanisch (ja) und Koreanisch (ko) verfügbar.

Die Erweiterung watsonx Code Assistant for Enterprise Java Applications ist nur auf Englisch verfügbar (en).

So ändern Sie die Anzeigesprache:

  1. Klicken Sie unter Visual Studio Code auf Ansicht und dann auf Befehlspalette.

  2. Suchen Sie nach display und klicken Sie dann auf Anzeigesprache konfigurieren.

  3. Wählen Sie entweder Englisch (en), Japanisch (ja), oder Koreanisch (ko).

Weitere Informationen finden Sie unter Display Language in der Dokumentation Visual Studio Code.