Configurare Gemini Cloud Assist

Prima di poter utilizzare Gemini Cloud Assist, il tuo amministratore deve eseguire i passaggi di configurazione descritti in questo documento. Gemini Cloud Assist può essere configurato per un progetto o una cartella.

Configura Gemini Cloud Assist per un progetto

I passaggi riportati di seguito descrivono in dettaglio come configurare Gemini Cloud Assist per un progetto nella console Google Cloud o utilizzando Google Cloud CLI.

Console

  1. Vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

  2. Nel selettore dei progetti nella parte superiore della pagina, seleziona la risorsa del progetto.

  3. Seleziona Ottieni Gemini Cloud Assist.

  4. Nella finestra di dialogo Ottieni Gemini Cloud Assist, procedi nel seguente modo:

    1. Seleziona la freccia di espansione nella sezione API richieste e consigliate.

    2. Assicurati che le seguenti API richieste siano abilitate: API Gemini Cloud Assist e API Gemini for Google Cloud.

    3. Nell'elenco API consigliate, seleziona le API da attivare.

    4. (Facoltativo) Seleziona Aiuta Google a migliorare Cloud Assist condividendo i prompt e le risposte.

    5. Seleziona Attiva Gemini Cloud Assist senza costi.

  5. Fai clic su Salva.

  6. Concedi i ruoli IAM necessari per utilizzare Gemini Cloud Assist.

    1. Vai alla pagina IAM e amministrazione.

      Vai a IAM e amministrazione

    2. Nella colonna Principale, individua un'entità a cui vuoi concedere l'accesso a Gemini Cloud Assist e 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 di assistenza Gemini Cloud.

    5. Fai clic su Aggiungi un altro ruolo e seleziona Visualizzatore del recommender.

    Se l'entità principale vuole ricevere assistenza per i prodotti a cui non ha già accesso, potrebbe essere necessario concederle ruoli IAM aggiuntivi. Consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti.

gcloud

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

    Activate Cloud Shell

  2. Abilita l'API Gemini Cloud Assist utilizzando il comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com
    

    Questo passaggio abilita anche l'API Gemini for Google Cloud, obbligatoria anche per l'utilizzo di Gemini Cloud Assist.

    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
    

    L'output è simile al seguente:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    
  3. Concedi i ruoli IAM in un progetto Google Cloud. Per ulteriori informazioni, consulta Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

    1. Concedi il ruolo roles/geminicloudassist.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
      
    2. Ripeti il passaggio precedente per il ruolo roles/recommender.viewer.

    Se l'entità principale vuole ricevere assistenza per i prodotti a cui non ha già accesso, potrebbe essere necessario concederle ruoli IAM aggiuntivi. Consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti.

Configurare Gemini Cloud Assist per una cartella

I passaggi che seguono descrivono in dettaglio come configurare Gemini Cloud Assist per una cartella nella console Google Cloud. Non puoi utilizzare Google Cloud CLI per configurare Gemini Cloud Assist.

  1. Abilita le API richieste e consigliate.

    1. Vai alla pagina Amministrazione di Gemini.

      Vai ad Amministrazione per Gemini

    2. Dal selettore dei progetti nella parte superiore della pagina, seleziona la risorsa della cartella.

    3. Seleziona Ricevi Gemini Cloud Assist.

      Viene visualizzata la finestra di dialogo Abilita l'API per i progetti esistenti nella cartella.

    4. Nella finestra di dialogo Abilita l'API per i progetti esistenti in una cartella,seleziona la freccia di espansione nella sezione API richieste e consigliate.

    5. Assicurati che le seguenti API richieste siano abilitate: API Gemini Cloud Assist e API Gemini for Google Cloud.

    6. Nell'elenco API consigliate, seleziona le API da attivare.

    7. (Facoltativo) Seleziona Aiuta Google a migliorare Cloud Assist condividendo i prompt e le risposte.

    8. Seleziona Attiva Gemini Cloud Assist senza costi.

      Questo passaggio abilita le API consigliate richieste e selezionate per tutti i progetti nella cartella. Se vuoi delle eccezioni per alcuni progetti nella cartella, puoi bloccare l'attivazione dell'API impostando un vincolo del criterio dell'organizzazione Limita utilizzo servizio risorse su questi progetti. Per ulteriori informazioni, consulta Limitare l'utilizzo delle risorse.

  2. Concede i seguenti ruoli IAM o crea ruoli personalizzati con autorizzazioni equivalenti per la cartella:

    • Utente di Gemini per Google Cloud
    • Visualizzatore di asset cloud
    • Recommender Viewer

    Se l'entità principale vuole ricevere assistenza per i prodotti a cui non ha già accesso, potrebbe essere necessario concederle ruoli IAM aggiuntivi. Consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti.

  3. Se utilizzi Gemini Cloud Assist con le applicazioni, devi attivare anche la gestione delle applicazioni. Questo passaggio crea un progetto di gestione a cui devi collegare un account di fatturazione.

    1. Torna alla pagina Amministrazione per Gemini.

      Vai ad Amministrazione per Gemini

    2. Seleziona Attiva gestione app.

      Viene visualizzata la pagina delle impostazioni IAM e amministrazione.

    3. Seleziona Attiva nella sezione Abilitazione app della pagina.

      Viene visualizzata la finestra di dialogo Abilita le API dell'applicazione in questa cartella.

    4. Seleziona Attiva.

      Una barra di stato mostra lo stato di avanzamento dell'abilitazione dell'API. La pagina delle impostazioni IAM e amministrazione viene aggiornata al termine dell'abilitazione dell'API.

    5. Seleziona Gestisci la fatturazione.

      Viene visualizzata la pagina Account collegato.

    6. Seleziona un account di fatturazione dall'elenco e poi seleziona Imposta account.

  4. Concede i ruoli IAM che hai assegnato alla cartella nel passaggio 2 o crea ruoli personalizzati con autorizzazioni equivalenti al progetto di gestione creato nel passaggio precedente.

    Trova il progetto di gestione per la cartella:

    1. Torna alla pagina Amministrazione per Gemini.

      Vai ad Amministrazione per Gemini

    2. Dal selettore dei progetti nella parte superiore della pagina, seleziona la risorsa della cartella.

    3. Seleziona Gestisci le impostazioni di Gemini Cloud Assist.

      Viene visualizzata la finestra di dialogo Gestisci Gemini Cloud Assist.

    4. Prendi nota del progetto di gestione.

  5. (Facoltativo) Configura le impostazioni per i progetti nella cartella.

Passaggi successivi