Scrivi codice con Gemini Code Assist

Questo documento descrive come utilizzare Gemini Code Assist, uno strumento basato sull'AI di Google Cloud, per aiutarti a fare quanto segue in Cloud Code:

  • 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 Avere una conoscenza pratica di VS Code e hanno familiarità con Google Cloud. Se preferisci, puoi anche esplorare Gemini Code Assist in Cloud Workstations Cloud Code for IntelliJ e Editor di Cloud Shell.

Prima di iniziare

  1. 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.

  2. Installa il Gemini Code Assist + estensione Cloud Code se non l'hai già fatto. Cloud Code si integra con Gemini Code Assist nel tuo IDE.

  3. Se preferisci utilizzare l'IDE dietro un proxy, consulta Connessioni di rete nel codice di Visual Studio.

Connettiti a Google Cloud e seleziona un progetto

In questa sezione, ti connetterai a Google Cloud e selezionerai un Progetto Google Cloud con l'API Cloud AI Companion abilitata in nel tuo IDE.

Se selezioni un progetto Google Cloud senza L'API Cloud AI Companion è 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.

Se preferisci seguire le istruzioni fornite in Code with Gemini Code Assist, procedura dettagliata direttamente nel tuo IDE, fai clic su Launch VS Code e segui i passaggi nella procedura dettagliata per connetterti a Google Cloud e attivare Gemini Code Assist.

Lancio rispetto al codice

In caso contrario, attieniti alla seguente procedura:

  1. Lancia il tuo IDE.

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

    Cloud Code - Pulsante Accedi nella barra di stato.

  3. Quando ti viene richiesto di consentire a Cloud Code di aprire il sito web esterno, fai clic su Apri.

  4. Segui le istruzioni per accedere al tuo Account Google.

  5. Quando ti viene chiesto se hai scaricato Cloud Code da Google, fai clic su Accedi.

    La connessione a Google Cloud è stata completata.

Poi, per selezionare un progetto Google Cloud con l'API Cloud AI Companion attiva, procedi nel seguente modo:

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

    La barra di stato di Gemini è disponibile.

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

  3. Seleziona un progetto Google Cloud con API Cloud AI Companion abilitata.

    Gemini è pronto per l'uso.

    L'icona di Gemini nella barra di stato è impostata su normale.

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:

  1. Apri il file di codice.

  2. Nella barra delle attività del IDE: 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 Invia 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

  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 Return (per macOS).

  2. 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.

  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 generare il codice non funziona come descritto nella sezione precedente, puoi modificare la scorciatoia da tastiera seguendo questi passaggi:

  1. Nel tuo IDE, fai clic su File (per Windows e Linux) o Codice (per macOS), quindi vai a Impostazioni > Scorciatoie da tastiera.

  2. Nell'elenco delle scorciatoie da tastiera, scorri fino a trovare Cloud Code: Genera codice.

  3. Fai clic su Cloud Code: genera codice, quindi fai clic su modifica 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 Code Assist.

Per scoprire di più sulla modifica delle scorciatoie nel tuo IDE, vedi Associazioni di chiavi per il codice Visual Studio.

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:

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

  2. Seleziona un blocco di codice nel file di codice.

  3. 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 scrive un test delle unità per una funzione selezionata.

    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:

  1. 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.

  2. 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:

  1. Nel tuo IDE, selezionare Codice (per macOS) o File (per Windows e Linux) e quindi vai a Impostazioni > Impostazioni.

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

  3. 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:

  1. Seleziona un blocco di codice nel file di codice.

  2. Accanto al blocco di codice selezionato, fai clic su lampadina Mostra azioni 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 delle unità.

    Gemini genera una risposta basata sull'azione che selezionato.

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

  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 utilizza il codice selezionato come riferimento 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 parte del codice preferita prima di chiedere a Gemini.

Problemi noti

Le seguenti sezioni descrivono i problemi noti Gemini Code Assist.

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

Per aggirare il problema, seleziona una sezione di codice più piccola e includi istruzione aggiuntiva nel prompt di chat, ad esempio only output the selected code.

Vim: impossibile accettare o ignorare i suggerimenti di generazione del codice se non è in modalità di inserimento

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

Per aggirare il problema, premi I per attivare la modalità di inserimento, quindi premi Tab per accettare il suggerimento.

Vim: comportamento incoerente quando premi Esc per ignorare i suggerimenti

Quando premi Esc, sia IntelliJ sia Gemini suggerimenti vengono ignorati. Questo comportamento è diverso da quello della versione non Vim comportamento in cui la pressione di Esc riattiva Gemini.

I tentativi di accesso continuano a scadere

Se i tentativi di accesso continuano a scadere, prova ad aggiungere il token Impostazione cloudcode.beta.forceOobLogin al tuo file settings.json:

"cloudcode.beta.forceOobLogin": true

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:

  1. Fai clic su Visualizza >. Output.

  2. 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 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 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

"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 Cloud AI Companion, che include l'abilitazione dell'API Cloud AI Companion, un problema con il server LS.

Per saperne di più sul problema, procedi nel seguente modo:

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

  2. 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:

  1. Nella barra di stato, fai clic su Gemini Code Assist e poi nella menu Scelta rapida, Seleziona Invia feedback.

  2. Nel modulo, compila il Titolo e Commenti.

  3. Se vuoi condividere il tuo Skaffold o AI Companion log, assicurati di selezionare Opzione Invia log Skaffold o Invia log AI Companion.

  4. Fai clic su Invia feedback.

Passaggi successivi