Un tour di Gemini Code Assist Standard ed Enterprise per gli sviluppatori nell'editor di Google Cloud Shell

1. Introduzione

In questo lab utilizzerai Gemini Code Assist, un collaboratore basato sull'AI in Google Cloud. Acquisirai familiarità con l'utilizzo di Gemini Chat e dell'assistenza per il codice incorporato per generare codice, comprenderlo e svolgere altre attività di programmazione assistita dall'AI.

Attività previste

Utilizzerai l'IDE Cloud Shell per scaricare un modello di codice esistente per un'applicazione web.
Utilizzerai Gemini Chat nell'IDE Cloud Shell per porre domande generali su Google Cloud.
Utilizzerai l'assistenza per il codice in linea di Gemini Code Assist nell'IDE di Cloud Shell per generare, riassumere e completare il codice.

Cosa imparerai…

Come utilizzare Gemini Code Assist per diverse attività di sviluppo, come la generazione, il completamento e il riepilogo del codice.
Come utilizzare Cloud Assist per scoprire di più su Google Cloud.

Cosa ti serve…

Browser web Chrome
Un account Gmail
Un progetto cloud con fatturazione abilitata
Gemini Code Assist abilitato per il tuo progetto cloud

Questo lab è rivolto a sviluppatori di tutti i livelli, inclusi i principianti. Sebbene l'applicazione di esempio sia in linguaggio Python, non è necessario avere familiarità con la programmazione in Python per capire cosa sta succedendo. Ci concentreremo sull'acquisizione di familiarità con le funzionalità di Gemini Code Assist per sviluppatori.

2. Configurazione

Questa sezione descrive tutto ciò che devi fare per iniziare questo lab.

Abilitare Cloud Assist nel progetto Google Cloud

Ora attiveremo Cloud Assist nel nostro progetto Google Cloud. Segui i passaggi riportati di seguito:

Visita https://console.cloud.google.com e assicurati di aver selezionato il progetto Google Cloud che intendi utilizzare per questo lab. Fai clic sull'icona Apri Gemini in alto a destra.

La finestra di chat di Cloud Assist si aprirà sul lato destro della console. Fai clic sul pulsante Attiva come mostrato di seguito. Se non vedi il pulsante Abilita e visualizzi invece un'interfaccia di chat, è probabile che tu abbia già attivato Cloud Assist per il progetto e puoi passare direttamente al passaggio successivo.

Una volta attivato, puoi provare Cloud Assist chiedendo uno o due prompt. Vengono mostrate alcune query di esempio, ma puoi provare a eseguire una query come What is Cloud Run?.

Cloud Assist risponderà alla tua domanda. Puoi fare clic sull'icona nell'angolo in alto a destra per chiudere la finestra della chat di Cloud Assist.

Abilitare Gemini Code Assist nell'IDE di Cloud Shell

Per il resto del codelab utilizzeremo Cloud Shell IDE, un ambiente di sviluppo completamente gestito basato su Code OSS. Dobbiamo abilitare e configurare Code Assist nell'IDE di Cloud Shell. I passaggi sono riportati di seguito:

Visita ide.cloud.google.com. Potrebbe essere necessario un po' di tempo prima che l'IDE venga visualizzato, quindi abbi pazienza.
Fai clic sul pulsante Cloud Code - Sign in (Cloud Code - Accedi) nella barra di stato in basso, come mostrato. Autorizza il plug-in come indicato. Se nella barra di stato vedi "Cloud Code - no project", selezionalo e poi scegli il progetto Google Cloud specifico dall'elenco dei progetti con cui prevedi di lavorare.

Fai clic sul pulsante Gemini nell'angolo in basso a destra, come mostrato, e seleziona un'ultima volta il progetto Google Cloud corretto. Se ti viene chiesto di abilitare l'API Gemini for Google Cloud, fallo e vai avanti.
Dopo aver selezionato il progetto Google Cloud, assicurati di visualizzarlo nel messaggio di stato di Cloud Code nella barra di stato e che Code Assist sia attivato a destra, nella barra di stato, come mostrato di seguito:

Gemini Code Assist è pronto per l'uso.

(Facoltativo) Se non vedi Gemini nella barra di stato in basso a destra, devi abilitarlo in Cloud Code. Prima di farlo, assicurati che Gemini sia attivato nell'IDE andando su Estensione Cloud Code → Impostazioni e poi inserisci il testo Gemini come mostrato di seguito. Assicurati che la casella di controllo sia selezionata. Devi ricaricare l'IDE.In questo modo, Gemini viene abilitato in Cloud Code e l'icona di Gemini nella barra di stato viene visualizzata nell'IDE.

