Per configurare Gemini Cloud Assist in Fatturazione Cloud, esegui i seguenti passaggi:
Abilita l'API Gemini for Google Cloud in un progetto Google Cloud. In genere, questo passaggio viene eseguito da un amministratore.
Nel progetto Google Cloud, concedi i ruoli IAM (Identity and Access Management) agli stessi utenti che accedono ai report di fatturazione Cloud. In genere, questo passaggio viene eseguito da un amministratore.
Per gli utenti che devono accedere ai report di fatturazione Cloud e a Gemini Cloud Assist in Fatturazione Cloud, concedi i ruoli IAM nell'account di fatturazione Cloud collegato al progetto in cui è abilitata l'API Gemini for Google Cloud. In genere questo passaggio viene eseguito da un amministratore.
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
Per abilitare l'API Gemini for Google Cloud, vai alla pagina Gemini for Google Cloud.
Nel selettore dei progetti, seleziona un progetto.
Per gli utenti di Cloud Billing che dispongono di autorizzazioni a livello di account di fatturazione nell'account di fatturazione Cloud, ti consigliamo di utilizzare un progetto di amministrazione di FinOps per contenere l'API.
Fai clic su Attiva.
La pagina viene aggiornata e mostra lo stato API abilitata.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Nel menu del selettore dei progetti, seleziona un progetto.
Per gli utenti di Cloud Billing che dispongono di autorizzazioni a livello di account di fatturazione nell'account di fatturazione Cloud, ti consigliamo di utilizzare un progetto di amministrazione di FinOps per contenere l'API.
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.
Dopo aver attivato l'API Gemini for Google Cloud nel progetto Google Cloud specificato, Gemini Cloud Assist è ora disponibile per tutti gli utenti che dispongono dei ruoli IAM richiesti nel progetto specificato.
Concedi ruoli IAM in un progetto Google Cloud
Questa sezione descrive i passaggi per concedere le autorizzazioni di progetto necessarie per utilizzare Gemini Cloud Assist. Nel progetto Google Cloud in cui hai attivato l'API Gemini for Google Cloud, concedi i seguenti ruoli IAM agli utenti (principali) del progetto:
- Gemini for Google Cloud User
- Service Usage Consumer
Console
Per concedere i ruoli IAM necessari per utilizzare Gemini for Google Cloud, vai alla pagina IAM e amministrazione.
Nella colonna Principale, individua un'entità per la quale vuoi attivare 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 Gemini for 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.
Nel menu del selettore dei progetti, seleziona un progetto.
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 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 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 (entità) a cui sono concessi questi ruoli possono accedere alle funzionalità di Gemini for Google Cloud nella console Google Cloud all'interno del progetto specificato. Se gli utenti del progetto hanno anche accesso per visualizzare i report di fatturazione Cloud, possono utilizzare Gemini Cloud Assist nei report di fatturazione Cloud per ricevere assistenza AI per creare report sui costi e riepilogare le informazioni chiave ricavate da questi report. Per ulteriori informazioni, consulta la panoramica di Gemini Cloud Assist in Fatturazione Cloud.
Attività di configurazione IAM avanzate per i progetti
Anziché utilizzare la console Google Cloud o gcloud CLI per concedere ruoli IAM predefiniti a un progetto, 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.
Tutti i ruoli personalizzati per le autorizzazioni del progetto che crei richiedono le seguenti autorizzazioni per accedere a Gemini for Google Cloud:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
serviceusage.services.use
Concedi ruoli IAM in un account di fatturazione Cloud
Per gli utenti che devono accedere ai report di fatturazione Cloud, devi concedere autorizzazioni nell'account di fatturazione Cloud adeguate per accedere alla pagina Report. Per utilizzare Gemini Cloud Assist nel report di fatturazione, concedi l'accesso all'account di fatturazione Cloud collegato al progetto in cui è abilitata l'API Gemini for Google Cloud.
Autorizzazioni richieste: per indicazioni dettagliate sulle autorizzazioni necessarie per accedere ai report di fatturazione, consulta la sezione Autorizzazioni necessarie per accedere ai report nell'articolo "Analisi dei dati di fatturazione e delle tendenze di costo con i report".
Concedi l'accesso: per indicazioni su come concedere l'accesso a un account di fatturazione Cloud, consulta la sezione Aggiornare le autorizzazioni utente per un account di fatturazione Cloud nell'articolo "Gestire l'accesso agli account di fatturazione Cloud".
Passaggi successivi
- Scopri di più sull'assistenza AI disponibile in Gemini Cloud Assist in Fatturazione Cloud.
- Scopri di più sui diversi tipi di assistenza di AI generativa disponibili in Gemini per Google Cloud.
- Scopri in che modo Gemini for Google Cloud utilizza i tuoi dati.
- Scopri di più sulla conformità di Google Cloud.