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:

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

  2. Assegna le licenze ai singoli utenti della tua organizzazione.

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

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

  5. Gli utenti della tua organizzazione installano il plug-in Gemini Code Assist per utilizzare Gemini Code Assist Standard o Enterprise in un IDE.

Acquista 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 per le licenze senza costi iniziali. Inoltre, non puoi modificare la versione di Gemini 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 consumerprocurement.orders.place per Identity and Access Management (IAM) 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

    Viene visualizzata la pagina Amministrazione di Gemini.

  2. Seleziona Richiedi Gemini Code Assist.

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

    Si apre la pagina Acquista un 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, compila 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 applicata una tariffa scontata addebitata su base mensile anziché un pagamento una tantum.

  5. Per confermare l'abbonamento, seleziona Continua.

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

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

L'abbonamento è ora 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 Gemini Code Assist, è necessario assegnare una licenza a ogni singolo utente a cui deve essere concesso l'accesso nell'organizzazione.

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 per le licenze senza costi iniziali. Inoltre, non puoi modificare la versione di Gemini Code Assist entro il primo mese.

Console

Per assegnare licenze Gemini a singoli utenti nella Google Cloud console, devi disporre delle seguenti autorizzazioni per l'account di fatturazione:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

  1. Vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  2. Scegli l'abbonamento che vuoi modificare e poi fai clic su Modifica abbonamento.

  3. Fai clic su Assegna licenze. Viene visualizzata una finestra di dialogo di selezione dell'utente. Per cercare utenti specifici, inserisci il loro nome nella casella di ricerca.

  4. Seleziona uno o più utenti dall'elenco e fai clic su Avanti.

  5. Scegli i servizi Gemini per cui vuoi assegnare le licenze.

  6. Fai clic su Assegna licenze.

API

Per assegnare licenze Gemini con l'API, utilizza il metodo billingAccounts.orders.licensePool.assign.

  1. Assicurati di disporre dell'autorizzazione consumerprocurement.licensePools.assign Identity and Access Management (IAM) per l'account di fatturazione che contiene il pool di licenze di cui intendi assegnare la licenza.

  2. Crea un file JSON contenente le seguenti informazioni:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Dove USER_EMAILS è un elenco separato da virgole di account utente a cui viene assegnata la licenza. Ad esempio, "dana@example.com", "lee@example.com".

  3. Utilizza cURL per chiamare il metodo:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Sostituisci quanto segue:

    • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio 2.
    • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta dell'API vengono applicati a questo progetto.
    • BILLING_ACCOUNT_ID: l'ID per l'account di fatturazione associato al pool di licenze.
    • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account fatturazione.

In caso di esito positivo, la risposta è simile alla seguente:

  {}

Ora devi attivare l'API Gemini per Google Cloud 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 Google Cloud

Questa sezione descrive i passaggi necessari per attivare l'API Gemini per Google Cloud in un Google Cloud progetto.

Console

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

    Vai a Gemini per Google Cloud

  2. Nel selettore dei progetti, seleziona un progetto.

  3. Fai clic su Attiva.

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

Interfaccia a riga di comando gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  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 attivare l'API Gemini for Google Cloud in un altro Google Cloud progetto, aggiungi il parametro --project:

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

    Sostituisci PROJECT_ID con il tuo Google Cloud ID progetto.

    L'output è simile al seguente:

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

Gemini for Google Cloud è ora disponibile nel progettoGoogle 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 l'API 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: viene utilizzato per verificare che il progetto Gemini Code Assist dell'utente sia configurato correttamente.
  • cloudaicompanion.googleapis.com: l'endpoint principale dell'API Gemini for Google Cloud .
  • cloudcode-pa.googleapis.com: un'API interna che fornisce funzionalità relative 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 inviare la telemetria dei prodotti, inclusi gli eventi che indicano se i suggerimenti sono stati accettati.
  • feedback-pa.googleapis.com: un'API interna utilizzata per l'invio di feedback in IDE.
  • apihub.googleapis.com: utilizzato dalla funzionalità Browser dell'API Cloud Code.
  • lh3.googleusercontent.com e lh5.googleusercontent.com: utilizzati per ottenere le foto degli utenti.

