Scrivi codice con Gemini Code Assist

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

• Fornisci indicazioni per aiutarti a risolvere i problemi relativi al codice.

• Genera il codice per il tuo progetto.

• Ricevi suggerimenti in linea durante la programmazione.

Scopri come e quando Gemini per Google Cloud utilizza i tuoi dati.

La personalizzazione del codice ti consente di ricevere suggerimenti sul codice basati sul codebase privato della tua organizzazione direttamente da Gemini Code Assist. Scopri come configurare la personalizzazione del codice.

Questo documento è rivolto a sviluppatori di tutti i livelli di abilità. Si presuppone che tu abbia una conoscenza lavorativa di Cloud Workstations e che tu abbia familiarità con Google Cloud. Se preferisci, puoi anche esplorare Gemini Code Assist in Cloud Code for VS Code, Cloud Code for IntelliJ e l'editor di Cloud Shell.

Prima di iniziare

1. Assicurati di disporre del ruolo IAM Amministratore Cloud Workstations nel progetto per poter creare configurazioni di workstation.

   Vai a IAM

2. Se non l'hai ancora fatto, configura la tua workstation e assicurati di selezionare Base Editor (Code-OSS) nella configurazione.

3. Prima di testare le funzionalità di Gemini Code Assist nel 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.

Collegati a Google Cloud e seleziona un progetto

In questa sezione, ti connetterai a Google Cloud e selezionerai unGoogle Cloud progetto con l'API Gemini per Google Cloud abilitata nella tua workstation.

Se selezioni un Google Cloud progetto in cui l'API Gemini per Google Cloud non è abilitata, ricevi una notifica che ti offre la possibilità di abilitare l'API dall'IDE. Seleziona Abilita l'API nella finestra di notifica per abilitare l'API per il tuo progetto. Per maggiori informazioni, consulta Configurare Gemini Code Assist per un progetto.

Per connetterti a Google Cloud nella tua workstation, segui questi passaggi:

1. Avvia la workstation nella console Google Cloud.

   Avvia workstation

2. Nella barra di stato, fai clic su Cloud Code - Accedi.

   

3. Quando ti viene chiesto di accedere, fai clic su Procedi per accedere.

4. Per avviare il Google Cloud flusso di accesso, premi Ctrl (per Windows e Linux) o Comando (per macOS) e fai clic sull'URL nella console.

5. Se ti viene richiesto di consentire a Cloud Workstations di aprire il sito web esterno, fai clic su Apri.

6. Segui le istruzioni per accedere al tuo account.

   Se ti viene richiesto di assicurarti di aver scaricato questa app da Google, fai clic su Accedi.

   Nel browser si apre una nuova scheda in cui è visualizzato il codice di verifica per accedere a Cloud Code.

7. Copia il codice di verifica e incollalo nel terminale in cui è riportato Inserisci codice di autorizzazione, quindi premi Invio (per Windows e Linux) o Invio (per macOS).

   Ora sei in contatto con Google Cloud.

A questo punto, per selezionare un Google Cloud progetto in cui è abilitata l'API Gemini per Google Cloud, segui questi passaggi:

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

   

2. Nel menu Gemini Code Assist, seleziona Seleziona progetto Gemini Code.

3. Seleziona un Google Cloud progetto in cui è abilitata l'API Gemini per Google Cloud.

   Gemini è pronto per l'uso.

   

Prova Gemini Code Assist

In questa sezione imparerai come aprire il riquadro Gemini Code Assist e chattare con Gemini Code Assist per ottenere una spiegazione del codice esistente.

Per iniziare a chattare con Gemini, segui questi passaggi:

1. Apri il file di codice.

2. Nella barra delle attività della tua workstation, fai clic su spark Gemini Code Assist.

3. Nel riquadro Gemini Code Assist, inserisci il prompt Explain this code to me e fai clic su send Invia.

   Gemini utilizza il codice nel file di codice come riferimento al tuo prompt e risponde con una spiegazione del codice.

   Per fare riferimento a un blocco specifico di codice anziché a tutto il codice nel file, puoi selezionare il blocco nel file di codice e fare un prompt a Gemini.

Reimposta cronologia chat

Gemini Code Assist usa la cronologia chat per maggiore contesto quando risponde ai tuoi prompt.

Se la cronologia chat non è più pertinente ai risultati che vuoi ottenere, puoi reimpostarla: nel riquadro Gemini Code Assist, fai clic su delete Reimposta chat.

