Configurare Gemini Code Assist Standard ed Enterprise

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

Nota: in genere un amministratore esegue i passaggi da 1 a 4.

1. Acquista un abbonamento a Gemini Code Assist Standard o Enterprise.

2. Assegna licenze agli utenti della tua organizzazione.

3. Abilita l'API Gemini for Google Cloud in un progetto Google Cloud.

4. Concedere ruoli Identity and Access Management in un progetto Google Cloud.

5. Gli utenti della tua organizzazione installano il plug-in Gemini Code Assist per utilizzare Gemini Code Assist Standard o Enterprise in un IDE. Questo passaggio non è obbligatorio per gli utenti dell'interfaccia a riga di comando di Gemini o di Gemini in Android Studio.

Acquistare un abbonamento a Gemini Code Assist

Per un elenco delle funzionalità disponibili in ogni versione, consulta Funzionalità supportate.

Per i nuovi clienti di Gemini Code Assist con account di fatturazione che non hanno mai avuto un abbonamento a Gemini Code Assist, applichiamo automaticamente crediti equivalenti a un massimo di 50 licenze senza costi per il primo mese, indipendentemente dalla versione di Gemini Code Assist. Tieni presente che non puoi aumentare il numero di crediti senza costi dopo l'assegnazione dei crediti senza costi iniziali per la licenza. Inoltre, non puoi modificare l'edizione di Gemini in Code Assist entro il primo mese.

Se hai contratti esistenti 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 di gestione di Identity and Access Management consumerprocurement.orders.place sull'account di fatturazione. L'autorizzazione consumerprocurement.orders.place è inclusa nel ruolo IAM roles/billing.admin o nel ruolo roles/consumerprocurement.orderAdmin. In alternativa, puoi aggiungere l'autorizzazione a un ruolo personalizzato.

1. Vai alla pagina Amministrazione di Gemini.

   Vai ad Amministrazione per Gemini

   Si apre la pagina Amministratore per Gemini.

2. Seleziona Ottieni Gemini Code Assist.

   Tieni presente che se non disponi dell'consumerprocurement.orders.place autorizzazione richiesta, questo pulsante è disattivato. Se esiste già un abbonamento a Gemini Code Assist per l'account di fatturazione associato al progetto, questo pulsante viene visualizzato come Gestisci Gemini Code Assist e ti consente di modificare l'abbonamento.

   Si apre la pagina Acquista l'abbonamento a Gemini Code Assist.

3. In Seleziona la versione dell'abbonamento a Gemini Code Assist, seleziona una versione di Gemini Code Assist. Seleziona Confronta le versioni di Gemini Code Assist per visualizzare un elenco dettagliato delle funzionalità disponibili per ogni versione.

   poi seleziona Continua.

4. In Configura abbonamento, completa i campi per configurare l'abbonamento, tra cui:

   • Nome dell'abbonamento.
   • Numero di licenze nell'abbonamento. Tieni presente che se acquisti la versione Enterprise, devi acquistare almeno 10 licenze.
   • Periodo di abbonamento (mensile o annuale). Con un abbonamento annuale, ti viene assegnata una tariffa scontata che viene addebitata mensilmente anziché con un pagamento una tantum.

   Per impostazione predefinita, i nuovi abbonamenti sono configurati per l'assegnazione automatica delle licenze. A un utente della tua organizzazione viene assegnata automaticamente una licenza quando utilizza Gemini Code Assist all'interno di un IDE supportato, a condizione che siano soddisfatte tutte le seguenti condizioni:

   • L'utente ha selezionato un progetto associato all'account di fatturazione dell'abbonamento.
   • L'utente dispone dell'autorizzazione IAM cloudaicompanion.licences.selfAssign sul progetto selezionato.

   Dopo aver configurato Gemini Code Assist, puoi scegliere di assegnare le licenze manualmente.

5. Per confermare l'abbonamento, seleziona Continua.

