Scrivere codice in un blocco note di Colab Enterprise con l'assistenza di Gemini

Scrivere codice in un blocco note di Colab Enterprise con l'assistenza di Gemini

Questo documento descrive come utilizzare Gemini in Colab Enterprise, un prodotto del portafoglio Gemini per Google Cloud, per aiutarti a scrivere codice in un notebook Colab Enterprise.

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

Questo documento è rivolto ad analisti di dati, data scientist e sviluppatori di dati che utilizzano Colab Enterprise. Si presume che tu abbia conoscenza di come scrivere codice in un ambiente di notebook.

Prima di iniziare

1. Assicurati che Gemini in Colab Enterprise sia configurato per il tuo Google Cloud account utente e progetto.
2. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

3. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

4. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

Ruoli obbligatori

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per scrivere codice con l'assistenza di Gemini in un blocco note Colab Enterprise, chiedi all'amministratore di concedere al tuo account utente i seguenti ruoli IAM sul progetto:

• Utente Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Utente di Gemini per Google Cloud (roles/cloudaicompanion.user)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche assegnare al tuo account utente le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Uno o più dei ruoli richiesti includono l'autorizzazione dataform.repositories.list. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Creator di codice (roles/dataform.codeCreator) in un progetto possono elencare i nomi degli asset di codice nel progetto utilizzando l'API Dataform o l'interfaccia a riga di comando (CLI) Dataform. Gli utenti non amministratori che utilizzano BigQuery Studio possono vedere solo le risorse di codice che hanno creato o che sono state condivise con loro.

Configura Gemini in Colab Enterprise

Poiché si tratta di una tecnologia in fase iniziale, i prodotti Gemini for Google Cloud possono generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i Google Cloud prodotti prima di utilizzarli. Per ulteriori informazioni, consulta Gemini per Google Cloud e l'AI responsabile.

Per utilizzare le funzionalità di Gemini:

1. Nella console Google Cloud, vai alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei quaderni

2. Nella barra degli strumenti, fai clic sul pulsante pen_spark Aiutami a programmare e seleziona le funzionalità che vuoi utilizzare.

   
   • La compilazione automatica del codice suggerisce il codice mentre digiti.
   • La generazione di codice genera codice da una descrizione di ciò che vuoi e suggerisce correzioni per gli errori nel codice.

   Se il pulsante pen_spark Aiutami a codificare non è attivo o se non visualizzi un elenco di funzionalità quando fai clic sul pulsante, consulta Configurare Gemini in Colab Enterprise per un progetto.

Utilizzare il completamento del codice

Per utilizzare il completamento del codice in un notebook Colab Enterprise, procedi nel seguente modo:

1. Nella console Google Cloud, vai alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei quaderni

2. Nel menu Regione, seleziona la regione contenente il tuo blocco note.

3. Fai clic sul blocco note che vuoi aprire.

4. Nella barra degli strumenti, fai clic sul pulsante pen_spark Aiutami a codice e seleziona Completamento codice se non è già selezionato.

5. In una cella di codice del notebook, inizia a inserire il codice. Colab Enterprise suggerisce un potenziale modo per completare il codice in testo grigio in corsivo.

   Ad esempio, se inserisci import p, Colab Enterprise potrebbe suggerire un completamento del codice che importa pandas as pd seguito da una riga che legge un file CSV e memorizza i contenuti in un dataframe pandas.
   

6. Per accettare il completamento del codice suggerito, premi Tab.

Utilizzare la generazione di codice

Per generare codice utilizzando Gemini per Google Cloud:

1. Nella console Google Cloud, vai alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei quaderni

2. Nel menu Regione, seleziona la regione contenente il tuo blocco note.

3. Fai clic sul blocco note che vuoi aprire.

4. Nella barra degli strumenti, fai clic sul pulsante pen_spark Aiutami a codice e seleziona Generazione codice se non è già selezionato.

5. In una cella di codice vuota del notebook, fai clic su genera.

6. Nel pen_spark Genera campo, digita una descrizione del codice che vuoi generare, quindi premi Invio.

7. Per chiudere il riquadro Genera, fai clic su Chiudi.

Correggi errori

Preview — Error fixing

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Per utilizzare Gemini Google Cloud per correggere gli errori nel codice:

1. Nella console Google Cloud, vai alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei quaderni

2. Nel menu Regione, seleziona la regione contenente il tuo blocco note.

3. Fai clic sul blocco note che vuoi aprire.

4. Nella barra degli strumenti, fai clic sul pulsante pen_spark Aiutami a codice e seleziona Generazione codice se non è già selezionato.

5. In una cella di codice del notebook, inserisci il codice contenente un errore e poi esegui la cella. Ad esempio, potresti inserire print(1, a cui manca una parentesi di chiusura.

   Dopo l'esecuzione della cella di codice, Colab Enterprise stampa un messaggio di errore sotto la cella di codice. Se Gemini in Colab Enterprise ha un suggerimento che potrebbe correggere il codice, viene visualizzato un pulsante Correggi errore.

6. Fai clic sul pulsante Correggi errore.

   Colab Enterprise mostra una correzione suggerita per il codice.

7. Valuta il suggerimento, quindi svolgi una delle seguenti operazioni:

   • Per accettare il suggerimento, fai clic su  Accetta suggerimento.
   • Per rifiutare il suggerimento, fai clic su  Rifiuta suggerimento.

Disattivare le funzionalità di Gemini

Per disattivare le funzionalità di Gemini in Colab Enterprise:

1. Nella barra degli strumenti di Colab Enterprise, fai clic sul pulsante pen_spark Aiutami a scrivere codice.

2. Deseleziona le funzionalità di Gemini che vuoi disattivare.

Risoluzione dei problemi

Questa sezione mostra come risolvere i problemi relativi all'utilizzo di Gemini in Colab Enterprise.

Funzionalità di Gemini non funzionanti

Quando digiti in un notebook Colab Enterprise, i suggerimenti di completamento del codice non vengono visualizzati. In alternativa, il pulsante pen_spark Aiutami a programmare non viene visualizzato sopra una cella di codice.

Nelle impostazioni di Colab Enterprise, potresti aver disattivato l'impostazione Mostra completamenti di codice basati sul contesto.

Per risolvere il problema:

1. Fai clic su  Attiva/disattiva visibilità intestazione.
2. Nel menu Strumenti, fai clic su Impostazioni.
3. Fai clic su Editor.
4. Seleziona Mostra completamenti di codice basati sul contesto.
5. Fai clic su Salva.

Passaggi successivi

• Leggi la panoramica di Gemini per Google Cloud .

• Scopri in che modo Gemini per Google Cloud utilizza i tuoi dati.