Scrivi codice con Gemini Code Assist

Questo documento descrive come utilizzare Gemini Code Assist, un collaboratore basato sull'AI in Google Cloud, per svolgere le seguenti operazioni 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.

Gemini non utilizza i tuoi prompt o le sue risposte come dati per addestrare i suoi modelli. Per maggiori informazioni, consulta In che modo Gemini per Google Cloud utilizza i tuoi dati.

Per aiutarti a soddisfare i requisiti di licenza per il tuo codice, Gemini Code Assist fornisce citazioni di fonti 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 cita le fonti.

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

Prima di iniziare

  1. Se non l'hai ancora fatto, installa il plug-in Cloud Code. Gemini Code Assist è integrato con Cloud Code per portare il collaboratore basato sull'AI nel tuo IDE locale.
  2. (Facoltativo) Se scegli di clonare un campione per le attività in questo documento, installa Git. Git è necessario per copiare gli esempi sulla tua macchina.

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 nel tuo IDE.

Se selezioni un progetto Google Cloud senza l'API Cloud AI Companion abilitata, riceverai una notifica di errore e ti verrà chiesto di contattare l'amministratore. Per maggiori informazioni, consulta Configurare Gemini Code Assist per un progetto.

Per connetterti a Google Cloud nel tuo IDE, segui questi passaggi:

  1. Avvia il tuo IDE.

  2. Fai clic su Strumenti > Google Cloud Code > Accedi a Google Cloud Platform.

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

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

    È stata stabilita la connessione a Google Cloud.

Quindi, per selezionare un progetto Google Cloud in cui è abilitata l'API Cloud AI Companion, segui questi passaggi:

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

    Gemini.

  2. Nel menu Gemini Code Assist, seleziona Settings (Impostazioni).

  3. Nel campo Progetto Cloud, fai clic su more_horiz Seleziona progetto Google Cloud e seleziona un progetto per cui è abilitata l'API Cloud AI Companion.

    Gemini è pronto per l'uso.

Per testare le funzionalità di Gemini Code Assist, apri un'applicazione o crea un'applicazione di esempio nella sezione successiva.

(Facoltativo) Crea un'applicazione di esempio

Se preferisci utilizzare un'applicazione esistente per testare le funzionalità di Gemini Code Assist, puoi saltare questa sezione. In caso contrario, per creare un'applicazione di esempio:

  1. Nel tuo IDE, fai clic su File > Nuovo > Progetto.

  2. Nel riquadro sinistro della finestra Nuovo progetto, seleziona Cloud Code: Kubernetes.

  3. Seleziona uno degli esempi di Guestbook corrispondente alla tua lingua preferita, quindi fai clic su Avanti.

  4. Inserisci un nome per il progetto e scegli una posizione.

  5. Fai clic su Crea.

    Cloud Code clona il modello Python (Flask) e apre il progetto appena creato per l'utilizzo.

Chatta con Gemini Code Assist

In questa sezione imparerai ad aprire il riquadro Gemini Code Assist e a chattare con Gemini Code Assist per ricevere una spiegazione del tuo codice esistente.

Per iniziare a chattare con Gemini, segui questi passaggi:

  1. Crea un file di codice o utilizzane uno esistente. Se utilizzi l'esempio Python (Flask), puoi eseguire questa attività nel file front.py: nella finestra dello strumento Progetto, vai a src > Frontend e apri il file front.py.

  2. Nella barra di stato, fai clic su Gemini Code Assist, quindi seleziona Apri chat.

    Il pulsante Gemini nella barra di stato di Cloud Code mostra l'opzione Apri chat.

  3. Nella finestra della chat di Gemini Code Assist, inserisci il prompt Explain this code to me e fai clic su Invia.

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

Reimposta cronologia chat

Gemini Code Assist utilizza la cronologia chat per fornire un contesto aggiuntivo quando risponde ai tuoi prompt.

Se la tua cronologia chat non è più pertinente ai fini del tuo tentativo, puoi reimpostarla: 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 codice con il prompt di esempio # Function to create a Cloud Storage bucket all'interno di un file Python. Puoi anche ricevere e accettare o rifiutare suggerimenti di codice durante la programmazione.

