Scrivi codice con Gemini Code Assist

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

  • Fornire 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 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 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.

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

Questo documento è rivolto a sviluppatori di tutti i livelli di abilità. Si presume che tu abbia conoscenza pratica di IntelliJ e che tu abbia dimestichezza con Google Cloud. Se preferisci, puoi anche esplorare Gemini Code Assist in Cloud Workstations, Cloud Code for VS Code e Cloud Shell Editor.

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, consulta Linguaggi di programmazione supportati.

  2. Installa il Gemini Code Assist/estensione Cloud Code se non l'hai già fatto. Gemini Code Assist e Cloud Code sono raggruppati.

  3. 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 Impostazioni Impostazioni IDE e progetto > Componenti aggiuntivi.
  2. Nella scheda Marketplace, cerca Gemini Code Assist/Cloud Code.
  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 è tutto pronto per 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 scrittura 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 verificare di aver scaricato l'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 autorizzare Google ad abilitare 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 progetto Google Cloud e fai clic su OK.

  3. Fai clic su TERMINA.

Il progetto Google Cloud è selezionato con l'API Gemini Code Assist abilitata. Ora puoi usare 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 ottenere una spiegazione del tuo codice, segui questi passaggi:

  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 un riferimento al prompt e risponde con una spiegazione del codice.

    Se vuoi una spiegazione solo di una parte specifica del codice, puoi selezionare un certo codice, quindi chiede di nuovo a Gemini Code Assist. Gemini Code Assist utilizzerà solo il codice selezionato come riferimento alla sua risposta generata.

Ecco alcuni altri esempi di prompt che puoi provare a chiedere a Gemini Assistente codice:

  • 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 in corrispondenza del cursore: consente di inserire il codice generato nel file corrente alla pagina la posizione attuale 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 Gemini Code Assist identifica il linguaggio utilizzato nel blocco di codice e se è supportato nell'IDE attuale.

Visualizzare la cronologia delle query

Se vuoi riutilizzare i prompt precedenti, puoi trovarli nella sezione Query Cronologia 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 Elimina Cancella cronologia conversazioni.

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

Ricevi completamenti codice

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

  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 Code Assist suggerisce il codice sotto forma di codice suggerimento.

  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 è abilitato per impostazione predefinita. Se vuoi disabilitare il completamento del codice, Nella barra di stato del tuo IDE, fai clic su spark Completamento del codice IA: 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'IA 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 rapide 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 rapida, ad esempio Genera i test delle unità.

    Se selezioni l'azione intelligente, Gemini Code Assist genererà automaticamente una risposta al prompt nella finestra dello strumento Gemini Code Assist.

Escludi file dal contesto

Se vuoi escludere uno qualsiasi dei tuoi file da Gemini Code Assist i completamenti e le interazioni via chat, puoi creare un file .aiexclude, funziona in modo simile a .gitignore.

Per ulteriori informazioni su come configurare un file .aiexclude, consulta Configurare la condivisione del contesto con i file .aiexclude.

Problemi noti

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

La scorciatoia per il completamento del codice di JetBrains si sovrappone alla scorciatoia di Gemini Code Assist

Nelle versioni di JetBrains 2024.2, potresti riscontrare che il tasto di scorciatoia di Gemini Code Assist per la generazione di codice (Alt+Maiusc+\ per Windows e Linux o Opzione+Maiusc+\ per macOS) si sovrappone alla scorciatoia di completamento del codice di JetBrains introdotta di recente.

Per modificare la scorciatoia da tastiera per Gemini Code Assist, esegui le le seguenti attività:

  1. Vai a Impostazioni 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+Shift+\ (per Windows e Linux) oppure Rimuovi Option+Shift+\ (per macOS).

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

Lascia un feedback

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

  1. Nella barra di stato, fai clic su spark. Completamento del codice IA, quindi 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