6. Se accetti i termini, seleziona Accetto i termini di questo acquisto e poi Conferma abbonamento.

7. Seleziona Avanti: gestisci le assegnazioni delle licenze Gemini.

L'abbonamento è stato acquistato per Gemini Code Assist Standard o Enterprise. Ora devi gestire le assegnazioni delle licenze Gemini nella tua organizzazione.

Assegnare le licenze

Prima di utilizzare una licenza Gemini Code Assist, gli utenti devono disporre del ruolo Utente di Gemini in Google Cloud o di autorizzazioni analoghe in un progetto in cui l'API è già abilitata.

Per i nuovi clienti di Gemini Code Assist con account di fatturazione che non hanno mai avuto un abbonamento a Gemini Code Assist, applichiamo automaticamente crediti equivalenti a un massimo di 50 licenze senza costi per il primo mese, indipendentemente dalla versione di Gemini Code Assist. Tieni presente che non puoi aumentare il numero di crediti senza costi dopo l'assegnazione dei crediti senza costi iniziali per la licenza. Inoltre, non puoi modificare l'edizione di Gemini in Code Assist entro il primo mese.

Per impostazione predefinita, i nuovi abbonamenti sono configurati per l'assegnazione automatica delle licenze. A un utente della tua organizzazione viene assegnata automaticamente una licenza quando utilizza Gemini Code Assist all'interno di un IDE supportato, a condizione che siano soddisfatte tutte le seguenti condizioni:

• L'utente ha selezionato un progetto associato all'account di fatturazione dell'abbonamento.
• L'utente dispone dell'autorizzazione IAM cloudaicompanion.licences.selfAssign sul progetto selezionato.

Se una licenza è inattiva per 30 giorni, verrà assegnata automaticamente a un altro utente della tua organizzazione che soddisfa le condizioni precedenti.

Dopo aver configurato Gemini Code Assist, puoi visualizzare le assegnazioni delle licenze accedendo alla pagina Amministrazione per Gemini, selezionando il tuo account di fatturazione, facendo clic su Gestisci abbonamento a Gemini Code Assist e poi selezionando la scheda Gestione licenze. Se hai bisogno di un controllo più preciso sulle assegnazioni delle licenze, puoi utilizzare questa scheda anche per passare dalla gestione automatica delle licenze alla gestione manuale delle licenze.

L'API Gemini for Google Cloud deve essere abilitata in uno o più progetti associati a questo account di fatturazione. Gli utenti non vedranno Gemini Code Assist finché non lo attivi in almeno un progetto.

Abilita l'API Gemini for Google Cloud in un progetto Cloud

Questa sezione descrive i passaggi necessari per abilitare l'API Gemini for Google Cloud in un progetto Cloud. Gemini Code Assist richiede un progetto Cloud per gestire l'accesso API, la quota e la fatturazione. Per questo motivo, devi abilitare l'API Gemini for Google Cloud in un progetto Cloud a tua scelta prima che gli utenti possano accedere a Gemini Code Assist.

Console

1. Per abilitare l'API Gemini for Google Cloud, vai alla pagina Gemini for Google Cloud.

   Vai a Gemini in Google Cloud

2. Nel selettore dei progetti, seleziona un progetto.

3. Fai clic su Abilita.

   La pagina si aggiorna e mostra lo stato Attivato. Gemini è ora disponibile nel progetto Cloud selezionato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

gcloud

Per utilizzare un ambiente di sviluppo locale, installa e inizializza gcloud CLI.

1. Nel menu del selettore dei progetti, seleziona un progetto.

2. Abilita l'API Gemini for Google Cloud per Gemini utilizzando il comando gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Se vuoi abilitare l'API Gemini for Google Cloud in un altro progetto Cloud, aggiungi il parametro --project:

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

   Sostituisci PROJECT_ID con l'ID del tuo progetto Cloud.

   L'output è simile al seguente:

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

