Prima di poter utilizzare Gemini Code Assist, il tuo team deve eseguire i passaggi di configurazione descritti in questo documento:
(Facoltativo) Acquista un abbonamento a Gemini Code Assist. È possibile provare Gemini Code Assist senza costi fino all'11 luglio 2024, con un limite di un utente per account di fatturazione.
Abilita l'API Cloud AI Companion in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.
Concedi i ruoli IAM (Identity and Access Management) in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.
(Facoltativo) Per utilizzare Gemini Code Assist in un IDE, installa il plug-in Cloud Code.
(Facoltativo) Acquista un abbonamento a Gemini in Code Assist
È possibile 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à dei contratti con Google Cloud, contatta il nostro team di vendita prima di acquistare un abbonamento.
Nella console Google Cloud, vai alla pagina Gemini per Google Cloud.
Si apre la pagina Gemini per Google Cloud.
Seleziona Gemini Code Assist.
Viene visualizzato il riquadro Gemini Code Assist.
Fai clic su Ottieni Gemini Code Assist.
Se richiesto, seleziona un account di fatturazione, quindi fai clic su Vai alla pagina Amministrazione per Gemini.
Si apre la pagina Acquista abbonamento a Gemini in Code Assist.
In Configura abbonamento, completa i campi per configurare l'abbonamento, inclusi il periodo dell'impegno (mensile o annuale) e il numero di licenze nell'abbonamento.
Scegli se vuoi rinnovare automaticamente l'abbonamento dopo il termine dell'impegno (mensile o annuale). Il rinnovo automatico mantiene attivi l'abbonamento e le licenze. Se l'abbonamento non si rinnova automaticamente, terminerà alla scadenza dell'attuale periodo di validità e dovrai ripetere la procedura di acquisto per recuperare le licenze.
Per rivedere i dettagli dell'abbonamento, fai clic su Continua.
Se accetti i termini, fai clic su Completa l'acquisto, quindi conferma il tuo abbonamento.
Ora la fatturazione è abilitata per Gemini. Ora devi abilitare l'API Cloud AI Companion in uno o più progetti associati a questo account di fatturazione. Gli utenti non vedranno Gemini finché non lo attivi in almeno un progetto.
Abilita l'API Cloud AI Companion in un progetto Google Cloud
Questa sezione descrive i passaggi necessari per abilitare l'API Cloud AI Companion in un progetto Google Cloud.
Console
Per abilitare l'API Cloud AI Companion, vai alla pagina Gemini per Google Cloud.
Nel selettore di progetti, seleziona un progetto.
Fai clic su Abilita.
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
-
Nella console Google Cloud, attiva Cloud Shell.
Seleziona un progetto nel menu del selettore dei progetti.
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 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.
Concedi ruoli IAM in un progetto Google Cloud
Questa sezione descrive i passaggi necessari per concedere agli utenti i ruoli IAM Utente Cloud AI Companion e consumer per utilizzo dei servizi.
Console
Per concedere i ruoli IAM necessari per utilizzare Gemini, vai alla pagina IAM e amministrazione.
Nella colonna Entità, trova un'entità per cui vuoi abilitare l'accesso a Gemini, quindi fai clic su Modifica entità nella riga corrispondente.
Nel riquadro Modifica accesso, fai clic su
Aggiungi un altro ruolo.In Seleziona un ruolo, seleziona Utente Cloud AI Companion.
Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer (Consumatore di Service Usage).
Fai clic su Salva.
gcloud
-
Nella console Google Cloud, attiva Cloud Shell.
Seleziona un progetto nel menu del selettore dei progetti.
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 assume il formatouser|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 maggiori informazioni, 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à di Gemini per Google Cloud nella console Google Cloud all'interno del progetto specificato. Per saperne di più, consulta la panoramica di Gemini per Google Cloud.
(Facoltativo) Usa 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:
- Cloud Workstations: Codifica con Gemini Code Assist
- Editor di Cloud Shell: Codice con Gemini Code Assist
- Cloud Code for VS Code: Codice con Gemini Code Assist
- Cloud Code for IntelliJ e altri IDE JetBrains: Codifica con Gemini Code Assist
Attività di configurazione avanzata
Anziché utilizzare la console Google Cloud o gcloud CLI per concedere ruoli IAM predefiniti, puoi:
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.serviceUsageConsumer
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 richiedono le seguenti autorizzazioni per accedere a Gemini:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
serviceusage.services.use
Passaggi successivi
- Scopri di più sui tipi di assistenza dell'AI generativa disponibili in Gemini per Google Cloud.
- Scopri come Gemini per Google Cloud utilizza i tuoi dati.
- Scopri come accedere ai controlli di amministrazione di Gemini e gestirli.