Configura Gemini Code Assist

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

  1. Acquista un abbonamento a Gemini Code Assist.

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

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

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

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

Acquista un abbonamento a Gemini Code Assist

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

Ai 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 gratuite per il primo mese, indipendentemente dalla versione di Gemini Code Assist. Tieni presente che non puoi aumentare il numero di crediti gratuiti dopo l'assegnazione dei crediti per le licenze gratuite iniziali. Inoltre, non puoi modificare la versione di Gemini Code Assist entro il primo mese.

Gemini Code Assist Enterprise è disponibile a 19 $al mese per utente con un impegno di 12 mesi fino al 31 marzo 2025. Contatta il nostro team di vendita per usufruire di questa offerta promozionale.

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 la gestione di identità e accesso (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 Gemini for Google Cloud.

    Vai a Gemini per Google Cloud

    Si apre la pagina Gemini for Google Cloud.

  2. Seleziona Ricevi Gemini Code Assist. Tieni presente che se per il tuo account di fatturazione non è stato acquistato un abbonamento a Gemini Code Assist, viene visualizzato il messaggio Idoneo per la prova di 30 giorni per un massimo di 50 licenze senza costi. Se il tuo progetto ha già Gemini Code Assist, viene visualizzato il testo Gestisci Gemini Code Assist.

    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.
    • Rinnovo automatico dell'abbonamento al termine del periodo di impegno (mensile o annuale). Il rinnovo automatico mantiene attivi l'abbonamento e le licenze. Se l'abbonamento non si rinnova automaticamente, termina al termine del periodo in corso e dovrai ripetere la procedura di acquisto e riassegnare le licenze.

  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 a Gemini Code Assist è stato acquistato. Ora devi gestire le assegnazioni delle licenze Gemini nella tua organizzazione.

Assegnare le licenze

Prima di utilizzare Gemini Code Assist, ogni singolo utente della tua organizzazione deve avere una licenza.

Ai 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 gratuite per il primo mese, indipendentemente dalla versione di Gemini Code Assist. Tieni presente che non puoi aumentare il numero di crediti gratuiti dopo l'assegnazione dei crediti per le licenze gratuite iniziali. Inoltre, non puoi modificare la versione di Gemini Code Assist entro il primo mese.

Console

Per assegnare licenze Gemini a singoli utenti nella console Google Cloud, devi disporre delle seguenti autorizzazioni:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  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, devi disporre dell'autorizzazione consumerprocurement.licensePools.assign.

Metodo HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Sostituisci quanto segue:

  • BILLING_ACCOUNT_ID: l'ID account di fatturazione
  • ORDER_ID: il criterio IAM

Corpo della richiesta:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

L'output è simile al seguente:

{}

La risposta è vuota se la licenza è stata assegnata correttamente.

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

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 progetto Google 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 progetto Google Cloud, aggiungi il parametro --project:

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

    Sostituisci PROJECT_ID con l'ID del tuo 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 per Google Cloud è ora disponibile nel progetto Google Cloud specificato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

API richieste per gli utenti dietro firewall

Oltre ad abilitare l'API Gemini for Google Cloud, gli utenti dietro i firewall potrebbero dover abilitare anche 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 l'invio della telemetria dei prodotti, inclusi gli eventi relativi all'accettazione dei suggerimenti.
  • 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.

(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 dall'esterno 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 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. 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 PRINCIPAL con l'identificatore per l'entità. L'identificatore ha la forma user|group|serviceAccount:email o domain:domain, ad esempio user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com o domain:example.domain.com.

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

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

  3. Concedi il ruolo Consumatore di utilizzo del servizio:

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

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

    - members:
  - user:PRINCIPAL
  role: 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 concessi questi ruoli possono accedere alle funzionalità di Gemini for Google Cloud nella console Google Cloud all'interno del progetto specificato. Per ulteriori informazioni, consulta la panoramica di Gemini per Google Cloud .

Installare il plug-in Gemini Code Assist in un IDE

Gli utenti della tua organizzazione installano Gemini Code Assist nel loro IDE preferito. Per ulteriori informazioni, consulta le seguenti risorse:

Per impostazione predefinita, Gemini Code Assist è incluso nei seguenti IDE:

Attività di configurazione avanzata

Anziché utilizzare la console Google Cloud o 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, tutti i ruoli personalizzati che crei richiedono le seguenti autorizzazioni:

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

  • Assegna e gestisci le licenze.

    Per accedere a 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 progetto Google Cloud in cui hai assegnato ogni autorizzazione.

Passaggi successivi