Gemini in Google Cloud è ora disponibile nel progetto Cloud specificato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

Configura il firewall per il traffico API tra l'IDE e Google

Oltre ad abilitare Gemini for Google Cloud, gli utenti dietro i firewall devono anche consentire il passaggio del traffico per le seguenti API:

• oauth2.googleapis.com: utilizzato per accedere a Google Cloud.
• serviceusage.googleapis.com: utilizzato per verificare che il progetto Gemini Code Assist dell'utente sia configurato correttamente.
• cloudaicompanion.googleapis.com: l'endpoint API Gemini for Google Cloud principale.
• cloudcode-pa.googleapis.com: un'API interna che fornisce funzionalità correlate all'IDE.
• cloudresourcemanager.googleapis.com: utilizzato negli IDE per i selettori di progetti. L'API Resource Manager potrebbe non essere necessaria se i progetti sono configurati esplicitamente nel file settings.json.
• people.googleapis.com: fornisce l'accesso alle informazioni su profili e contatti.
• firebaselogging-pa.googleapis.com: un'API interna utilizzata per l'invio di dati di telemetria dei prodotti, inclusi gli eventi relativi all'accettazione dei suggerimenti.
• feedback-pa.googleapis.com: un'API interna utilizzata per l'invio di feedback nell'IDE.
• apihub.googleapis.com: utilizzato dalla funzionalità Browser API di Cloud Code.
• lh3.googleusercontent.com e lh5.googleusercontent.com: utilizzati per ottenere le foto degli utenti.

Determinare gli indirizzi IP per i domini predefiniti di Google Cloud

Per abilitare la connettività dall'IDE alle API Google Cloud, il firewall deve consentire il traffico TCP in uscita agli intervalli di indirizzi IP documentati pubblicamente di Google. Questi intervalli sono gestiti dinamicamente da Google.

Per mantenere un elenco di intervalli IP per accedere ai domini Google Cloud, hai diverse opzioni:

• Utilizza i nostri elenchi pubblicati o automatizza uno script per ottenere gli intervalli degli indirizzi IP di Google.
• Utilizza l'IP virtuale private.googleapis.com.
• Utilizza Private Service Connect.

(Facoltativo) Configura i Controlli di servizio VPC

Se la tua organizzazione ha un perimetro di servizio, devi aggiungere le seguenti risorse al perimetro:

• API Gemini for Google Cloud
• API Gemini Code Assist

Se utilizzi Gemini Code Assist Standard o Enterprise al di fuori del perimetro di servizio, devi anche modificare il criterio di ingresso per consentire l'accesso a questi servizi.

Per saperne di più, consulta Configura i Controlli di servizio VPC per Gemini.

Concedi ruoli IAM in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per concedere agli utenti i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer.

Console

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

   Vai a IAM e amministrazione

2. Fai clic su Concedi accesso e poi inserisci il nome del principal a cui vuoi concedere l'accesso a Gemini.

3. Nel riquadro Concedi accesso, fai clic su Aggiungi un altro ruolo.

4. In Assegna i ruoli, seleziona Gemini for Google Cloud User.

5. Fai clic su Aggiungi ruoli e seleziona Consumer utilizzo servizi.

6. Fai clic su Salva.

gcloud

Per utilizzare un ambiente di sviluppo locale, installa e inizializza gcloud CLI.

1. Nel menu del selettore dei progetti, seleziona un progetto.

2. Concedi il ruolo Gemini for Google Cloud User:

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Cloud,ad esempio1234567890.
   • PRINCIPAL: l'identificatore del principal, ad esempio user:[e-mail].

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

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

3. Ripeti il passaggio precedente per il ruolo roles/serviceusage.serviceUsageConsumer.

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

Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere alle funzionalità di Gemini in Google Cloud nella console Google Cloud all'interno del progetto specificato. Per saperne di più, consulta la panoramica di Gemini in Google Cloud.

