Utilizzare il completamento e la generazione del codice

Utilizzare il completamento e la generazione del codice

Questo documento descrive come puoi utilizzare Gemini in Colab Enterprise, un prodotto del portfolio Google CloudGemini per, per scrivere e generare codice in un notebook Colab Enterprise.

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

Questo documento è rivolto ad analisti di dati, data scientist e sviluppatori di dati che lavorano con Colab Enterprise. Si presuppone che tu sappia come scrivere codice in un ambiente notebook.

Limitazioni

La funzionalità Trasforma codice di Colab non è supportata in Colab Enterprise. Per scoprire altri modi per utilizzare le funzionalità basate sull' AI per modificare il codice in Colab Enterprise, consulta Utilizzare Data Science Agent.

Prima di iniziare

Poiché si tratta di una tecnologia in fase iniziale, Gemini per Google Cloud i prodotti può generare risultati apparentemente plausibili, ma di fatto errati. Ti consigliamo di convalidare tutti gli output di Gemini per i Google Cloud prodotti prima di utilizzarli. Per saperne di più, consulta Gemini per Google Cloud e l'AI responsabile.

1. Assicurati che Gemini in Colab Enterprise sia configurato per il tuo Google Cloud account utente e il tuo progetto.
Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

Enable the Vertex AI, Gemini for Google Cloud, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Enable the Vertex AI, Gemini for Google Cloud, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare Gemini in Colab Enterprise, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

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

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

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

Abilitare il completamento e la generazione del codice

Per abilitare il completamento e la generazione del codice:

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

   Vai a I miei notebook

2. Nella barra degli strumenti, fai clic sul  Help me code pulsante e seleziona le funzionalità che vuoi utilizzare.

   
   • Completamento del codice suggerisce il codice durante la digitazione.
   • Generazione del codice genera codice da una descrizione di ciò che vuoi.

   Se il pulsante  Aiutami a scrivere codice non è attivo o se non vedi 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:

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

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire.

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

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

   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 del codice

Per generare codice utilizzando Gemini per Google Cloud:

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

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire.

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

5. Nel notebook, aggiungi una cella di codice vuota o fai clic su una cella di codice che non contiene codice.

6. Fai clic su  Funzionalità AI disponibili, quindi su Genera codice.

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

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

Disattivare il completamento e la generazione del codice

Per disattivare il completamento e la generazione del codice:

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

2. Deseleziona le funzionalità che vuoi disattivare.

Risoluzione dei problemi

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

Le funzionalità di Gemini non funzionano

Quando digiti in un notebook Colab Enterprise, non vengono visualizzati suggerimenti di completamento del codice. 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 basito sul contesto.

Per risolvere il problema:

1. Fai clic su  Attiva/disattiva visualizzazione 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.

• Per altri modi per scrivere e modificare il codice con l'assistenza di Gemini, consulta:

  • Chattare con Gemini sul notebook
  • Spiegare le celle di codice
  • Spiegare e correggere gli errori
  • Utilizzare Data Science Agent

• Scopri come Gemini per Google Cloud utilizza i tuoi dati.