3. Crea l'applicazione di esempio

Creeremo un'applicazione di esempio (un'applicazione Python Flask) che utilizzeremo per esplorare le funzionalità di Gemini Code Assist.

Procedi nel seguente modo:

Fai clic sul nome del progetto Google Cloud nella barra di stato in basso.

Verrà visualizzato un elenco di opzioni. Fai clic su Nuova applicazione dall'elenco di seguito.

Seleziona l'applicazione Cloud Run.
Seleziona il modello di applicazione Python (Flask): Cloud Run.
Salva la nuova applicazione nella posizione che preferisci.
Una notifica conferma la creazione della tua applicazione e si apre una nuova finestra con l'applicazione caricata, come mostrato di seguito. Viene aperto un file README.md. Per il momento puoi chiudere questa visualizzazione.

4. Prova Gemini

Inizieremo imparando a usare Gemini. Gemini è disponibile come assistente di chat nell'IDE Cloud Shell nell'ambito dell'estensione Cloud Code in VS Code. Puoi visualizzarlo facendo clic sul pulsante Gemini nella barra di navigazione a sinistra. Cerca l'icona di Gemini nella barra degli strumenti di navigazione a sinistra e fai clic.

Verrà visualizzato il riquadro Chat: Gemini all'interno dell'IDE di Cloud Shell e potrai chattare con Gemini per ricevere assistenza su Google Cloud.

Utilizziamo il riquadro della chat con Gemini per inserire un prompt e visualizzare la risposta di Gemini. Digita il seguente prompt:

What is Cloud Run?

Gemini dovrebbe rispondere con i dettagli su Cloud Run. I prompt sono domande o affermazioni che descrivono l'aiuto di cui hai bisogno. I prompt possono includere il contesto del codice esistente che Google Cloud analizza per fornire risposte più utili o complete. Per saperne di più su come scrivere prompt per generare risposte valide, consulta l'articolo Scrivere prompt migliori per Gemini in Google Cloud.

Prova i seguenti prompt di esempio o altri di tua scelta per porre domande su Google Cloud:

What is the difference between Cloud Run and Cloud Functions?
What services are available on Google Cloud to run containerized workloads?
What are the best practices to optimize costs while working with Google Cloud Storage?

Nota l'icona del cestino in alto: questo è il modo per reimpostare il contesto della cronologia della chat di Code Assist. Tieni presente inoltre che questa interazione via chat è contestuale ai file su cui stai lavorando nell'IDE.

5. Spiegazione del codice

Per aiutarti a incrementare 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'azione da un elenco di azioni pertinenti al tuo contesto.

Puoi utilizzare Gemini Code Assist per comprendere parti del codice dell'applicazione. Torna all'applicazione che abbiamo creato in un passaggio precedente e puoi utilizzare Gemini Code Assist per spiegare i file e il codice disponibili nel tuo IDE.

Se i file non sono visibili, nella barra delle attività dell'IDE fai clic su Explorer ( ).
Nel riquadro Explorer, seleziona Dockerfile.
Puoi selezionare qualsiasi parte dei contenuti del file, fare clic sull'icona a forma di lampadina ( ) e poi su Gemini: spiega. Ad esempio, seleziona la riga che inizia con ENTRYPOINT, fai clic sull'icona a forma di lampadina () e poi su Gemini: Explain this (Gemini: spiega questo). Gemini genera una spiegazione in linguaggio naturale della sezione specifica del Dockerfile su cui hai bisogno di maggiori informazioni. Gemini risponde con i dettagli dell'istruzione ENTRYPOINT. Scopri che, con questa istruzione, Docker eseguirà il file app.py all'avvio del container.
Per visualizzare i contenuti del file app.py, nella barra delle attività fai clic su Explorer ( ), quindi seleziona app.py.
Nella definizione della funzione hello(), seleziona le righe su cui vuoi ricevere maggiori informazioni. Poi fai clic sull'icona della lampadina ( ) e poi su Gemini : spiega questo. Nel nostro esempio, abbiamo selezionato le due righe di codice seguenti e poi abbiamo attivato l'azione Gemini: Explain this.

Gemini risponde con una spiegazione dettagliata di queste due variabili di ambiente Cloud Run (K_SERVICE, K_REVISION) e di come vengono utilizzate nel codice dell'applicazione. Tieni presente che Gemini, grazie alla sua conoscenza di Google Cloud e di servizi come Cloud Run, non solo ha spiegato il codice Python, ma ha anche fornito il contesto del significato di queste variabili in Cloud Run.

