Configurare Gemini Cloud Assist in 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 Cloud Billing, esegui i seguenti passaggi:

1. Abilita l'API Gemini for Google Cloud in un progetto Google Cloud. In genere, 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. In genere, 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. 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

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.

   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.

3. Fai clic su Attiva.

   La pagina si aggiorna e mostra lo stato API Enabled (API abilitata).

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 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.

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 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

1. Per concedere i ruoli IAM necessari per utilizzare Gemini for Google Cloud, vai alla pagina IAM e amministrazione.

   Vai a IAM e amministrazione

2. Nella colonna Principale, individua un'entità per la quale vuoi attivare 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.

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 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:[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, 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.