Scrivere codice con Gemini Code Assist Standard ed Enterprise

Questo documento descrive come utilizzare Gemini Code Assist Standard ed Enterprise, un collaboratore basato sull'AI nel tuo IDE, per aiutarti a eseguire le seguenti operazioni in VS Code o IntelliJ e altri IDE JetBrains supportati:

  • Genera codice per il tuo progetto con la trasformazione del codice.
  • Ricevi completamenti del codice mentre programmi.
  • Utilizzare le azioni rapide.

Se utilizzi Gemini Code Assist Enterprise, puoi utilizzare la personalizzazione del codice, che ti consente di ricevere suggerimenti di codice basati sulla codebase privata della tua organizzazione direttamente da Gemini Code Assist Enterprise. Scopri come configurare la personalizzazione del codice.

Questo documento è destinato a sviluppatori di tutti i livelli di competenza. Presuppone che tu abbia una conoscenza pratica di VS Code o IntelliJ e di altri IDE JetBrains supportati e che tu abbia familiarità con Google Cloud. Se preferisci, puoi anche esplorare Gemini Code Assist in Cloud Shell Editor, Cloud Workstations e Android Studio.

Prima di iniziare

VS Code

  1. Configura Gemini Code Assist Standard o Enterprise, se non l'hai ancora fatto.

  2. Prima di testare le funzionalità di Gemini Code Assist nel tuo file di codice, assicurati che il linguaggio di programmazione del file sia supportato. Per maggiori informazioni sui linguaggi di programmazione supportati, vedi Linguaggi di programmazione supportati.

  3. Se preferisci utilizzare il tuo IDE dietro un proxy, consulta Connessioni di rete in Visual Studio Code.

IntelliJ

  1. Configura Gemini Code Assist Standard o Enterprise, se non l'hai ancora fatto.

  2. Prima di testare le funzionalità di Gemini Code Assist nel tuo file di codice, assicurati che il linguaggio di programmazione del file sia supportato. Per maggiori informazioni sui linguaggi di programmazione supportati, vedi Linguaggi di programmazione supportati.

  3. Se preferisci utilizzare il tuo IDE dietro un proxy, consulta la sezione Proxy HTTP.

Generare codice con i prompt

Le sezioni seguenti mostrano come utilizzare Gemini Code Assist per generare codice con il prompt di esempio Function to create a Cloud Storage bucket all'interno del file di codice. Puoi anche selezionare una parte del codice e poi chiedere aiuto a Gemini Code Assist tramite la funzionalità di chat e ricevere e accettare o rifiutare i suggerimenti di codice mentre programmi.

Chiedere a Gemini Code Assist di trasformare il codice

La trasformazione del codice ti consente di utilizzare comandi o prompt in linguaggio naturale nel menu Selezione rapida per richiedere modifiche al codice e fornisce una visualizzazione differenziale per mostrare le modifiche in attesa al codice. Per richiedere a Gemini Code Assist di trasformare il codice, segui questi passaggi:

VS Code

  1. Nel file di codice, su una nuova riga, premi Ctrl+I (per Windows e Linux) o Cmd+I (per macOS) per aprire il menu Selezione rapida di Gemini Code Assist.

  2. Nel menu, utilizzando il comando /generate, inserisci /generate function to create a Cloud Storage bucket e poi premi Invio (per Windows e Linux) o Return (per macOS).

    Gemini Code Assist genera codice con il comando /generate.

    Gemini Code Assist genera il codice in base al prompt in una visualizzazione diff.

    Gemini Code Assist apre una visualizzazione delle differenze per mostrare il codice generato.

  3. (Facoltativo) Per accettare queste modifiche, fai clic su Accetta.

IntelliJ

  1. Nel file di codice, su una nuova riga, premi Alt+\ (per Windows e Linux) o Cmd+\ (per macOS) per aprire il menu Selezione rapida di Gemini Code Assist.

  2. Nel menu, utilizzando il comando /generate, inserisci /generate function to create a Cloud Storage bucket e poi premi Invio (per Windows e Linux) o Return (per macOS).

    Funzione di generazione della trasformazione del codice in IntelliJ Gemini Code Assist

    Gemini Code Assist genera il codice in base al prompt in una visualizzazione diff.

    Visualizzazione diff della trasformazione del codice in IntelliJ Gemini Code Assist

  3. (Facoltativo) Per accettare queste modifiche, fai clic su Accetta modifiche.

    Puoi utilizzare i seguenti comandi di trasformazione del codice nel tuo IDE:

    • /fix: correggi i problemi o gli errori nel codice. Esempio: /fix potential NullPointerExceptions in my code.
    • /generate: genera il codice. Esempio: /generate a function to get the current time.
    • /doc: Aggiungi la documentazione al codice. Esempio: /doc this function.
    • /simplify: semplifica il codice. Esempio: /simplify if statement in this code.

