Configura Gemini Code Assist per un progetto

Nota: puoi provare Gemini Code Assist senza costi fino all'11 luglio 2024, con un limite di un utente per account di fatturazione. Le organizzazioni possono acquistare una licenza qui.

Prima di poter utilizzare Gemini Code Assist, il tuo team deve eseguire i passaggi di configurazione descritti in questo documento:

1. (Facoltativo) Acquista un abbonamento a Gemini Code Assist. Puoi provare Gemini Code Assist senza costi fino all'11 luglio 2024, con un limite di un utente per account di fatturazione.

2. Attiva Gemini Code Assist in un progetto Google Cloud. In genere questo passaggio viene eseguito da un amministratore.

3. (Facoltativo) Per utilizzare Gemini Code Assist in un IDE, installa il plug-in Cloud Code.

(Facoltativo) Acquista un abbonamento a Gemini Code Assist

Puoi provare Gemini Code Assist senza abbonamento senza costi fino all'11 luglio 2024, con un limite di un utente per account di fatturazione. Le organizzazioni con più utenti per account di fatturazione devono acquistare un abbonamento come descritto in questa sezione. Se hai già contratti con Google Cloud, contatta il nostro team di vendita prima di acquistare un abbonamento.

Nota: per acquistare un abbonamento a Gemini, devi disporre dell'autorizzazione billing.subscriptions.create Identity and Access Management (IAM). L'autorizzazione billing.subscriptions.create è inclusa nel ruolo IAM roles/billing.admin oppure puoi aggiungere l'autorizzazione a un ruolo personalizzato.

1. Nella console Google Cloud, vai alla pagina Gemini per Google Cloud.

   Vai a Gemini per Google Cloud

2. Fai clic su Inizia a utilizzare Gemini.

3. Se richiesto, seleziona un account di fatturazione e fai clic su Vai alla pagina Amministrazione di Gemini.

4. In Configura abbonamento, completa i campi per configurare l'abbonamento, tra cui la durata dell'impegno (mensile o annuale) e il numero di licenze nell'abbonamento.

   Nota: un abbonamento annuale addebita ogni mese il prezzo annuale scontato anziché un pagamento una tantum.

   Scegli se vuoi rinnovare automaticamente l'abbonamento una volta trascorso il periodo dell'impegno (mensile o annuale). Il rinnovo automatico mantiene attivi l'abbonamento e le licenze. Se l'abbonamento non si rinnova automaticamente, scade allo scadere del periodo corrente e dovrai ripetere la procedura di acquisto per riacquisire le licenze.

5. Per esaminare i dettagli dell'abbonamento, fai clic su Continua.

6. Se accetti i termini, fai clic su Completa l'acquisto e conferma l'abbonamento.

Ora la fatturazione è abilitata per Gemini. Ora devi attivare Gemini Code Assist in uno o più progetti associati a questo account di fatturazione. Gli utenti non vedranno Gemini finché non li attivi in almeno un progetto.

Attivare Gemini Code Assist in un progetto Google Cloud

Per attivare Gemini Code Assist in un progetto Google Cloud, un amministratore deve abilitare l'API Cloud AI Companion e concedere agli utenti i ruoli IAM Utente e Visualizzatore utilizzo di servizi Cloud AI Companion.

Console

1. Per abilitare l'API Cloud AI Companion, vai alla pagina Gemini per Google Cloud.

   Vai a Gemini per Google Cloud

2. Nel selettore dei progetti, seleziona un progetto.

3. Fai clic su Abilita.

   La pagina viene aggiornata e mostra lo stato Attivata. Gemini è ora disponibile nel progetto Google Cloud selezionato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

4. Per concedere i ruoli IAM necessari per utilizzare Gemini, vai alla pagina IAM e amministrazione.

   Vai a IAM e amministrazione

5. Nella colonna Entità, trova un'entità per la quale vuoi abilitare l'accesso a Gemini, poi fai clic su Modifica entità in quella riga.

6. Nel riquadro Modifica accesso, fai clic su Aggiungi un altro ruolo.

7. In Seleziona un ruolo, scegli Utente Cloud AI Companion.

8. Fai clic su Aggiungi un altro ruolo e seleziona Visualizzatore Service Usage.

9. Fai clic su Salva.

gcloud

1. Nella console Google Cloud, attiva Cloud Shell.

   Attiva Cloud Shell

2. Nell'elenco a discesa del selettore dei progetti, seleziona un progetto.

3. Abilita l'API Cloud AI Companion per Gemini utilizzando il comando gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Se vuoi abilitare l'API Cloud AI Companion per un altro progetto Google Cloud, aggiungi il parametro --project:

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   Sostituisci PROJECT_ID con l'ID progetto Google Cloud.

   L'output è simile al seguente:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

   Gemini è ora disponibile nel progetto Google Cloud specificato per tutti gli utenti con i ruoli IAM richiesti.

4. Concedi i due ruoli IAM richiesti per utilizzare Gemini:

   1. Concedi il ruolo Utente Cloud AI Companion:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
          --member=PRINCIPAL --role=roles/cloudaicompanion.user
      

      Sostituisci PRINCIPAL con l'identificatore dell'entità. L'identificatore ha il formato user|group|serviceAccount:email o domain:domain, ad esempio user:[e-mail], group:[e-mail], serviceAccount:[e-mail] o domain:example.domain.com.

      L'output è un elenco di associazioni di criteri che include quanto segue:

      - members:
        - user:PRINCIPAL
        role: roles/cloudaicompanion.user
      

   2. Concedi il ruolo Visualizzatore utilizzo dei servizi:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
          --member=PRINCIPAL --role=roles/serviceusage.serviceUsageViewer
      

      L'output è un elenco di associazioni di criteri che include quanto segue:

      - members:
        - user:PRINCIPAL
        role: roles/serviceusage.serviceUsageViewer
      

   Per saperne di più, vedi Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere alle funzionalità Gemini nella console Google Cloud all'interno del progetto specificato. Per saperne di più, consulta Utilizzare Gemini per AI'assistenza e lo sviluppo dell'IA.

(Facoltativo) Utilizzare Gemini Code Assist in un IDE

Se sei uno sviluppatore e vuoi utilizzare Gemini nel tuo IDE, devi installare il plug-in Cloud Code. Per ulteriori informazioni, consulta quanto segue:

• Cloud Workstations: codice con Gemini Code Assist
• Editor di Cloud Shell: Codice con Gemini Code Assist
• Cloud Code for VS Code: Code with Gemini Code Assist
• Cloud Code per IntelliJ e altri IDE JetBrains: codice con Gemini Code Assist

Attività di configurazione avanzate

Anziché utilizzare la console Google Cloud o gcloud CLI per concedere i ruoli IAM predefiniti, puoi eseguire una delle seguenti operazioni:

• Utilizza le API REST IAM o le librerie client IAM per concedere i ruoli.

  Se utilizzi queste interfacce, utilizza i nomi completi dei ruoli:

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageViewer

  Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

• Creare e concedere ruoli personalizzati.

  Tutti i ruoli personalizzati che crei devono disporre delle seguenti autorizzazioni per accedere a Gemini:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • serviceusage.services.get

Passaggi successivi

• Scopri di più sui tipi di assistenza dell'AI generativa disponibili in Gemini per Google Cloud.
• Scopri in che modo Gemini per Google Cloud utilizza i tuoi dati.
• Scopri come accedere ai controlli di amministrazione di Gemini e gestirli.