Determina gli indirizzi IP per i Google Cloud domini predefiniti

Per abilitare la connettività dall'IDE alle Google Cloud API, il firewall deve consentire il traffico TCP in uscita alle 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 Google Cloud domini, hai a disposizione diverse opzioni:

(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 del servizio, devi anche modificare il criterio di ingresso per consentire l'accesso a questi servizi.

Per ulteriori informazioni, consulta Configurare i Controlli di servizio VPC per Gemini.

Concedi ruoli IAM in un Google Cloud progetto

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. Nella colonna Principale, individua un'entità per la quale vuoi concedere l'accesso a Gemini, quindi fai clic su Modifica entità nella riga corrispondente.

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

  4. In Seleziona un ruolo, seleziona Utente Gemini for Google Cloud.

  5. Fai clic su Aggiungi un altro ruolo e seleziona Consumatore di utilizzo del servizio.

  6. Fai clic su Salva.

Interfaccia a riga di comando gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

  2. Concedi il ruolo Utente di Gemini for Google Cloud:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto,ad esempio1234567890.
    • PRINCIPAL: l'identificatore del principale, ad esempio user:cloudysanfrancisco@gmail.com.

    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 ulteriori informazioni, consulta Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti a cui sono stati assegnati questi ruoli possono accedere alle funzionalità di Gemini per Google Cloud Google Cloud nella console del progetto specificato. Per maggiori informazioni, consulta la panoramica di Gemini per 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.

VS Code

  1. Per aprire la vista Estensioni in VS Code, fai clic su Icona dell'estensione 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 essere utilizzato. Puoi configurare ulteriormente l'installazione di Gemini Code Assist specificando le tue preferenze utilizzando la barra delle app di primo livello: vai a Codice > Impostazioni > Impostazioni > Estensioni e cerca Gemini Code Assist.

IntelliJ

  1. Fai clic su settings Impostazioni IDE e progetto > Componenti aggiuntivi.
  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. Quando l'IDE si riavvia, Gemini Code Assist viene visualizzato nella barra delle attività.

    L'icona di Gemini Code Assist viene visualizzata nella barra delle attività.

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

Per iniziare, consulta le seguenti guide:

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 memorizza 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 Google Cloud progetto

Dopo aver installato Gemini Code Assist nei propri 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 Google Cloud progetto.

VS Code

Se selezioni un Google Cloud progetto senza l'API Gemini for Google Cloud abilitata, riceverai una notifica che ti offre la possibilità di attivare l'API dall'IDE. Seleziona Abilita l'API nella finestra di notifica per abilitare l'API per il tuo progetto. Per maggiori informazioni, consulta Configurare Gemini Code Assist Standard ed Enterprise per un progetto.

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

Lancia VS Code

In caso contrario, segui questi passaggi:

  1. Avvia l'IDE.

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

  3. Nel riquadro della chat di 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.

    Ora sei in contatto con Google Cloud.

    Per selezionare un Google Cloud progetto in cui è attivata l'API Gemini per Google Cloud:

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

    La barra di stato di Gemini è disponibile.

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

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

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

    L'icona di Gemini nella barra di stato è impostata su normale.

IntelliJ

Per accedere al tuo Account Google:

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

  2. Fai clic su Accedi a Google.

  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.

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

  5. Torna all'IDE. Nella finestra dello strumento Gemini Code Assist, se accetti di consentire a Google di attivare 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 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

Anziché utilizzare la Google Cloud console o l'gcloud CLI 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 ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

  • Crea e concedi ruoli personalizzati.

    Per accedere a Gemini Code Assist Standard ed Enterprise, tutti i ruoli personalizzati che crei devono disporre delle seguenti autorizzazioni:

    • 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.

    Per assegnare e gestire le licenze Gemini Code Assist, tutti i ruoli personalizzati che crei devono disporre delle seguenti autorizzazioni:

    • 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é qualsiasi autorizzazione precedente funzioni, l'API Gemini per Google Cloud deve essere attivata nello stesso Google Cloud progetto in cui hai assegnato ogni autorizzazione.

Passaggi successivi