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
Configura Gemini Code Assist Standard o Enterprise, se non l'hai ancora fatto.
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.
Se preferisci utilizzare il tuo IDE dietro un proxy, consulta Connessioni di rete in Visual Studio Code.
IntelliJ
Configura Gemini Code Assist Standard o Enterprise, se non l'hai ancora fatto.
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.
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
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.
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 il codice in base al prompt in una visualizzazione diff.
(Facoltativo) Per accettare queste modifiche, fai clic su Accetta.
IntelliJ
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.
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 il codice in base al prompt in una visualizzazione diff.
(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
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).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.
(Facoltativo) Per accettare il codice generato, premi Tab.
IntelliJ
Nel file di codice, su una nuova riga, inserisci il commento
Function to create a Cloud Storage bucket
.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.
(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
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.
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
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.
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.
(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.
(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
Nel tuo IDE, fai clic su Code (per macOS) o File (per Windows e Linux), quindi vai a Settings > Settings.
Nella scheda Utente della finestra di dialogo Impostazioni, vai a Estensioni > Gemini Code Assist.
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.
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
Nel file di codice, seleziona un blocco di codice.
Accanto al blocco di codice selezionato, fai clic su lightbulb Mostra azioni del codice.
Seleziona un'azione, ad esempio Genera test unitari.
Gemini Code Assist genera una risposta basata sull'azione che hai selezionato.
IntelliJ
Nel file di codice, seleziona una riga o un blocco di codice.
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
Nel file di codice, tieni il puntatore del mouse sulla riga di errore ondulata e seleziona Correzione rapida, quindi /fix.
Quando viene applicata la correzione rapida, viene visualizzata una visualizzazione differenziale. Per accettare queste modifiche, fai clic su Accetta.
IntelliJ
Nel file di codice, fai clic sull'icona a forma di lampadina rossa, che indica un errore nel codice, e seleziona Correggi con Gemini.
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:
Nella barra delle attività dell'IDE, fai clic su Gestisci > Impostazioni.
Nella scheda Utente della finestra delle impostazioni, vai a Estensioni > Gemini Code Assist.
Scorri fino a trovare Geminicodeassist > Recitation: Max Cited Length.
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 filesettings.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:
Fai clic su Visualizza > Output.
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
ecloudaicompanion.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:
Nella barra di stato, fai clic su spark Gemini Code Assist e poi seleziona Invia feedback.
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
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.
Nel modulo, compila i campi Titolo e Commenti.
Nel modulo Feedback per Gemini Code Assist, seleziona un'opzione dai menu a discesa Categoria feedback e Tipo.
Scrivi una descrizione dettagliata della tua esperienza nel campo Commento.
Assicurati di includere i log di Gemini Code Assist nella segnalazione di feedback. Per impostazione predefinita, questa opzione è selezionata.
Seleziona o deseleziona le altre opzioni, a seconda delle tue preferenze.
Fai clic su Invia feedback.
IntelliJ
Nella barra di stato, fai clic su spark Gemini Code Assist.
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.
Inserisci il tuo feedback nel campo di testo nella parte superiore del modulo.
Se vuoi condividere i log di Gemini Code Assist, assicurati di selezionare i file di log.
Fai clic su Invia feedback.
Passaggi successivi
- Scopri come scrivere prompt migliori.
- Scopri in che modo Gemini per Google Cloud utilizza i tuoi dati.
- Scopri di più sui prezzi di Gemini Code Assist.
- Scopri di più sulla conformità alGoogle Cloud .