Prova i seguenti modi aggiuntivi per ottenere una spiegazione del codice:

Mantieni app.py come file attualmente aperto nell'IDE. Vai al riquadro della chat di Gemini nella barra di navigazione a sinistra di VS Code e inserisci il prompt Spiega questo file. Verrà preso in considerazione l'intero file e ti verrà spiegato.
Puoi anche selezionare una parte del file e poi utilizzare il riquadro della chat Gemini a sinistra, inserire il prompt Spiega questo. Verrà spiegata solo la parte selezionata del file. È come se facessi clic sull'icona a forma di lampadina( ) e poi su Gemini: spiega questo.
Puoi anche selezionare una parte del testo e fare clic su Gemini: azioni intelligenti in alto a destra nell'IDE, come mostrato di seguito, per visualizzare un elenco di azioni che possono essere eseguite sul testo selezionato. Una di queste opzioni sarà l'azione Spiega questo:

6. Generare codice con i prompt

Questa sezione mostra come utilizzare Gemini Code Assist per generare codice dai commenti.

Proviamo queste funzionalità. Segui i passaggi riportati di seguito:

Crea un nuovo file denominato utils.py.
Nel nuovo file di codice, su una nuova riga, inserisci # Function to print a list of blobs in a Google Cloud Storage bucket, quindi premi Enter (per Windows e Linux) o Return (per macOS). Gemini potrebbe provare a generare codice mentre digiti, ma non accettarlo. Attiveremo specificamente la generazione di codice nel passaggio successivo.
Per attivare la generazione del codice, premi Control+Enter (per Windows e Linux) o Control+Return (per macOS). Accanto al testo del prompt nel file Python, Gemini Code Assist genera il codice sotto forma di testo fantasma. Ti fornirà uno o più suggerimenti per il codice con una barra degli strumenti, tramite la quale potrai passare da un suggerimento di codice all'altro (nel caso in cui ci siano più suggerimenti). Puoi anche accettare uno qualsiasi dei suggerimenti di codice tramite la barra degli strumenti. Se non riesci a visualizzare la barra degli strumenti o se scompare, passa il mouse sopra il codice generato per visualizzarla di nuovo.
(Facoltativo) Per accettare il codice generato, premi Tab. Se ci sono più suggerimenti, puoi premere Tab più volte per passare da un suggerimento di snippet di codice a quello successivo.

In questo modo, il codice che hai accettato verrà inserito nel file utils.py. Di seguito è riportato uno screenshot di esempio. Il codice che ti viene fornito potrebbe essere diverso da quello mostrato di seguito. Se vengono generati metodi aggiuntivi, puoi eliminarli dopo aver accettato il codice.

Potresti notare o meno delle linee a zigzag nel codice. In questo caso, si tratta di citazione del codice in azione. Se passi il mouse sopra una delle linee, vengono visualizzate l'attribuzione del codice e altre informazioni pertinenti sulle licenze. Un esempio è il seguente:

Puoi quindi scegliere di ignorare l'avviso relativo alla citazione facendo clic su Correzione rapida…. Verrà visualizzata la correzione rapida suggerita, di cui è mostrato un esempio di seguito:

Puoi scegliere Ignora avviso di citazione se accetti la licenza del codice.

(Facoltativo) Ecco alcuni altri suggerimenti da provare per la generazione di codice:

Puoi anche utilizzare la funzionalità di chat di Gemini per porre lo stesso prompt e ricevere la risposta nella finestra della chat. L'interfaccia di Chat mostra quindi le opzioni per copiare il codice o inserirlo nel file corrente.
Prova i tuoi prompt per ottenere il codice di esempio che preferisci. Di seguito sono riportati alcuni suggerimenti (supponendo che tu ti trovi in uno dei file Python) o scegli tra alcuni dei prompt riportati di seguito:

Scrivi codice Python per pubblicare un messaggio in Google Cloud Pub/Sub
Scrivi codice Python per inizializzare un client BigQuery
Scrivi codice Python per connettere la mia applicazione a Cloud SQL

7. Ricevere suggerimenti di codice 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à, modificheremo il file utils.py che abbiamo creato nella sezione precedente :

Apri il file utils.py come file corrente nell'IDE Cloud Shell.
Una delle cose che possiamo fare è fornire le istruzioni import corrette, se non sono presenti nel codice generato.
Inizia a digitare la parola import e dovresti vedere Gemini Code Assist che suggerisce il codice sotto forma di testo fantasma. 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. Nella schermata di esempio riportata di seguito, viene suggerita l'importazione della classe storage poiché viene utilizzata nel codice. Premi Tab per accettare il suggerimento di codice. È anche suggerita la dichiarazione import os, ma poiché non è necessaria, possiamo rimuoverla.