Chiedere a Gemini Code Assist in un file di codice con un commento

Se preferisci, puoi anche richiedere a Gemini Code Assist nel tuo file di codice con un commento seguendo questi passaggi:

VS Code

  1. Su una nuova riga, inserisci il commento Function to create a Cloud Storage bucket, quindi premi Invio (per Windows e Linux) o Return (per macOS).

  2. Per generare il codice, premi Ctrl+Invio (per Windows e Linux) o Ctrl+Return (per macOS).

    Accanto al testo del prompt nel file di codice, Gemini Code Assist genera il codice sotto forma di testo fantasma.

  3. (Facoltativo) Per accettare il codice generato, premi Tab.

IntelliJ

  1. Nel file di codice, su una nuova riga, inserisci il commento Function to create a Cloud Storage bucket.

  2. Per generare il codice, premi Alt+G (per Windows e Linux) o Opzione+G (per macOS). In alternativa, puoi fare clic con il tasto destro del mouse accanto al commento e selezionare Genera codice.

    Gemini Code Assist genera il codice sotto il commento sotto forma di testo fantasma.

  3. (Facoltativo) Per accettare il codice generato, premi Tab.

(Facoltativo) Modificare la scorciatoia da tastiera per generare il codice

Se la scorciatoia da tastiera predefinita per generare il codice non funziona come descritto nella sezione precedente, puoi modificare la scorciatoia da tastiera.

Ottenere completamenti di codice

Mentre scrivi il codice, Gemini Code Assist fornisce suggerimenti di codice in linea, noti anche come completamenti del codice, che puoi accettare o ignorare. Per ottenere i completamenti del codice:

VS Code

  1. Nel file di codice, su una nuova riga, inizia a scrivere una funzione. Ad esempio, se ti trovi in un file Python, scrivi def.

    Gemini Code Assist suggerisce il codice sotto forma di testo fantasma.

  2. Per accettare il suggerimento di codice di Gemini Code Assist, premi Tab. In caso contrario, per ignorare il suggerimento, premi Esc o continua a scrivere il codice.

IntelliJ

  1. Nel file di codice, su una nuova riga, inizia a scrivere una funzione. Ad esempio, se ti trovi in un file Python, scrivi def.

    Gemini Code Assist suggerisce il codice sotto forma di suggerimento in linea.

  2. Per accettare il suggerimento di codice di Gemini Code Assist, premi Tab. In caso contrario, per ignorare il suggerimento, premi Esc o continua a scrivere il codice.

  3. (Facoltativo) Se preferisci utilizzare un tasto di scelta rapida diverso per accettare il suggerimento in linea, tieni il puntatore sopra il suggerimento in linea e fai clic sul menu a discesa Tab visualizzato. Poi, seleziona la scorciatoia che preferisci o fai clic su Personalizzata per inserire una scorciatoia personalizzata.

    Gemini fornisce un menu a discesa per modificare la scorciatoia per accettare un suggerimento in linea.

(Facoltativo) Disattivare il completamento del codice

Il completamento del codice è abilitato per impostazione predefinita. Se vuoi disattivare il completamento del codice, segui questi passaggi:

VS Code

  1. Nel tuo IDE, fai clic su Code (per macOS) o File (per Windows e Linux), quindi vai a Settings > Settings.

  2. Nella scheda Utente della finestra di dialogo Impostazioni, vai a Estensioni > Gemini Code Assist.

  3. Scorri fino all'elenco Duet AI: Inline Suggestions: Enable Auto e poi seleziona Off.

    In questo modo, i suggerimenti in linea vengono disattivati. Puoi comunque premere Ctrl+Invio (per Windows e Linux) o Ctrl+Invio (per macOS) per attivare manualmente i suggerimenti in linea.

