Scrivi codice con Gemini Code Assist

Questo documento descrive come utilizzare Gemini Code Assist, un collaboratore basato sull'AI di Google Cloud, per eseguire le seguenti operazioni nell'IDE:

  • Fornire indicazioni per aiutarti a risolvere i problemi relativi al codice.
  • Genera il codice per il progetto.
  • Ricevi suggerimenti in linea durante la programmazione.

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

Per aiutarti a rispettare eventuali requisiti di licenza per il tuo codice, Gemini Code Assist fornisce citazioni della fonte quando i suoi suggerimenti citano direttamente e in dettaglio una fonte specifica. Per scoprire di più su come e quando Gemini cita le fonti, consulta In che modo Gemini ti aiuta a generare codice e a citare le fonti.

La personalizzazione del codice consente di ricevere suggerimenti per il codice in base al 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 competenza. Si presume che tu abbia conoscenza pratica di IntelliJ e che tu abbia dimestichezza con Google Cloud. Se preferisci, puoi anche provare Gemini Code Assist in VS Code, Cloud Shell Editor e Cloud Workstations.

Prima di iniziare

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

  2. Se preferisci utilizzare l'IDE dietro un proxy, consulta Proxy HTTP.

Installa il plug-in Gemini Code Assist

Per installare il plug-in Gemini Code Assist nel tuo IDE JetBrains, segui questi passaggi:

  1. Fai clic su settings Impostazioni IDE e progetto > Componenti aggiuntivi.
  2. Nella scheda Marketplace, cerca Gemini Code Assist.
  3. Fai clic su Installa per installare il plug-in.
  4. Al termine dell'installazione, fai clic su Riavvia IDE.
  5. Quando l'IDE si riavvia, Gemini Code Assist viene visualizzato nella barra delle attività.

    L'icona di Gemini Code Assist viene visualizzata nella barra delle attività

Ora puoi utilizzare Gemini Code Assist nel tuo IDE.

Accedi a Google e seleziona un progetto Google Cloud

In questa sezione, accedi al tuo Account Google e, se è la prima volta che utilizzi l'assistenza alla programmazione di Gemini nell'IDE, seleziona un progetto Google Cloud.

Per accedere al tuo Account Google:

  1. Nella barra delle attività, fai clic su spark Gemini Code Assist.

  2. Fai clic su Accedi a Google.

  3. Nella pagina che si apre nel browser web, seleziona il tuo Account Google.

  4. Nella schermata che ti chiede di assicurarti di aver scaricato questa app da Google, fai clic su Accedi.

    Gemini Code Assist è ora autorizzato ad accedere al tuo account.

Se è la prima volta che utilizzi Gemini nell'IDE, devi selezionare un progetto Google Cloud seguendo questi passaggi:

  1. Torna all'IDE. Nella finestra dello strumento Gemini Code Assist, se accetti di consentire a Google di attivare le API necessarie per utilizzare Gemini Code Assist per tuo conto per il progetto selezionato, fai clic su Seleziona un progetto Google Cloud per continuare.

  2. Nella finestra di dialogo Seleziona progetto Google Cloud, cerca e seleziona il progetto Google Cloud, quindi fai clic su Ok.

  3. Fai clic su FINE.

Il progetto Google Cloud è selezionato con l'API Gemini Code Assist abilitata. Ora puoi utilizzare Gemini nel tuo IDE.

Chattare con Gemini Code Assist

In questa sezione, chiedi a Gemini Code Assist di fornire una spiegazione del codice esistente.

Per una spiegazione del codice:

  1. Nell'IDE, apri il file di codice.

  2. Nella finestra dello strumento Gemini Code Assist, inserisci il promptExplain this code to me e fai clic su Invia.

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

    Se vuoi una spiegazione solo di una parte del codice, puoi selezionare un determinato codice e richiedere di nuovo Gemini Code Assist. Gemini Code Assist utilizzerà il codice selezionato solo come riferimento alla risposta generata.

Ecco altri esempi di prompt che puoi provare a chiedere a Gemini Code Assist:

  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

