Configura Gemini Cloud Assist nella fatturazione Cloud

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per configurare Gemini Cloud Assist in Fatturazione Cloud, esegui i passaggi descritti in questo documento:

1. Abilitare l'API Gemini per Google Cloud in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.

2. Nel progetto Google Cloud, concedi i ruoli IAM (Identity and Access Management) agli stessi utenti che accedono ai report di fatturazione Cloud. Di solito questo passaggio viene eseguito da un amministratore.

3. 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. Di solito un amministratore esegue questo passaggio.

Abilitare l'API Gemini per 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

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 di progetti, seleziona un progetto.

   Per gli utenti della fatturazione Cloud che hanno autorizzazioni a livello di account di fatturazione sull'account di fatturazione Cloud, ti consigliamo di utilizzare una Progetto di amministrazione FinOps per contenere l'API.

3. Fai clic su Attiva.

   La pagina si aggiorna e mostra lo stato API Enabled.

gcloud

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

   Activate Cloud Shell

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

   Per gli utenti della fatturazione Cloud che hanno autorizzazioni a livello di account di fatturazione sull'account di fatturazione Cloud, ti consigliamo di utilizzare una Progetto di amministrazione FinOps per contenere l'API.

3. 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 abilitato l'API Gemini per Google Cloud, concedi i seguenti ruoli IAM agli utenti (entità) sul progetto:

• Utente di Gemini in Google Cloud
• Service Usage Consumer

Console

1. per concedere i ruoli IAM richiesti da utilizzare Gemini per Google Cloud, vai alla sezione IAM e Amministratore .

   Vai a IAM e amministrazione

2. Nella colonna Entità, trova un elemento entità per cui vuoi abilitare l'accesso a Gemini fai clic su Modifica entità in della riga in questione.

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

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

5. Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer (Consumatore di Service Usage).

6. Fai clic su Salva.

gcloud

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

   Activate Cloud Shell

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

3. Concedi il ruolo Utente di 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 forma user|group|serviceAccount:email o domain:domain, ad esempio user:[e-mail], group:[e-mail], serviceAccount:[e-mail] o domain:example.domain.com.

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

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

4. 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, vedi Assegna un singolo ruolo e gcloud projects add-iam-policy-binding

Tutti gli utenti (entità) 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. 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, vedi Panoramica di Gemini Cloud Assist nella 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 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.

  Tutti i ruoli personalizzati per le autorizzazioni del progetto che crei richiedono le seguenti autorizzazioni per accedere a Gemini per 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 report sulla fatturazione, concedi l'accesso all'account di fatturazione Cloud collegata al progetto in cui è abilitata l'API Gemini per 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 dei costi con i report".

• Concedi l'accesso: per indicazioni su come concedere l'accesso a un di account di fatturazione Cloud, consulta Aggiornare le autorizzazioni utente per un account di fatturazione Cloud disponibile in "Gestisci l'accesso agli account di fatturazione Cloud" .

Passaggi successivi

• Scopri di più su Assistenza basata sull'IA disponibile in Gemini Cloud Assist nella fatturazione Cloud.
• Scopri di più sulle diverse tipi di assistenza dell'AI generativa disponibili in Gemini per Google Cloud.
• Scopri in che modo Gemini per Google Cloud utilizza i tuoi dati.
• Scopri di più sulla conformità di Google Cloud.