Vai alla fine del file utils.py e aggiungi la riga per richiamare la funzione, se non è fornita. In questo caso, si tratta della funzione print_blobs. Puoi iniziare a digitare il nome della funzione e il completamento del codice ti aiuterà a completare l'istruzione.
Dovrai fornire il nome del bucket e potrai utilizzare il seguente nome di bucket pubblico : gemini-codeassist-bucket.Di seguito è riportato l'esempio di chiamata per la funzione. Tieni presente che potresti notare piccole differenze in termini di nomi delle funzioni e così via.

print_blobs(bucket_name="gemini-codeassist-bucket")

(Facoltativo) Esegui il codice campione

Poiché abbiamo scritto il codice per elencare i blob in un bucket Google Cloud Storage, dovremo installare la libreria Python google-cloud-storage.

Vai al file requirements.txt e aggiungi una nuova riga con la dipendenza google-cloud-storage come mostrato di seguito. Di seguito è riportato un file requirements.txt di esempio.

Flask==2.3.3
requests==2.31.0
debugpy # Required for debugging.
google-cloud-storage

Salva il file requirements.txt.

Per vedere il codice in azione, dobbiamo avviare una nuova sessione del terminale dall'IDE Cloud Shell tramite l'icona del menu in alto a sinistra. Fai clic sull'icona del menu e poi su Terminale → Nuovo terminale come mostrato di seguito:

Nella sessione del terminale, installa le dipendenze Python tramite il seguente comando:

pip3 install -r requirements.txt

Infine, puoi eseguire il file utils.py tramite il seguente comando:

python utils.py

Dovrebbero essere visualizzati i blob presenti nel bucket Google Cloud Storage pubblico. Idealmente, dovresti vedere due blob elencati nell'output (file1.txt e file2.txt).

Risoluzione dei problemi

Se ricevi un errore di "accesso" durante la visualizzazione degli oggetti nel bucket pubblico sopra indicato, puoi scegliere di creare il tuo bucket Google Cloud Storage e utilizzarlo al posto di gemini-codeassist-bucket. La sezione successiva mostra come farlo.

(Facoltativo) Crea il tuo bucket Cloud Storage

Chiediamo a Gemini di fornirci i comandi per creare un bucket, renderlo accessibile pubblicamente e caricare oggetti di esempio nel bucket.

Inizia con il seguente prompt: "Qual è il comando gcloud per creare un bucket pubblico in Google Cloud Storage?"

Dovresti visualizzare un comando gcloud per creare un bucket. Il comando esatto è mostrato di seguito:

gcloud storage buckets create gs://<BUCKET_NAME>

Seleziona un nome univoco per <BUCKET_NAME> ed esegui il comando nel terminale.

Ora che abbiamo creato un bucket, vogliamo che sia accessibile pubblicamente. Chiediamo a Gemini il comando per farlo utilizzando il seguente prompt: "Come faccio a rendere accessibile pubblicamente un bucket Google Cloud Storage?"

In questo modo, dovresti ottenere un comando gcloud per renderlo accessibile pubblicamente. La risposta dovrebbe essere simile alla seguente:

gcloud storage buckets add-iam-policy-binding gs://<BUCKET_NAME> --member=allUsers --role=roles/storage.objectViewer

Sostituisci <BUCKET_NAME> con il nome del bucket che hai utilizzato in precedenza ed esegui il comando.

Infine, vorremmo caricare alcuni file di esempio nel bucket. Esegui i seguenti comandi nel terminale (ricorda di sostituire la variabile <BUCKET_NAME> con il nome del tuo bucket.

touch f1.txt
touch f2.txt

gcloud storage cp f1.txt gs://<BUCKET_NAME>
gcloud storage cp f2.txt gs://<BUCKET_NAME>

Ora puoi eseguire il file utils.py utilizzando <BUCKET_NAME> anziché gemini-codeassist-bucket.

Esegui la pulizia

Se hai creato il tuo bucket Google Cloud Storage, ti consigliamo vivamente di eliminarlo per evitare addebiti e potenziali rischi per la sicurezza.

Puoi eliminare il bucket con il comando riportato di seguito:

gcloud storage buckets delete gs://<BUCKET_NAME>

8. Complimenti!

Congratulazioni. Hai utilizzato correttamente Gemini Code Assist in un progetto di esempio per capire come può aiutarti con la generazione, il completamento e il riepilogo del codice, nonché a trovare risposte alle domande su Google Cloud.