Installa il plug-in Gemini Code Assist

Gli utenti della tua organizzazione installano il plug-in Gemini Code Assist nel loro IDE supportato preferito. Gli utenti degli IDE JetBrains supportati devono seguire le istruzioni di IntelliJ.

VS Code

1. Per aprire la visualizzazione Estensioni in VS Code, fai clic su Estensioni o premi Ctrl/Cmd+Shift+X.

2. Cerca Gemini Code Assist.

3. Fai clic su Installa.

4. Se richiesto, riavvia VS Code.

   Una volta installata l'estensione, Gemini Code Assist viene visualizzato nella barra delle attività ed è pronto per l'uso. Puoi configurare ulteriormente l'installazione di Gemini Code Assist specificando le tue preferenze utilizzando la barra delle applicazioni di primo livello: vai a Code > Settings > Settings > Extensions e cerca Gemini Code Assist.

IntelliJ

1. Fai clic su settings IDE e impostazioni progetto > Plug-in.
2. Nella scheda Marketplace, cerca Gemini Code Assist.
3. Fai clic su Installa per installare il plug-in.
4. Al termine dell'installazione, fai clic su Riavvia IDE.

5. Al riavvio dell'IDE, Gemini Code Assist viene visualizzato nella barra delle attività.

   

Ora gli utenti sono pronti per utilizzare Gemini Code Assist Standard o Enterprise nel loro IDE. Scopri di più sulle funzionalità supportate:

• Panoramica delle funzionalità di Code
• Panoramica delle funzionalità di chat

Inizia con le seguenti guide:

• Scrivere codice con Gemini Code Assist
• Chattare con Gemini Code Assist

Elenco delle directory in cui Gemini Code Assist memorizza nella cache le informazioni

La tabella seguente fornisce un elenco di directory in cui Gemini Code Assist archivia le informazioni sulle estensioni, ad esempio i token di autenticazione:

Windows

• %LOCALAPPDATA%/cloud-code
• %LOCALAPPDATA%/google-vscode-extension

macOS

• ~/Library/Application Support/cloud-code
• ~/Library/Application Support/google-vscode-extension

Linux

• ~/.cache/cloud-code
• ~/.cache/google-vscode-extension

Accedi a Google e seleziona un progetto Google Cloud

Una volta installato Gemini Code Assist negli IDE, gli utenti devono accedere ai propri Account Google e, se è la prima volta che utilizzano Gemini Code Assist Standard o Enterprise nel proprio IDE, devono selezionare un progetto Google Cloud. Si tratta dello stesso progetto utilizzato per configurare Gemini Code Assist e viene utilizzato per gestire l'accesso all'API, la quota e la fatturazione.

VS Code

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ù, vedi Configura Gemini Code Assist Standard ed Enterprise per un progetto.

Se preferisci seguire la procedura dettagliata Scrivi codice con Gemini Code Assist direttamente nel tuo IDE, fai clic su Avvia VS Code e segui i passaggi della procedura dettagliata per connetterti a Google Cloud e attivare Gemini Code Assist Standard o Enterprise.

Avvia VS Code

In caso contrario, segui questi passaggi:

1. Avvia il tuo IDE.

2. Nella barra delle attività, fai clic su Gemini Code Assist.

3. Nel riquadro della chat Gemini Code Assist, fai clic su Accedi a Google Cloud.

4. Quando ti viene chiesto di consentire a Gemini Code Assist di aprire il sito web esterno, fai clic su Apri.

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

6. Quando ti viene chiesto se hai scaricato Gemini Code Assist da Google, fai clic su Accedi.

   Nota: se i tentativi di accesso continuano a scadere, consulta il problema noto I tentativi di accesso continuano a scadere per ulteriori informazioni sulla risoluzione dei problemi.

   Ora sei connesso a Google Cloud.

   Successivamente, per selezionare un progetto Google Cloud con l'API Gemini in Google Cloud abilitata, segui questi passaggi:

