Scrivi codice con Gemini Code Assist

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

  • Fornire indicazioni per aiutarti a risolvere i problemi relativi al codice.

  • Genera il codice per il tuo progetto.

  • Ricevi suggerimenti in linea mentre programmi.

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 scoprire di più su come e quando Gemini cita le fonti, consulta Come Gemini ti aiuta a generare codice e cita le fonti.

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

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

Connettiti a Google Cloud e seleziona un progetto

In questa sezione, ti connetterai a Google Cloud e selezionerai un progettoGoogle Cloud con l'API Gemini for Google Cloud abilitata in Cloud Shell Editor.

Se selezioni un progetto Google Cloud senza l'API Gemini for Google Cloud abilitata, ricevi una notifica che ti offre la possibilità di abilitare l'API dall'IDE. Seleziona Abilita l'API nella finestra di notifica per abilitare l'API per il tuo progetto. Per saperne di più, consulta la sezione Configura Gemini Code Assist per un progetto.

Per connetterti a Google Cloud in Cloud Shell Editor:

  1. Avvia l'editor di Cloud Shell.

  2. Se ti viene chiesto di autorizzare Cloud Shell Editor a effettuare chiamate API Google Cloud, fai clic su Autorizza.

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

  4. Accanto alla barra di ricerca, fai clic sul menu a discesa keyboard_arrow_down Gemini Code Assist.

    Menu a discesa di Gemini Code Assist.

  5. Dal menu, seleziona Seleziona progetto Gemini Code Assist. Si apre il menu Seleziona progetto Google Cloud.

  6. Dal menu Seleziona progetto Google Cloud, seleziona un progetto Google Cloud in cui è abilitata l'API Gemini for Google Cloud.

    Ora sei in contatto con Google Cloud. Gemini è pronto per l'uso.

Chattare con Gemini Code Assist

In questa sezione, scopri come aprire il riquadro Gemini Code Assist e chattare con Gemini Code Assist per ottenere una spiegazione del codice.

Per iniziare a chattare con Gemini, segui questi passaggi:

  1. Apri un file sorgente.

  2. Accanto alla barra di ricerca nell'editor di Cloud Shell, fai clic su chat_spark Apri la chat di Gemini Code Assist.

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

    Gemini utilizza il file come contesto per il prompt e risponde con una spiegazione del codice.

    Per concentrarti su un blocco di codice specifico, selezionalo nel file aperto prima di inserire il prompt.

Reimpostare la cronologia chat

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

Se la cronologia della chat non è più pertinente a ciò che stai cercando di ottenere, puoi reimpostarla: nel riquadro Gemini Code Assist, fai clic su delete Reimposta chat.

Generare codice con i 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. Puoi anche selezionare una parte del codice e poi chiedere aiuto a Gemini Code Assist tramite la funzionalità di chat e ricevere e accettare o rifiutare i suggerimenti di codice mentre programmi.

Richiedere a Gemini Code Assist in un file

  1. In un file di origine, su una nuova riga, inserisci il commento Function to create a Cloud Storage bucket, quindi premi Invio (per Windows e Linux) o A capo (per macOS).

  2. Per generare il codice, premi Ctrl+Invio (per Windows e Linux) o Ctrl+Return (per macOS).

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

  3. (Facoltativo) Per accettare il codice generato, premi Tab.

(Facoltativo) Modificare la scorciatoia da tastiera per generare il codice

Se la scorciatoia da tastiera predefinita per generare il codice non funziona come descritto nella sezione precedente, puoi modificarla seguendo questi passaggi:

  1. Nell'editor di Cloud Shell, fai clic su menu Menu, quindi vai a File > Preferenze > Scorciatoie da tastiera.

  2. Nell'elenco delle scorciatoie da tastiera, cerca Cloud Code: genera codice.

  3. Fai clic su Cloud Code: Generate Code e poi su edit Change Keybinding (Modifica assegnazione tasti).

  4. Nella finestra di dialogo visualizzata, inserisci la tua scorciatoia.

  5. Premi Invio (per Windows e Linux) o Return (per macOS).

    Ora puoi utilizzare la scorciatoia da tastiera appena assegnata per generare codice con Gemini.

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

Gemini Code Assist può eseguire attività o rispondere alle tue domande in base al codice che selezioni. Per ottenere un codice generato in base a un prompt con il codice selezionato, segui questi passaggi:

  1. Accanto alla barra di ricerca dell'editor di Cloud Shell, fai clic su chat_spark Apri la chat di Gemini Code Assist.

  2. In un file sorgente, seleziona un blocco di codice.

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

Ricevi suggerimenti in linea durante la codifica

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

  1. In un file sorgente, 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.

  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.

(Facoltativo) Disattiva i suggerimenti in linea

Se preferisci disattivare i suggerimenti in linea in Gemini Code Assist, segui questi passaggi:

  1. Nell'editor di Cloud Shell, seleziona menu Menu, quindi vai a File > Preferenze > Impostazioni.

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

  3. Scorri fino all'elenco Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto (Cloudcode: Gemini Code Assist: Suggerimenti in linea: attiva automatico), poi seleziona Off.

    In questo modo i suggerimenti in linea vengono disattivati. Puoi comunque premere Ctrl+Invio (per Windows e Linux) o Ctrl+Invio (per macOS) per attivare manualmente i suggerimenti in linea.

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

Puoi escludere i file da Gemini Code Assist per il contesto creando un file .aiexclude. Un file .aiexclude segue una sintassi simile a un file .gitignore, con le seguenti differenze:

  • Un file .aiexclude vuoto o inesistente non blocca alcun file nella sua directory e in tutte le sottodirectory.
  • Un file .aiexclude non supporta la negazione, in cui i pattern sono preceduti da un punto esclamativo (!).
  • Un file .aiexclude corrisponde in modo greedy al carattere *. Questa operazione corrisponderà indiscriminatamente a directory e file. Questo file .aiexclude non distingue tra ** o * per quanto riguarda cartelle o file.

Al momento è supportato un solo file .aiexclude. Per configurare il file