Installazione dell'estensione per Visual Studio Code

watsonx Code Assistant

Creare una chiave API e aggiungere l'estensione watsonx Code Assistant all'editor di Microsoft Visual Studio Code.

Compatibilità

L'estensione è compatibile con Visual Studio Code 1.101 e successive, utilizzando la versione Node.js 22.15 o successive.

Per verificare la versione di Node.js in Visual Studio Code, fare clic sul menu Codice, quindi scegliere Informazioni su Visual Studio Code. Assicurarsi che Node.js sia la versione 22.15 o successiva.

L'installazione dell'estensione in un contenitore di sviluppo non è supportata.

Sistemi operativi:

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

Creare una chiave API su IBM Cloud

Invece di un nome utente e di una password, ogni sviluppatore utilizza una chiave API personale per accedere.

Per creare una chiave API:

  1. Accedi alle chiavi API di IBM Cloud.

    Assicurati di utilizzare l'account IBM Cloud in cui è fornita l'istanza di watsonx Code Assistant della tua organizzazione.

  2. Fai clic su Crea.

  3. Immettere " IBM watsonx Code Assistant API key come nome della chiave API. Inserire facoltativamente una descrizione.

  4. Fai clic su Crea.

  5. Fare clic su Scarica o Copia e memorizzare la chiave API in un luogo sicuro.

    Il tasto è disponibile solo per 296 secondi. Conservalo in un posto dove puoi ritrovarlo in seguito.

Installa l'estensione

Scegliete l'installazione per il piano che state utilizzando.

Descrizioni dei piani
Piano Descrizione Nome estensione Supporto della lingua di visualizzazione
Piano Trial Prova limitata e gratuita con chat AI generativa integrata per il codice. watsonx Code Assistant Inglese (en), giapponese (ja), coreano (ko)
Piano Essentials IA generativa integrata per suggerimenti di codice, spiegazioni di codice, documentazione di codice e test unitari. watsonx Code Assistant Inglese (en), giapponese (ja), coreano (ko)
Piano Standard Tutte le caratteristiche del piano Essentials, più le funzionalità di modernizzazione del sito Java, la spiegazione avanzata del codice, la generazione avanzata di test unitari e la generazione aumentata del recupero (RAG).

Per l'installazione del piano Standard, nel pannello delle estensioni di Visual Studio Code appaiono due voci, una per il programma watsonx Code Assistant e una per watsonx Code Assistant for Enterprise Java Applications. Le due estensioni sono dipendenze di questa installazione. Sono necessarie la versione 1.6.2 o successiva di watsonx Code Assistant e la versione 1.1.0 o successiva di watsonx Code Assistant for Enterprise Java Applications.		 watsonx Code Assistant for Enterprise Java Applications Solo inglese (en)

Per i dettagli completi del piano, vedere:

Dal mercato di Visual Studio

Per installare dal Marketplace di Visual Studio:

  1. Scegliete l'installazione per il piano che state utilizzando.

  2. Fare clic su Installa nella pagina del Marketplace.

  3. In Visual Studio Code, fare clic su Installa sull'estensione.

Dall'editor di Visual Studio Code

Per installare dall'editor di Visual Studio Code:

  1. Nell'editor di Visual Studio Code, fare clic sull'icona delle estensioni.

  2. Scegliete l'installazione per il piano che state utilizzando:

    • Piano Trial Piano Essentials Per installare i piani Trial ed Essentials, cercare 'watsonx Code Assistant.
    • Piano standard Per installare il piano standard, cercare watsonx Code Assistant for Enterprise Java Applications.

  3. Selezionare l'estensione desiderata, quindi fare clic su Installa.

Aprire l'estensione

Per aprire watsonx Code Assistant:

  1. Fare clic sull'icona watsonx Code Assistant watsonx Code Assistant icona.

  2. Fare clic su Log in with your API key, quindi inserire la chiave API IBM watsonx Code Assistant.

    Se il vostro account è associato a più di un data center IBM Cloud, scegliete anche la località.

Configurare l'ambiente Java aziendale

Piano standard Se si utilizza il piano Standard e si desidera lavorare con applicazioni Java aziendali, è necessario configurare l'ambiente. Per ulteriori informazioni, vedere Impostazione dell'ambiente Java aziendale.

Aggiornare le impostazioni del proxy di HTTP

Se la tua organizzazione utilizza un server proxy HTTP, devi aggiornare le impostazioni Visual Studio Code in modo che possa connettersi correttamente. Potresti ricevere errori della console quando provi a connetterti e questa impostazione è mancante.

  1. Apri l'impostazione " http.proxy " in "Impostazioni di Visual Studio Code ".
  2. Inserire l'indirizzo URL del server proxy HTTP nel formato https://proxy_server:port. Potrebbe essere necessario includere informazioni di autenticazione, come http://user:pass@proxy_server:port.

Impostazione della verifica per i certificati personalizzati

Se il server proxy utilizza certificati personalizzati, è necessario configurare la verifica per Visual Studio Code. Attieniti alla seguente procedura:

