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.
Per aiutarti rispettare eventuali requisiti di licenza per il tuo codice, Gemini Code Assist fornisce citazioni di fonti quando i suoi suggerimenti citare direttamente e in dettaglio una fonte specifica. Per saperne di più su come e quando Gemini cita le fonti, vedi In che modo Gemini ti aiuta a generare codice e cita le fonti.Questo documento è rivolto a sviluppatori di ogni livello di abilità. Si presume che hanno una conoscenza lavorativa Cloud Workstations e hanno familiarità con Google Cloud. Se preferisci, puoi anche esplorare Gemini Code Assist in Cloud Code for VS Code Cloud Code for IntelliJ e Editor di Cloud Shell.
Prima di iniziare
-
Assicurati di avere l'amministratore Cloud Workstations ruolo IAM sul progetto per consentirti di creare workstation configurazioni.
Configura dalla tua workstation, se non l'hai già fatto e assicurati di selezionare Editor base (Code-OSS) nella configurazione.
- Prima di testare le funzionalità di Gemini Code Assist nel tuo codice assicurati che il relativo linguaggio di codifica sia supportato. Per ulteriori informazioni sui linguaggi di programmazione supportati, vedi Linguaggi di programmazione supportati.
Connettiti a Google Cloud e seleziona un progetto
In questa sezione, ti connetterai a Google Cloud e selezionerai un nel progetto Google Cloud con l'API Gemini per Google Cloud abilitata in dalla tua workstation.
Se selezioni un progetto Google Cloud senza l'API Gemini per Google Cloud è abilitata, ricevi una notifica che l'opzione per abilitare l'API dall'IDE. Seleziona Abilita l'API nella finestra di notifica per abilitare l'API per il progetto. Per ulteriori informazioni, consulta Configurare Gemini Code Assist per un progetto.
Per connetterti a Google Cloud in la tua workstation, segui questi passaggi:
Nella console Google Cloud, avvia la workstation.
Nella barra di stato, fai clic su Cloud Code - Accedi.
Quando ti viene chiesto di accedere, fai clic su Procedi per accedere.
Per avviare il flusso di accesso a Google Cloud, premi Ctrl (per Windows e Linux) o Command (per macOS) e fai clic sull'URL nella la console.
Se viene richiesto di consentire a Cloud Workstations di aprire l'interfaccia esterna Fai clic su Apri.
Segui le istruzioni per accedere al tuo account.
Se ti viene richiesto di verificare 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 da firmare in Cloud Code.
Copia il codice di verifica e incollalo nel terminale, dove è riportato Inserisci il codice di autorizzazione, quindi premi Invio (per Windows e Linux) o Return (per macOS).
La connessione a Google Cloud è stata completata.
Poi, per selezionare un progetto Google Cloud che includa l'API Gemini per Google Cloud. attiva, procedi nel seguente modo:
Nella barra di stato di Gemini Code Assist, fai clic su Gemini Code Assist.
Nel menu Gemini Code Assist, seleziona Seleziona il codice Gemini progetto.
Seleziona un progetto Google Cloud che includa l'API Gemini per Google Cloud in un bucket in cui è abilitato il controllo delle versioni.
Gemini è pronto per l'uso.
Prova Gemini Code Assist
In questa sezione imparerai ad aprire il riquadro Gemini Code Assist e a chattare con Gemini Code Assist per ottenere una spiegazione delle le API nel tuo codice.
Per iniziare a chattare con Gemini, segui questi passaggi:
Apri il file di codice.
Nella barra delle attività del workstation, fai clic su spark Gemini Code Assist.
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 il 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 utilizza la cronologia chat per fornire contesto aggiuntivo quando rispondi ai tuoi prompt.
Se la cronologia chat non è più pertinente ai risultati che desideri ottenere, puoi reimpostare la cronologia chat: 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 il 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 a Gemini Code Assist di aiutarti tramite la funzionalità di chat e
ricevere e accettare o rifiutare suggerimenti di codice durante la programmazione.
Chiedi a Gemini Code Assist in un file di codice
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 Return (per macOS).Per generare il codice, premi Ctrl+Invio (per Windows e Linux) oppure Ctrl+Invio (per macOS).
Gemini Code Assist accanto al testo del prompt nel file di codice genera il codice sotto forma di testo fantasma.
(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 generare il codice non funziona come descritto nella sezione precedente, puoi modificare la scorciatoia da tastiera seguendo questi passaggi:
Nella workstation, fai clic su menu Menu e poi vai a File > Preferenze > Scorciatoie da tastiera.
Nell'elenco delle scorciatoie da tastiera, cerca Cloud Code: Generate Code (Genera codice).
Fai clic su Cloud Code: genera codice, quindi fai clic su modifica Cambia keybinding.
Nella finestra di dialogo visualizzata, inserisci il tuo collegamento.
Premi Invio (per Windows e Linux) o Invio (per macOS).
Ora puoi utilizzare la scorciatoia da tastiera appena assegnata per generare codice con o 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 ottenere un codice generato basato su un con il codice selezionato, segui questi passaggi:
Nella barra delle attività, fai clic su spark. Gemini Code Assist per aprire il riquadro Gemini Code Assist.
Seleziona un blocco di codice nel file di codice.
Nel campo di testo del riquadro Gemini Code Assist, inserisci un prompt per con il codice selezionato.
Ad esempio, seleziona una funzione nel codice e inserisci il prompt
Write a unit test for this function
:Gemini utilizza il codice selezionato come riferimento risponde al tuo prompt.
Ricevi suggerimenti in linea durante la programmazione
Mentre scrivi il codice, Gemini Code Assist genera il codice in linea suggerimenti che puoi accettare o ignorare. Per provare questa funzionalità, segui questi passaggi:
Nel file di codice, inizia a scrivere una funzione su una nuova riga. Ad esempio, se sei in un file Python, scrivi
def
.Gemini suggerisce il codice sotto forma di testo fantasma.
Per accettare il suggerimento di codice da Gemini Code Assist, premi Scheda. Altrimenti, per ignorare il suggerimento, premi Esc o continua a scrivere il codice.
(Facoltativo) Disattiva i suggerimenti in linea
Se preferisci disabilitare i suggerimenti in linea in Gemini Code Assist, segui questi passaggi:
Nella workstation, seleziona menu Menu, quindi vai a File > Preferenze > Impostazioni.
Nella scheda Utente della finestra di dialogo Impostazioni, vai a Estensioni. > Cloud Code.
Scorri fino a trovare Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Automatica, quindi seleziona Off.
Questa operazione disattiva i suggerimenti in linea. Puoi ancora premere Ctrl+Invio (per Windows e Linux) o Ctrl+Invio (per macOS) per attivare manualmente i suggerimenti in linea.
Disattiva i suggerimenti di codice che corrispondono alle fonti citate
Gemini fornisce informazioni sulle citazioni quando cita direttamente da un'altra sorgente, come il codice open source esistente. Per ulteriori informazioni le informazioni, vedi Come e quando Gemini cita le fonti.
Per evitare che venga suggerito codice corrispondente alle fonti citate, puoi modificare
l'impostazione cloudcode.duetAI.recitation.maxCitedLength
su 0
in un
File settings.json
:
"cloudcode.duetAI.recitation.maxCitedLength": 0
Utilizzare le azioni rapide
Per aumentare la tua produttività riducendo al minimo il cambio di contesto, Gemini Code Assist fornisce direttamente azioni intelligenti basate sull'AI nell'editor di codice. Quando selezioni il codice nell'editor di codice, puoi visualizzare e seleziona da un elenco di azioni pertinenti al tuo contesto.
Per utilizzare le azioni rapide nel codice:
Seleziona un blocco di codice nel file di codice.
Accanto al blocco di codice selezionato, fai clic su lightbulb Mostra azioni codice.
Seleziona un'azione, ad esempio Genera test delle unità.
Gemini genera una risposta basata sull'azione che selezionato.
Anteprima: utilizza le trasformazioni del codice
Gemini Code Assist fornisce trasformazioni del codice, che ti consentono selezionare una parte del file di codice e richiedere modifiche il codice esistente tramite prompt in linguaggio naturale, utilizzando una casella di testo in linea.
Con le trasformazioni del codice, puoi:
- 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 fonti di contesto di una risposta generata in Gemini: Chat.
Chiedi a Gemini Code Assist con la casella di testo in linea
La casella di testo in linea ti consente di interagire Gemini Code Assist direttamente nel file di codice.
Per aprire la casella di testo in linea e chiedere a Gemini, segui questi passaggi:
Nel file di codice, premi Ctrl+I (per Windows e Linux) o Comando+I (per macOS).
Inserisci un prompt, ad esempio
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 Gemini e il tuo codice originale. Puoi quindi accettare o ignora le modifiche suggerite.
Per visualizzare la differenza del codice sottoposto a refactoring dalla casella di testo in linea, esegui la seguenti passaggi:
Nel file del codice, seleziona una funzione e apri la casella di testo in linea premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).
Inserisci un prompt, ad esempio
Add comments
e premi Invio (per Windows e Linux) o Return (per macOS).Quando Gemini genera le modifiche al codice dell'elemento selezionato viene visualizzata la vista diff.
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) utilizzate come riferimento per generare risposte ai tuoi prompt. Sapere quale usati come riferimenti ti aiutano a perfezionare i prompt e a ottenere risposte specifiche. Le origini del contesto vengono mostrate ogni volta che utilizzi Gemini Chat.
Per visualizzare le origini contestuali della risposta generata, in Gemini: Chat scorri fino allo snippet Origini di contesto. 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 in linea per eseguire azioni specifiche al tuo codice.
Per ottenere una spiegazione dell'intero file di codice con lo smart /explain
procedi nel seguente modo:
Nel file del codice, apri la casella di testo in linea premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).
Premi / per visualizzare l'elenco dei comandi intelligenti e le relative descrizioni.
Seleziona
/explain
.Gemini genera una spiegazione dell'intero file di codice nella casella di testo in linea.
(Facoltativo) Se vuoi visualizzare la risposta generata in 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 lo stesso in un file di codice di grandi dimensioni.
Per accedere alla cronologia dei prompt, apri la casella di testo in linea nel file di codice Premi 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 prompt meno recenti e riutilizzarli quando necessario.
Migliora la leggibilità del codice per gli utenti non madrelingua inglese
Se non sei madrelingua inglese e si basa su 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 lingua, procedi nel seguente modo:
Nel file di codice, seleziona il codice a cui vuoi aggiungere commenti.
Apri la casella di testo in linea premendo Ctrl+I (per Windows e Linux) o Comando+I (per macOS).
Inserisci un prompt, ad esempio
Add spanish comments
e premi Invio (per Windows e Linux) o Return (per macOS).Gemini genera commenti nella lingua che hai specificato nel prompt e vede le differenze di questi suggerimenti.
Per accettare o ignorare queste modifiche al codice, fai clic su Accetta oppure Elimina.
Testa altri prompt di esempio
Dopo aver letto Sezione Genera il codice con prompt di questo del documento, prova alcuni dei seguenti esempi di prompt.
Ricevi una spiegazione del codice
- Nel file di codice, seleziona una funzione che vuoi spiegare.
Nel riquadro Gemini Code Assist, inserisci il prompt
Explain this code to me
.Gemini utilizza il codice selezionato come riferimento risponde con una spiegazione della funzione selezionata.
Genera piani di test
- Nel file di codice, seleziona il codice per cui vuoi aggiungere i test delle unità.
- Nel riquadro Gemini Code Assist, inserisci il prompt
Write unit tests for my code
.
Assistenza per il debug del codice
- Nel file di codice, seleziona il codice di cui vuoi eseguire il debug.
- Nel riquadro Gemini Code Assist, inserisci il prompt
Help me debug my code
.
Rendi il codice più leggibile
- Nel file di codice, seleziona il codice che vuoi rendere più leggibile.
Nel riquadro Gemini Code Assist, inserisci il prompt
Make my code more readable
.Se preferisci concentrarti su una parte specifica del codice, seleziona parte del codice preferita prima di chiedere a Gemini.
Problemi noti
Le seguenti sezioni descrivono i problemi noti Gemini Code Assist.
Gli avvisi relativi alle richieste di licenza non vengono mantenuti tra una sessione e l'altra
Se gli avvisi relativi alle richieste di licenza non vengono mantenuti tra una sessione e l'altra, fai riferimento alle i log permanenti:
Fai clic sul menu Menu > Visualizza > Output.
Seleziona Gemini Code Assist - Citations.
Problemi di connettività nella finestra di output di Gemini Code Assist
Se noti 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 in modo da consentire la comunicazione su HTTP/2 utilizzato da gRPC.
Puoi utilizzare lo strumento grpc-health-probe
per verificare la connettività. Un successo
verifica i risultati nel 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 restituisce 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.
"Attiva Gemini Code Assist" appare ancora dopo aver selezionato il progetto Gemini Code Assist
Se hai selezionato il tuo progetto seguendo le istruzioni riportate in questa di Google Cloud, che include l'abilitazione dell'API Gemini per Google Cloud, potrebbero essere presenti un problema con il server LS.
Per saperne di più sul problema, procedi nel seguente modo:
Nella barra di stato, fai clic su spark. Gemini Code Assist, quindi seleziona Invia feedback.
Fai clic su Mostra per qualsiasi file di log per visualizzare ulteriori dettagli e per risolvere il problema.
Lascia un feedback
Per lasciare un feedback sulla tua esperienza, procedi nel seguente modo:
Nella barra di stato, fai clic su Gemini Code Assist e quindi sul pulsante Rapido Menu, quindi seleziona Invia feedback.
Nel modulo, compila i campi Titolo e Commenti.
Se vuoi condividere i log di Skaffold o AI Companion, assicurati di seleziona l'opzione Invia log Skaffold o Invia log AI Companion.
Fai clic su Invia feedback.
Passaggi successivi
- Scopri come scrivere prompt migliori.