Genera codice con 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 chiedere aiuto a Gemini Code Assist tramite la funzionalità di chat, nonché ricevere e accettare o rifiutare i suggerimenti di codice durante la programmazione.

Chiedi a Gemini Code Assist in un file di codice

1. Nel file di codice, in una nuova riga, inserisci il commento Function to create a Cloud Storage bucket, quindi premi Invio (per Windows e Linux) o Invio (per macOS).

2. Per generare il codice, premi Ctrl+Invio (per Windows e Linux) o Ctrl+Invio (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.

(Facoltativo) Modifica la scorciatoia da tastiera per la generazione del codice

Se la scorciatoia da tastiera predefinita per la generazione di codice non funziona come descritto nella sezione precedente, puoi modificarla seguendo questi passaggi:

1. Nella tua postazione di lavoro, fai clic sumenu Menu, quindi vai a File > Preferenze > Scorciatoie da tastiera.

2. Nell'elenco delle scorciatoie da tastiera, cerca Cloud Code: Generate Code (Genera codice).

3. Fai clic su Cloud Code: Genera codice, quindi fai clic su edit Cambia Keybinding.

4. Nella finestra di dialogo visualizzata, inserisci il tuo collegamento.

5. Premi Invio (per Windows e Linux) o Invio (per macOS).

   Ora puoi utilizzare la scorciatoia da tastiera appena assegnata per generare codice con Gemini.

Chiedi a Gemini Code Assist con il codice selezionato utilizzando la chat

Gemini Code Assist può eseguire attività o rispondere alle tue domande in base al codice selezionato. Per generare il codice basato su un prompt con codice selezionato:

1. Nella barra delle attività, fai clic su spark Gemini Code Assist per aprire il riquadro Gemini Code Assist.

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

3. Nel campo di testo del riquadro Gemini Code Assist, inserisci un prompt per il codice selezionato.

   Ad esempio, seleziona una funzione nel codice e inserisci il prompt Write a unit test for this function:

   

   Gemini usa il codice selezionato come riferimento e risponde al tuo prompt.

Ricevi suggerimenti in linea durante la programmazione

Durante la scrittura del codice, Gemini Code Assist fornisce suggerimenti di codice in linea che puoi accettare o ignorare. Per provare questa funzionalità, segui questi passaggi:

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

   Gemini suggerisce il codice sotto forma di testo fantasma.

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

(Facoltativo) Disattiva i suggerimenti in linea

Se preferisci disabilitare i suggerimenti incorporati in Gemini Code Assist, segui questi passaggi:

1. Nella tua postazione di lavoro, selezionamenu Menu, quindi vai a File > Preferenze > Impostazioni.

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

3. Scorri fino a trovare l'elenco Cloudcode: Gemini Code Assist: Inline Suggestions: Abilita automaticamente, quindi seleziona Off.

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

(Facoltativo) Escludi i file dal contesto con un file .aiEscludi

Puoi impedire che i file vengano presi in considerazione da Gemini Code Assist per il contesto creando un file .aiexclude. Un file .aiexclude segue la sintassi simile di un file .gitignore, con le seguenti differenze:

• Un file .aiexclude vuoto o inesistente non blocca nessun file nella sua directory e in tutte le sottodirectory.
• Un file .aiexclude non supporta la negazione, in cui aggiungi un punto esclamativo (!) prima dei pattern.
• Un file .aiexclude trova corrispondenze con il carattere *. Questi risultati corrispondono indiscriminatamente a directory e file. Questo file .aiexclude non fa distinzione tra ** e * per quanto riguarda le cartelle o i file.

Al momento è supportato un solo file .aiexclude. Per configurare il file .aiexclude, crea un file denominato .aiexclude nella radice della cartella dell'area di lavoro. Se vuoi posizionare il file all'esterno della radice dell'area di lavoro o rinominare il file, puoi configurare il percorso nelle impostazioni di VS Code in "File di esclusione contesto". Il valore del percorso fornito in questa impostazione verrà risolto relativo alla cartella principale dell'area di lavoro aperta.

Esempi

I seguenti esempi dimostrano come configurare un file .aiexclude:

• Blocca tutti i file denominati apikeys.txt nella directory di Workspace o inferiore:

  apikeys.txt
  

• Blocca tutti i file con l'estensione .key nella directory di Workspace o al di sotto:

  *.key
  

• Blocca solo il file apikeys.txt nella stessa directory del file .aiexclude, ma non le sottodirectory:

  /apikeys.txt
  

• Blocca tutti i file nella directory my/sensitive/dir e in tutte le sottodirectory. Il percorso deve essere relativo alla directory principale dell'area di lavoro.

  my/sensitive/dir/*
  

Disattiva i suggerimenti di codice che corrispondono alle fonti citate

Gemini fornisce informazioni sulle citazioni quando cita direttamente da un'altra fonte, come il codice open source esistente. Per maggiori informazioni, vedi Come e quando Gemini cita le fonti.

Per evitare che venga suggerito codice corrispondente alle fonti citate, puoi modificare l'impostazione geminicodeassist.recitation.maxCitedLength in 0 in un file settings.json:

"geminicodeassist.recitation.maxCitedLength": 0

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 elenco di azioni pertinenti al tuo contesto.

Per utilizzare le azioni rapide nel codice:

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

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

   

3. Seleziona un'azione come Genera test di unità.

   Gemini genera una risposta basata sull'azione selezionata.

Usa la trasformazione del codice

Gemini Code Assist fornisce la trasformazione del codice, che consente di selezionare una parte del file di codice e di richiedere modifiche al codice esistente tramite prompt in linguaggio naturale utilizzando una casella di testo in linea.

Con la trasformazione del codice, puoi fare quanto segue:

• Genera righe di commento per documentare il codice
• Risolvere i problemi relativi al codice
• Migliora la leggibilità del codice
• Rendi il codice più efficiente

Puoi anche visualizzare le origini contesto di una risposta generata nel riquadro Gemini: Chat.

Chiedi a Gemini Code Assist con la casella di testo in linea

La casella di testo in linea ti consente di interagire con Gemini Code Assist direttamente nel file di codice.

Per aprire la casella di testo in linea e chiedere a Gemini, segui questi passaggi:

1. Nel file di codice, premi Ctrl+I (per Windows e Linux) o Comando+I (per macOS).

2. Inserisci un prompt, come Write a function to create a Cloud Storage bucket, e premi Invio (per Windows e Linux) o Invio (per macOS).

   Gemini Code Assist genera il codice in base al tuo prompt.

Visualizza le differenze del codice sottoposto a refactoring

Con la visualizzazione delle differenze integrata nella casella di testo in linea, puoi vedere le modifiche suggerite da Gemini e il tuo codice originale. Puoi quindi accettare o ignorare le modifiche suggerite.

Per visualizzare la differenza del codice sottoposto a refactoring dalla casella di testo incorporata, segui questi passaggi:

1. Nel file di codice, seleziona una funzione e apri la casella di testo incorporata premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).

2. Inserisci un prompt, ad esempio Add comments, e premi Invio (per Windows e Linux) o Invio (per macOS).

   Quando Gemini genera le modifiche al codice della funzione selezionata, appare la vista diff.

   

3. Per accettare o ignorare le modifiche, fai clic su Accetta o Ignora.

Visualizza le origini contesto di una risposta generata

La funzionalità di visualizzazione contestuale elenca i file di progetto (le fonti di contesto) utilizzati come riferimento per generare risposte ai tuoi prompt. Sapere quali file sono stati utilizzati come riferimenti ti consente di perfezionare i prompt e ottenere risposte più specifiche. Le fonti di contesto vengono mostrate ogni volta che usi la chat con Gemini.

Per visualizzare le origini contestuali della risposta generata, scorri fino a visualizzare lo snippet Origini di contesto nel riquadro Gemini: Chat. Espandi lo snippet per vedere tutte le origini di contesto.

Utilizzare gli smart comandi

I comandi intelligenti sono comandi che puoi utilizzare nella casella di testo incorporata per eseguire azioni specifiche nel codice.

Per ottenere una spiegazione dell'intero file di codice con lo smart command /explain, segui questi passaggi:

1. Nel file di codice, apri la casella di testo in linea premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).

2. Premi / per visualizzare l'elenco dei comandi intelligenti e le relative descrizioni.

3. Seleziona /explain.

   Gemini genera una spiegazione dell'intero file di codice nella casella di testo in linea.

4. (Facoltativo) Se vuoi visualizzare la risposta generata nel riquadro Gemini: Chat, fai clic su Visualizza in Chat.

Visualizza la cronologia dei prompt

L'accesso alla cronologia dei prompt ti consente di risparmiare tempo quando devi inserire le stesse richieste in un file di codice di grandi dimensioni.

Per accedere alla cronologia dei prompt, nel file di codice apri la casella di testo incorporata premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS), quindi premi Ctrl+Freccia su (per Windows e Linux) o Comando+Freccia su (per macOS). In questo modo puoi scorrere i tuoi prompt meno recenti e riutilizzarli quando necessario.

Migliora la leggibilità del codice per gli utenti non madrelingua inglese

Se non sei madrelingua inglese e utilizzi applicazioni di traduzione, puoi utilizzare la casella di testo in linea per generare commenti in altre lingue.

Per convertire i commenti dall'inglese in un'altra lingua o aggiungere nuovi commenti in un'altra lingua, procedi nel seguente modo:

1. Nel file di codice, seleziona il codice a cui vuoi aggiungere commenti.

2. Apri la casella di testo in linea premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).

3. Inserisci un prompt, come Add spanish comments, e premi Invio (per Windows e Linux) o Invio (per macOS).

   Gemini genera commenti nella lingua specificata nel prompt e vede le differenze tra questi suggerimenti.

4. Per accettare o ignorare queste modifiche al codice, fai clic su Accetta o Ignora.

Testa altri prompt di esempio

Dopo aver letto la sezione Genera codice con prompt di questo documento, prova alcuni dei seguenti prompt di esempio.

Ricevi una spiegazione del codice

1. Nel file di codice, seleziona una funzione che vuoi spiegare.

2. Nel riquadro Gemini Code Assist, inserisci il prompt Explain this code to me.

   Gemini usa il codice selezionato come riferimento e risponde con una spiegazione della funzione selezionata.

Genera piani di test

1. Nel file di codice, seleziona il codice per cui vuoi aggiungere i test delle unità.
2. Nel riquadro Gemini Code Assist, inserisci il prompt Write unit tests for my code.

Assistenza per il debug del codice

1. Nel file di codice, seleziona il codice di cui vuoi eseguire il debug.
2. Nel riquadro Gemini Code Assist, inserisci il prompt Help me debug my code.

Rendi il codice più leggibile

1. Nel file di codice, seleziona il codice che vuoi rendere più leggibile.

2. Nel riquadro Gemini Code Assist, inserisci il prompt Make my code more readable.

   Se preferisci concentrarti su una parte specifica del codice, seleziona la parte preferita del codice prima di inviare un prompt a Gemini.

Problemi noti

Le sezioni seguenti descrivono i problemi noti di Gemini Code Assist.

Gli avvisi relativi alle richieste di licenza non vengono mantenuti tra una sessione e l'altra

Se gli avvisi relativi alla lettura della licenza non persistono nelle sessioni, consulta i log permanenti:

1. Fai clic su menu Menu > Visualizza > Output.

2. Seleziona Gemini Code Assist - Citations.

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

Se vedi 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 in modo da consentire la comunicazione su HTTP/2 utilizzato da gRPC.

Puoi utilizzare lo strumento grpc-health-probe per verificare 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 non riuscito genera il seguente output:

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

Per ottenere ulteriori dettagli, esegui questo comando prima di grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Gemini Code Assist e gateway JetBrains

Gemini Code Assist non viene eseguito tramite il gateway JetBrains. Di conseguenza, Gemini Code Assist non viene eseguito negli IDE di Cloud Workstations che richiedono la connessione del gateway JetBrains.

L'opzione "Attiva Gemini Code Assist" viene visualizzata ancora dopo aver selezionato il progetto Gemini Code Assist

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

Per scoprire ulteriori dettagli sul problema, svolgi le seguenti azioni:

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

2. Fai clic su Mostra in corrispondenza di qualsiasi file di log per visualizzare ulteriori dettagli e per facilitare la risoluzione del problema.

Lascia un feedback

Per lasciare un feedback sulla tua esperienza, procedi nel seguente modo:

1. Nella barra di stato, fai clic su Gemini Code Assist e quindi nel menu Scelta rapida, seleziona Invia feedback.

2. Nel modulo, compila i campi Titolo e Commenti.

3. Se vuoi condividere i log di Skaffold o AI Companion, assicurati di selezionare l'opzione Invia log Skaffold o Invia log AI Companion.

4. Fai clic su Invia feedback.

Passaggi successivi

• Scopri come scrivere prompt migliori.