IntelliJ

Nella barra di stato dell'IDE, fai clic su spark Gemini Code Assist: Active e seleziona Attiva il completamento del codice basato sull'AI.

Pulsante Completamento del codice Gemini nella barra di stato di IntelliJ.

In questo modo, l'impostazione di completamento del codice viene disattivata e Gemini Code Assist non fornisce più suggerimenti in linea finché non riattivi l'impostazione.

Utilizzare le azioni rapide

Per aiutarti a essere più produttivo riducendo al minimo il cambio di contesto, Gemini Code Assist fornisce azioni intelligenti basate sull'AI direttamente nell'editor di codice. Quando selezioni il codice nell'editor di codice, puoi visualizzare e selezionare un'azione da un elenco di azioni pertinenti al tuo contesto.

Per utilizzare le azioni intelligenti nel codice:

VS Code

  1. Nel file di codice, seleziona un blocco di codice.

  2. Accanto al blocco di codice selezionato, fai clic su lightbulb Mostra azioni del codice.

    L'icona a forma di lampadina delle Azioni rapide viene visualizzata dopo aver selezionato un blocco di codice in VS Code.

  3. Seleziona un'azione, ad esempio Genera test unitari.

    Gemini Code Assist genera una risposta basata sull'azione che hai selezionato.

IntelliJ

  1. Nel file di codice, seleziona una riga o un blocco di codice.

  2. Fai clic con il tasto destro del mouse sul codice selezionato e scegli un'azione intelligente, ad esempio Genera test delle unità.

    Se selezioni l'azione intelligente, Gemini Code Assist genererà automaticamente una risposta al prompt nella finestra degli strumenti Gemini Code Assist.

Utilizzare la correzione rapida della trasformazione del codice

Se si verifica un errore nel codice, Gemini Code Assist ti offre la possibilità di applicare una correzione rapida all'errore con la trasformazione del codice.

Per applicare una correzione rapida nel file di codice:

VS Code

  1. Nel file di codice, tieni il puntatore del mouse sulla riga di errore ondulata e seleziona Correzione rapida, quindi /fix.

    Correzione rapida della trasformazione del codice nell'IDE.

  2. Quando viene applicata la correzione rapida, viene visualizzata una visualizzazione differenziale. Per accettare queste modifiche, fai clic su Accetta.

IntelliJ

  1. Nel file di codice, fai clic sull'icona a forma di lampadina rossa, che indica un errore nel codice, e seleziona Correggi con Gemini.

    Opzione di trasformazione del codice per la correzione con Gemini nell'IDE.

  2. Quando la correzione viene applicata, viene visualizzata una visualizzazione differenziale. Per accettare queste modifiche, fai clic su Accetta.

Escludere file dal contesto locale

Per impostazione predefinita, Gemini Code Assist esclude i file dall'utilizzo locale nel contesto per il completamento del codice, la generazione di codice, la trasformazione del codice e la chat se i file sono specificati in un file .aiexclude o .gitignore.

Per scoprire come escludere i file dall'utilizzo locale, consulta Escludere i file dall'utilizzo di Gemini Code Assist.

Disattivare i suggerimenti di codice che corrispondono alle fonti citate

Gemini Code Assist fornisce informazioni sulla citazione quando cita direttamente e in dettaglio un'altra fonte, ad esempio codice open source esistente. Per maggiori informazioni, consulta Come e quando Gemini cita le fonti.

Per evitare che ti venga suggerito codice che corrisponde alle fonti citate:

  1. Nella barra delle attività dell'IDE, fai clic su Gestisci > Impostazioni.

  2. Nella scheda Utente della finestra delle impostazioni, vai a Estensioni > Gemini Code Assist.

  3. Scorri fino a trovare Geminicodeassist > Recitation: Max Cited Length.

  4. Imposta il valore su 0.

    Gemini Code Assist non ti suggerisce più codice che corrisponde alle fonti citate.

Problemi noti

Questa sezione descrive i problemi noti di Gemini Code Assist:

VS Code

  • Le risposte della chat potrebbero essere troncate se includono una versione aggiornata di un file aperto di grandi dimensioni

    Per risolvere il problema, seleziona una sezione di codice più piccola e includi un'ulteriore direttiva nel prompt della chat, ad esempio only output the selected code.

  • Vim: non è possibile accettare o ignorare i suggerimenti per la generazione di codice se non in modalità di inserimento

    Quando utilizzi il plug-in Vim in modalità normale, non puoi accettare o ignorare i suggerimenti di codice.

    Per risolvere questo problema, premi i per attivare la modalità di inserimento e poi premi Tab per accettare il suggerimento.

  • Vim: comportamento incoerente quando si preme Esc per ignorare i suggerimenti

    Quando premi Esc, vengono ignorati sia l'IDE sia i suggerimenti di Gemini Code Assist. Questo comportamento è diverso da quello non Vim, in cui la pressione di Esc riattiva Gemini Code Assist.

  • I tentativi di accesso continuano a scadere

    Se i tentativi di accesso continuano a scadere, prova ad aggiungere l'impostazione cloudcode.beta.forceOobLogin al file settings.json:

     "cloudcode.beta.forceOobLogin": true
    
  • Gli avvisi di recitazione della licenza non vengono mantenuti tra le sessioni

    Se gli avvisi di citazione della licenza non persistono tra le sessioni, consulta i log persistenti:

    1. Fai clic su Visualizza > Output.

    2. Seleziona Gemini Code Assist - Citazioni.

  • Problemi di connettività nella finestra di output di Gemini Code Assist

    Se visualizzi un errore di connessione o altri problemi di connettività nella finestra di output di Gemini Code Assist, prova quanto segue:

    • Configura il firewall per consentire l'accesso a oauth2.googleapis.com e cloudaicompanion.googleapis.com.

    • Configura il firewall per consentire la comunicazione tramite HTTP/2, utilizzato da gRPC.

    Puoi utilizzare lo strumento grpc-health-probe per testare la connettività. Un controllo riuscito genera il seguente output:

    $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

    Un controllo senza esito positivo genera il seguente output:

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    Per ottenere maggiori dettagli, esegui il seguente comando prima di grpc-health-probe:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    
  • Il messaggio "Attiva Gemini Code Assist" viene visualizzato ancora dopo aver selezionato il progetto Gemini Code Assist

    Se hai selezionato il progetto in base alle istruzioni di questa guida, che includono l'abilitazione dell'API Gemini in Google Cloud, potrebbe esserci un problema con il server LS.

    Per scoprire maggiori dettagli sul problema, esegui le seguenti azioni:

    1. Nella barra di stato, fai clic su spark Gemini Code Assist e poi seleziona Invia feedback.

    2. Fai clic su Mostra per uno qualsiasi dei file di log per visualizzare ulteriori dettagli e risolvere il problema.

IntelliJ

Non sono noti problemi per Gemini Code Assist per IntelliJ e altri IDE JetBrains supportati.

Lascia un feedback

Per lasciare un feedback sulla tua esperienza, segui questi passaggi:

VS Code

  1. Puoi lasciare un feedback in uno dei seguenti modi:

    • Nella barra di stato, fai clic su spark Gemini Code Assist, quindi seleziona Invia feedback nel menu Selezione rapida.
    • Apri la tavolozza dei comandi (Ctrl/Command + Shift + P) e poi seleziona Gemini Code Assist: Invia feedback.
  2. Nel modulo, compila i campi Titolo e Commenti.

  3. Nel modulo Feedback per Gemini Code Assist, seleziona un'opzione dai menu a discesa Categoria feedback e Tipo.

  4. Scrivi una descrizione dettagliata della tua esperienza nel campo Commento.

  5. Assicurati di includere i log di Gemini Code Assist nella segnalazione di feedback. Per impostazione predefinita, questa opzione è selezionata.

  6. Seleziona o deseleziona le altre opzioni, a seconda delle tue preferenze.

  7. Fai clic su Invia feedback.

IntelliJ

  1. Nella barra di stato, fai clic su spark Gemini Code Assist.

  2. Dopo aver richiesto l'aiuto di Gemini Code Assist nella chat e se non sei soddisfatto della risposta, fai clic su thumb_down Negativo e poi seleziona Fornisci feedback.

  3. Inserisci il tuo feedback nel campo di testo nella parte superiore del modulo.

  4. Se vuoi condividere i log di Gemini Code Assist, assicurati di selezionare i file di log.

  5. Fai clic su Invia feedback.

Passaggi successivi