7. Nella barra di stato Gemini Code Assist, fai clic su Gemini Code Assist.

   

8. Nel menu Gemini Code Assist, seleziona Seleziona progetto Gemini Code.

9. Seleziona un progetto Google Cloud in cui è abilitata l'API Gemini in Google Cloud.

   Gemini Code Assist Standard o Enterprise è pronto per l'uso.

   

IntelliJ

Per accedere al tuo Account Google, segui questi passaggi:

1. Nella barra delle attività, fai clic su spark Gemini Code Assist.

2. Fai clic su Accedi a Google. In alternativa, puoi fare clic su Copia link e incollare l'URL nel browser.

3. Nella pagina che si apre nel browser web, seleziona il tuo Account Google.

4. Nella schermata che ti chiede di assicurarti di aver scaricato questa app da Google, fai clic su Accedi.

   Gemini Code Assist è ora autorizzato ad accedere al tuo account.

   Successivamente, se è la prima volta che utilizzi Gemini Code Assist Standard o Enterprise nel tuo IDE, devi selezionare un progetto Google Cloud seguendo questi passaggi:

5. Torna all'IDE. Nella finestra dello strumento Gemini Code Assist, se accetti che Google abiliti le API necessarie per utilizzare Gemini Code Assist per tuo conto per il progetto selezionato, fai clic su Seleziona un progetto Google Cloud per continuare.

6. Nella finestra di dialogo Seleziona progetto Google Cloud, cerca e seleziona il tuo progetto Google Cloud, quindi fai clic su Ok.

7. Fai clic su FINE.

Il tuo progetto Google Cloud è selezionato con l'API Gemini Code Assist abilitata. Ora puoi utilizzare Gemini Code Assist Standard o Enterprise nel tuo IDE.

Attività di configurazione avanzata

Le sezioni seguenti descrivono le attività di configurazione avanzate che puoi eseguire per personalizzare Gemini Code Assist.

Considerazioni avanzate su IAM

Anziché utilizzare la console Google Cloud o gcloud per concedere 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 dei ruoli completi:

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

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

• Crea e concedi ruoli personalizzati.

  Tutti i ruoli personalizzati che crei devono disporre delle seguenti autorizzazioni per accedere a Gemini Code Assist Standard ed Enterprise:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • serviceusage.services.enable

• Assegnare e gestire le licenze.

  Tutti i ruoli personalizzati che crei devono disporre delle seguenti autorizzazioni per consentirti di assegnare e gestire le licenze Gemini Code Assist:

  • consumerprocurement.orders.get
  • consumerprocurement.orders.licensePools.*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Tieni inoltre presente che, affinché una delle autorizzazioni precedenti funzioni, l'API Gemini in Google Cloud deve essere abilitata nello stesso progetto Google Cloud in cui hai assegnato ogni autorizzazione.

Modificare il canale di rilascio del progetto Google Cloud

Rilasciamo le funzionalità di Gemini Code Assist in diversi canali di rilascio, in disponibilità generale o in anteprima. Quando configuri Gemini Code Assist, il tuo progetto viene impostato automaticamente sul canale di rilascio Disponibilità generale.

Puoi cambiare il canale di rilascio di Gemini Code Assist passando al canale di anteprima o tornando al canale disponibile a livello generale in qualsiasi momento.

Passaggi successivi

• Scopri di più sui tipi di assistenza AI generativa disponibili in Gemini in Google Cloud.
• Scopri in che modo Gemini per Google Cloud utilizza i tuoi dati.
• Scopri come accedere e gestire i controlli amministrativi di Gemini Code Assist Standard ed Enterprise.
• Scopri come configurare la personalizzazione del codice per Gemini Code Assist Enterprise.
• Configura i Controlli di servizio VPC per Gemini Code Assist Standard ed Enterprise.