Prompt Gemini Code Assist in un file di codice

  1. Crea un nuovo file di codice o utilizzane uno esistente. Se utilizzi l'esempio Python (Flask), puoi farlo nel tuo file front.py: nel riquadro Progetto, vai a python-guestbook > src > frontend e apri il file front.py.

  2. Nel file di codice, inserisci # Function to create a Cloud Storage bucket in una nuova riga, quindi premi Invio (per Windows e Linux) o Invio (per macOS).

  3. Per generare il codice, premi Alt+Shift+\ (per Windows e Linux) o Opzione+Shift+\ (macOS). In alternativa, nella sezione del file di codice, fai clic su spark Gemini Code Assist.

    Il gutter in Cloud Code mostra l'icona Genera codice con Gemini.

    Accanto al testo del prompt nel file Python, Gemini Code Assist genera il codice sotto forma di testo fantasma.

  4. (Facoltativo) Per accettare il codice generato, premi Tab. Se preferisci accettare una singola riga del codice generato, premi Maiusc+Invio.

(Facoltativo) Modifica della scorciatoia da tastiera per la generazione del codice

Se la scorciatoia da tastiera predefinita per la generazione del codice non funziona come descritto nella sezione precedente, puoi modificarla seguendo questa procedura:

  1. Nel tuo IDE, fai clic su File (per Windows e Linux) o IntelliJ IDEA (per macOS), quindi vai a Impostazioni > Keymap > Plugin > Google Cloud Code.

  2. Nell'elenco delle scorciatoie da tastiera, scorri fino a Genera codice.

  3. Fai clic con il tasto destro del mouse su Genera codice e seleziona Aggiungi scorciatoia da tastiera.

  4. Nella finestra di dialogo Scorciatoia da tastiera, fai doppio clic sulla scorciatoia da tastiera corrente, quindi inserisci la tua scorciatoia.

  5. Fai clic su Ok.

  6. Fai clic su Applica e poi su OK.

    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 Configurare le scorciatoie da tastiera.

Ricevi suggerimenti in linea durante la programmazione

Mentre scrivi il codice, Gemini Code Assist fornisce suggerimenti di codice in linea che puoi accettare o ignorare. Per provare questa funzionalità, segui questi passaggi:

  1. Crea un nuovo file di codice o utilizzane uno esistente. Se utilizzi l'esempio Python (Flask), puoi farlo nel tuo file front.py: nel riquadro Progetto, vai a python-guestbook > src > frontend e apri il file front.py.

  2. 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 suggerisce il codice sotto forma di testo fantasma.

  3. Per accettare il suggerimento di codice di Gemini Code Assist, premi Tab. Altrimenti, per ignorare il suggerimento, premi Esc o continua a scrivere il codice.

Disattiva i suggerimenti di codice che corrispondono alle fonti citate

Gemini fornisce informazioni sulle citazioni quando cita direttamente un'altra fonte, come un codice open source. Per saperne di più, consulta Come e quando Gemini cita le fonti.

Per evitare che venga suggerito il codice che corrisponde alle origini citate, puoi modificare l'impostazione cloudcode.duetAI.recitation.maxCitedLength in 0 in un file settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Testare altri prompt di esempio

Dopo aver letto la sezione Genera codice con prompt di questo documento, prova alcuni dei prompt di esempio riportati di seguito.

Nel riquadro della chat di Gemini Code Assist, inserisci uno dei seguenti prompt:

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

Problemi noti

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

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

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

IdeaVim: il plug-in non mostra il suggerimento Gemini Code Assist quando premi Esc per ignorare il suggerimento di IntelliJ

Quando utilizzi il plug-in IdeaVim in IntelliJ, se premi Esc per ignorare il suggerimento di IntelliJ, viene attivata la modalità di comando VIM e non viene mostrato il suggerimento di Gemini Code Assist.

Gemini Code Assist funziona come previsto in modalità di inserimento.

IdeaVim: non è possibile accettare suggerimenti per la generazione di codice a meno che non sia in modalità di inserimento

Quando utilizzi il plug-in IdeaVim in modalità normale, non puoi accettare suggerimenti di codice.

Per risolvere questo problema, premi i per attivare la modalità di inserimento, quindi premi i per accettare il suggerimento.

Per ignorare il suggerimento, premi Esc.

Lascia un feedback

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

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

  2. Inserisci il tuo feedback nel campo di testo in alto nel modulo.

  3. Se desideri condividere i log di Gemini Code Assist, assicurati di selezionare le opzioni di log.

  4. Fai clic su Invia feedback.

Passaggi successivi