Prima di poter utilizzare Gemini Code Assist, il tuo team deve eseguire i passaggi di configurazione descritti in questo documento:
Assegna le licenze ai singoli utenti della tua organizzazione.
Abilitare l'API Gemini per Google Cloud in un progetto Google Cloud.
Concedere ruoli di Identity and Access Management (IAM) in un progetto Google Cloud.
Gli utenti della tua organizzazione installano il plug-in Cloud Code per utilizzare Gemini Code Assist in un IDE.
Acquista un abbonamento a Gemini Code Assist
I passaggi necessari per acquistare un abbonamento a Gemini in Code Assist dipendono dalla versione che acquisti: Enterprise o Standard. Per un elenco delle funzionalità disponibili in ogni versione, vedi Funzionalità supportate.
Versione Enterprise
Gemini Code Assist Enterprise è disponibile a 19 $al mese al per un periodo di 12 mesi fino al 31 marzo 2025. Contatta il nostro team di vendita per usufruire di questa offerta promozionale.
Versione Standard
È possibile provare Gemini Code Assist versione senza un abbonamento senza costi fino all'8 novembre 2024, con un limite di un utente per fatturazione . Le organizzazioni con più utenti per account di fatturazione devono acquistare un abbonamento come descritto in questa sezione.
Se hai contratti esistenti con Google Cloud, contatta il nostro team di vendita prima di acquistare un abbonamento.
Nota: devi disporre diconsumerprocurement.orders.place
Autorizzazione Identity and Access Management (IAM) per acquistare un Gemini
abbonamento. 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.
Vai alla pagina Gemini per Google Cloud.
Si apre la pagina Gemini per Google Cloud.
Fai clic su Ottieni Gemini Code Assist. Se il progetto ha già Gemini Code Assist, viene visualizzato il testo Gestisci Gemini Code Assist.
Si apre la pagina Richiedi un abbonamento a Gemini in Code Assist.
In Configura abbonamento, completa i campi per configurare abbonamento, tra cui:
- Nome della sottoscrizione.
- Numero di licenze incluse nell'abbonamento.
- 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 dopo il periodo dell'impegno (mensile o annualmente). Il rinnovo automatico mantiene attivi l'abbonamento e le licenze. Se l'abbonamento non si rinnova automaticamente, termina alla scadenza dell'attuale periodo. devi ripetere la procedura di acquisto e riassegnarla licenze.
Per esaminare i dettagli dell'abbonamento, fai clic su Continua.
Se accetti i termini, seleziona Accetto i termini di questo acquisto e poi fai clic su Conferma abbonamento.
Fai clic su 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.
Console
Per assegnare licenze di Gemini a singoli utenti nel Console Google Cloud, devi disporre delle seguenti autorizzazioni:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
Vai alla pagina Amministrazione di Gemini.
Scegli l'abbonamento che vuoi modificare e poi fai clic su Modifica abbonamento.
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.
Seleziona uno o più utenti dall'elenco e fai clic su Avanti.
Scegli i servizi Gemini per i quali vuoi assegnare le licenze.
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 fatturazioneORDER_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 abilitare l'API Gemini per Google Cloud in uno altri 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
In questa sezione vengono descritti i passaggi necessari per attivare il Gemini per l'API Google Cloud in un progetto Google Cloud.
Console
Per abilitare l'API Gemini for Google Cloud, vai alla pagina Gemini for Google Cloud.
Nel selettore di progetti, seleziona un progetto.
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.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Nel menu del selettore dei progetti, seleziona un progetto.
Abilita l'API Gemini per 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 il tuo progetto Google Cloud ID.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.
Concedi ruoli IAM in un progetto Google Cloud
Questa sezione descrive i passaggi necessari per concedere Gemini per l'utente Google Cloud i ruoli IAM consumer per l'utilizzo di servizi e Service Usage.
Console
Per concedere i ruoli IAM necessari per utilizzare Gemini, vai alla pagina IAM e amministrazione.
Nella colonna Principale, individua un'entità a cui vuoi concedere l'accesso a Gemini e fai clic su Modifica entità nella riga corrispondente.
Nel riquadro Modifica accesso, fai clic su
Aggiungi un altro ruolo.In Seleziona un ruolo, seleziona Gemini per l'utente Google Cloud.
Fai clic su Aggiungi un altro ruolo e seleziona Consumatore di utilizzo del servizio.
Fai clic su Salva.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Seleziona un progetto nel menu del selettore dei progetti.
Concedi il ruolo di Utente Gemini per 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 formauser|group|serviceAccount:email
odomain:domain
, ad esempiouser:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
odomain:example.domain.com
.L'output è un elenco di associazioni di criteri che include quanto segue:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
Concedi il ruolo Consumer utilizzo dei servizi:
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, vedi
Assegna un singolo ruolo
e
gcloud projects add-iam-policy-binding
Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere le funzionalità di Gemini per Google Cloud Console Google Cloud all'interno del progetto specificato. Per ulteriori informazioni, vedi Panoramica di Gemini per Google Cloud.
Installa il plug-in Cloud Code per utilizzare Gemini Code Assist in un IDE
Gli utenti della tua organizzazione installano Gemini Code Assist nel loro nell'IDE preferito. Per ulteriori informazioni, consulta le seguenti risorse:
- Cloud Workstations: Scrivere codice con Gemini Code Assist
- Editor di Cloud Shell: Scrivere codice con Gemini Code Assist
- Cloud Code per VS Code: Scrivere codice con Gemini Code Assist
- Cloud Code per IntelliJ e altri IDE JetBrains: Scrivere codice con Gemini Code Assist
Attività di configurazione avanzata
Anziché utilizzare la console Google Cloud o gcloud CLI concedere ruoli IAM predefiniti, puoi eseguire una delle seguenti operazioni:
Utilizza le API REST IAM oppure librerie client IAM da concedere ruoli.
Se utilizzi queste interfacce, utilizza i nomi completi dei ruoli:
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
Assegnare e gestire le licenze.
Tutti i ruoli personalizzati che crei richiedono le seguenti autorizzazioni per accedere a 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 qualsiasi delle precedenti autorizzazioni funzionino, L'API Gemini per Google Cloud deve essere abilitata nello stesso progetto Google Cloud in cui che hai assegnato a ciascuna autorizzazione.
Passaggi successivi
- Scopri di più sui tipi di assistenza IA generativa disponibili in Gemini Code Assist per Google Cloud.
- Scopri in che modo Gemini Code Assist per Google Cloud utilizza i tuoi dati.
- Impara come accedere ai controlli amministratore di Gemini Code Assist e gestirli.
- Scopri come configurare la personalizzazione del codice.