Configurare Gemini Cloud Assist in Fatturazione Cloud

Per configurare Gemini Cloud Assist in Fatturazione Cloud, esegui i seguenti passaggi:

  1. Abilita l'API Gemini Cloud Assist 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 Cloud Assist. In genere, questo passaggio viene eseguito da un amministratore.

Abilita l'API Gemini Cloud Assist in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per attivare l'API Gemini Cloud Assist in un progetto Google Cloud.

Console

  1. Per abilitare l'API Gemini Cloud Assist, vai alla pagina API Gemini Cloud Assist.

    Vai all'API Gemini Cloud Assist

  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 viene aggiornata 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 Cloud Assist utilizzando il comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Se vuoi attivare l'API Gemini Cloud Assist in un altro progetto Google Cloud, aggiungi il parametro --project:

    gcloud services enable geminicloudassist.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 Cloud Assist 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 Cloud Assist, concedi i seguenti ruoli IAM agli utenti (principali) del progetto:

  • Gemini Cloud Assist User
  • Service Usage Consumer

Console

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

    Vai a IAM e amministrazione

  2. Nella colonna Ente, individua un'entità per la quale vuoi attivare l'accesso a Gemini Cloud Assist, quindi fai clic su Modifica entità in quella riga.

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

  4. In Seleziona un ruolo, seleziona Utente di assistenza Gemini 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 Gemini Cloud Assist User:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/geminicloudassist.user

    Sostituisci PRINCIPAL con l'identificatore per l'entità. L'identificatore ha la forma user|group|serviceAccount:email o domain:domain, ad esempio user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com o domain:example.domain.com.

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

    - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.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 (principal) a cui sono concessi questi ruoli possono accedere alle funzionalità di Gemini Cloud Assist 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 dei report sui costi. Per saperne di più, 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/geminicloudassist.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 Cloud Assist:

    • geminicloudassist.companions.generateChat
    • geminicloudassist.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 sulla fatturazione, concedi l'accesso all'account di fatturazione Cloud collegato al progetto in cui è abilitata l'API Gemini Cloud Assist.

Passaggi successivi