Quando Gemini Code Assist ti fornisce del codice nella sua risposta, puoi selezionare le seguenti opzioni elencate alla fine della risposta:

  • Inserisci al cursore: inserisce il codice generato nel file corrente nella posizione corrente del cursore.

  • Inserisci in nuovo file: apre un nuovo file e inserisce il codice generato nel nuovo file.

Gemini elenca le azioni di codice alla fine di una risposta di codice generata.

Queste opzioni sono disponibili quando l'Assistente codice Gemini identifica il linguaggio utilizzato nel blocco di codice e se questo linguaggio è supportato nell'IDE corrente.

Visualizza la cronologia delle query

Se vuoi riutilizzare i prompt precedenti, puoi trovarli nella Cronologia query nella finestra dello strumento Gemini Code Assist facendo clic su schedule Mostra cronologia query.

Cronologia query di Gemini nella finestra dello strumento.

La cronologia delle query e delle conversazioni viene conservata nelle sessioni dell'IDE. Per cancellare la cronologia delle query e delle conversazioni, fai clic su delete Cancella cronologia conversazioni.

Pulsante per cancellare la cronologia della conversazione nella finestra dello strumento Gemini.

Generare codice con prompt

Le sezioni seguenti mostrano come utilizzare l'Assistente codice Gemini 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.

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

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

  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 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. Vai a settings Impostazioni IDE e progetto > Impostazioni > Mappa tasti > Gemini Code Assist.

  2. Fai clic con il tasto destro del mouse su Gemini Code Assist e seleziona Aggiungi scorciatoia da tastiera.

  3. Inserisci la scorciatoia da tastiera che preferisci e fai clic su OK.

  4. Fai clic con il tasto destro del mouse su Gemini Code Assist e seleziona Rimuovi Alt+G (per Windows e Linux) o Rimuovi Opzione+G (per macOS).

    Ora puoi utilizzare la nuova scorciatoia da tastiera per generare codice in un file di codice.

Chiedere a Gemini Code Assist di eseguire il codice selezionato utilizzando la chat

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

  1. Nella barra delle attività, fai clic su spark Gemini Code Assist per aprire la finestra dello strumento Gemini Code Assist.

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

  3. Nel campo di testo della finestra dello strumento 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 Code Assist utilizza il codice selezionato come riferimento e risponde al tuo prompt.

Visualizza i completamenti di codice

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

  1. Nel file di codice, in una nuova riga, inizia a scrivere una funzione. Ad esempio, se si trova in un file Python, scrivere 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 premuto il cursore sul suggerimento in linea e fai clic sul menu a discesa Tab visualizzato. Quindi, seleziona la scorciatoia che preferisci o fai clic su Personalizzata per inserirne una personalizzata.

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

Il completamento del codice è attivo per impostazione predefinita. Se vuoi disattivare il completamento del codice, nella barra di stato dell'IDE fai clic su spark Gemini Code Assist: attivo e seleziona Abilita il completamento del codice IA.

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

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

Utilizzare le azioni rapide

Per aiutarti ad aumentare la produttività riducendo al minimo il cambio di contesto, Gemini Code Assist fornisce azioni intelligenti basate sull'AI direttamente nel tuo 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 intelligenti nel codice:

  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 seleziona 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 dello strumento Gemini Code Assist.

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

Puoi escludere i file dall'essere considerati da Gemini Code Assist per il contesto creando un file .aiexclude. Un file .aiexclude segue una sintassi simile a quella 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 i pattern vengono preceduti da un punto esclamativo (!).
  • Un file .aiexclude corrisponde in modo avido al carattere *. La corrispondenza verrà eseguita indiscriminatamente su directory e file. Questo file .aiexclude non distingue tra ** o * 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 cartella principale della tua area di lavoro.

Esempi

Gli esempi seguenti mostrano come configurare un file .aiexclude:

  • Blocca tutti i file denominati apikeys.txt nella directory dello spazio di lavoro o al di sotto:

    apikeys.txt
    
  • Blocca tutti i file con estensione .key nella directory dello spazio di lavoro 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 dello spazio di lavoro.

    my/sensitive/dir/*
    

Lascia un feedback

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

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

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

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

  4. Fai clic su Invia feedback.

Passaggi successivi