Per esportare il certificato SSL del server:

  1. Utilizzate Google Chrome per aprire l'istanza di watsonx Code Assistant su IBM Cloud.

  2. Fare clic sull'icona Visualizza informazioni sul sito accanto all'indirizzo web nel browser.

  3. Fare clic su La connessione è sicura, quindi su Il certificato è valido per aprire il Visualizzatore certificati.

  4. Fare clic su Dettagli, selezionare il certificato del proxy e quindi fare clic su Esporta.

Per impostare per MacOS:

  1. Utilizzare Spotlight per cercare e aprire Accesso Portachiavi.

  2. Fare clic su Sistema, quindi sulla scheda Certificati.

  3. Trascinare il file del certificato nella scheda Certificati.

  4. Fare clic con il tasto destro del mouse sul certificato, quindi fare clic su Ottieni informazioni.

  5. Nella sezione Fiducia, impostare Quando si usa questo certificato su Always Trust.

  6. Riavviare l'estensione per applicare le modifiche. Dovreste essere in grado di accedere utilizzando la vostra chiave API.

Per impostare Windows:

  1. Aprire la Microsoft Management Console.

  2. Aprire Certificati (computer locale) > Autorità di certificazione radice attendibili > Certificati.

  3. Fare clic con il pulsante destro del mouse su Certificati, fare clic su Tutte le attività e scegliere Importa.

  4. Fare clic su Dettagli, selezionare il certificato del proxy e quindi fare clic su Esporta.

  5. Riavviare Visual Studio Code e l'estensione watsonx Code Assistant per applicare le modifiche. Dovreste essere in grado di accedere utilizzando la vostra chiave API.

Proteggere la configurazione

IBM watsonx Code Assistant non fornisce ulteriori controlli di sicurezza. Utilizzate questi passaggi per proteggere correttamente la vostra installazione.

L'ambiente di Visual Studio Code

Applica tutti gli aggiornamenti di sicurezza ( Visual Studio Code ) per assicurarti di avere le ultime correzioni di sicurezza e bug. Per ulteriori informazioni, consultare la Documentazione Microsoft.

I log dell'estensione watsonx Code Assistant sono memorizzati in file *.log sotto '<your home directory>/.wca. Questi file non sono crittografati, a parte la crittografia fornita dal file system. Proteggere i registri da accessi impropri.

Memorizzazione delle conversazioni in chat

IBM watsonx Code Assistant memorizza tutta la cronologia delle conversazioni chat localmente nel tuo file system in <your home directory>/.wca/chat.db, in un formato database definito da SQLite. IBM watsonx Code Assistant non condivide queste conversazioni con nessuno. Questo file non è crittografato, a parte la crittografia fornita dal file system. Proteggere questo file da accessi impropri.

Dati di telemetria

IBM watsonx Code Assistant non raccoglie alcun dato di telemetria. In generale, watsonx Code Assistant non invia alcun dato elaborato a terzi, IBM compresa.

Disconnessione della chiave API

Se necessario, è possibile disconnettersi dalla propria chiave API. Disconnettersi e reinserire la chiave API potrebbe aiutare a risolvere eventuali problemi di autenticazione.

Per uscire:

  1. In Visual Studio Code, fare clic sull'icona Accounts.

  2. Fare clic sull'impostazione Nome (chiave API WCA), quindi fare clic su Esci.

Utilizzo della vista Output per visualizzare i dettagli dell'attività

È possibile utilizzare la vista Output di Visual Studio Code per vedere i dettagli di ciò che l'estensione sta facendo e registrando e controllare eventuali errori.

Per aprire la vista Output:

  1. In Visual Studio Code, fare clic su Visualizza, quindi su Output.

  2. Nella vista Output, utilizzare l'elenco a discesa per selezionare WCA o WCA Language Server. Entrambi forniscono maggiori dettagli sulle attività dell'estensione.

Per regolare la visualizzazione dell'output e la registrazione per l'estensione Visual Studio Code:

  1. In Visual Studio Code, aprire le impostazioni dell'estensione per watsonx Code Assistant.

  2. In Wca: Livello di registro, passare dal valore predefinito di INFO a un'altra impostazione, ad esempio WARN.

Disabilitare o disinstallare l'estensione

Se necessario, è possibile disattivare l'estensione e mantenerla installata, oppure disinstallarla completamente.

Per disattivare o disinstallare l'estensione:

  1. In Visual Studio Code, fare clic sull'icona delle estensioni per aprire il pannello.

  2. Fare clic sull'estensione watsonx Code Assistant.

  3. Fare clic su Disattiva o Disinstalla.

Modifica della lingua del display

L'estensione watsonx Code Assistant è disponibile in inglese (en), giapponese (ja) e coreano (ko).

L'estensione watsonx Code Assistant for Enterprise Java Applications è disponibile solo in inglese (en).

Per cambiare la lingua del display:

  1. In Visual Studio Code, fare clic su Visualizza, quindi su Tavolozza dei comandi.

  2. Cercare display, quindi fare clic su Configura lingua di visualizzazione.

  3. Scegliere tra inglese (en), giapponese (ja) o coreano (ko).

Per ulteriori informazioni, vedere Lingua di visualizzazione nella documentazione di Visual Studio Code.