Configura Gemini Cloud Assist

Gemini Cloud Assist ti aiuta a progettare, gestire e ottimizzare le applicazioni e l'infrastruttura cloud con una guida contestuale basata sull'AI. Prima che i membri del team possano utilizzare queste funzionalità, un amministratore deve completare la configurazione iniziale di un progetto o di una cartella.

Configura Gemini Cloud Assist per un progetto

I passaggi seguenti descrivono come configurare Gemini Cloud Assist per un progetto.

Console

  1. Vai alla pagina Amministratore di Gemini.

    Vai a Gemini in Google Cloud

  2. Dal selettore di progetti nella parte superiore della pagina, seleziona la risorsa del progetto.

  3. Seleziona Abilita 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 obbligatorie e consigliate.

    2. Nell'elenco API Recommender, seleziona eventuali API aggiuntive che vuoi abilitare per migliorare le prestazioni di Gemini Cloud Assist.

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

    4. Seleziona Abilita 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 Entità, trova un'entità a cui vuoi concedere 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 Gemini Cloud Assist.

    5. Fai clic su Aggiungi un altro ruolo e seleziona Visualizzatore asset Cloud.

    6. Se l'entità vuole ricevere assistenza per prodotti a cui non ha già accesso, potresti dover concedere altri ruoli IAM facendo clic su Aggiungi un altro ruolo e selezionando altri ruoli. Consulta i 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 i diversi prodotti.

    7. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, consulta le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.

  7. (Facoltativo) Configura le impostazioni del progetto.

gcloud

  1. Nella console Google Cloud , attiva Cloud Shell.

    Attiva 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, necessaria anche per utilizzare Gemini Cloud Assist.

    Se vuoi abilitare l'API Gemini Cloud Assist in un progettoGoogle Cloud diverso, aggiungi il parametro --project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto per il quale stai abilitando Gemini Cloud Assist.

    L'output è simile al seguente:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

  3. Abilita le altre API richieste utilizzando il comando gcloud services enable come hai fatto per abilitare l'API Gemini Cloud Assist:

    gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID

  4. (Facoltativo) Abilita le API Recommender utilizzando il comando gcloud services enable come hai fatto per abilitare l'API Gemini Cloud Assist.

  5. Concedere ruoli IAM in un progetto Google Cloud . Per saperne di più, consulta Concedi 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 quanto segue:

      • PROJECT_ID: l'ID del tuo progettoGoogle Cloud , ad esempio1234567890.
      • PRINCIPAL: l'identificatore dell'entità, ad esempio user:cloudysanfrancisco@gmail.com.

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

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

    2. Ripeti il passaggio precedente per il ruolo roles/cloudasset.viewer.

    3. Se l'entità vuole ricevere assistenza per prodotti a cui non ha già accesso, potresti dover concedere ruoli IAM aggiuntivi. Consulta i 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 i diversi prodotti.

    4. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, consulta le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.

  6. (Facoltativo) Configura le impostazioni del progetto.

API

Queste istruzioni utilizzano cURL per chiamare i metodi API.

  1. Abilita l'API Gemini Cloud Assist utilizzando il metodo services.enable:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"

    Sostituisci PROJECT_ID con l'ID del progetto per il quale stai abilitando Gemini Cloud Assist.

    Se il comando ha esito positivo, restituisce un long-running operation, che include un campo name. Puoi utilizzare il valore nel campo name per controllare lo stato dell'operazione.

  2. Abilita le seguenti API aggiuntive richieste utilizzando il metodo services.enable come hai fatto per abilitare l'API Gemini Cloud Assist:

    • cloudasset.googleapis.com
    • designcenter.googleapis.com
    • appoptimize.googleapis.com
    • apphub.googleapis.com

  3. (Facoltativo) Abilita le API Recommender utilizzando il metodo services.enable come hai fatto per abilitare l'API Gemini Cloud Assist.

  4. Concedi i ruoli IAM per il progetto Google Cloud associato.

    1. Crea un file JSON che contenga le seguenti informazioni:

        {
    "options": {
      "requestedPolicyVersion": 3
    }
  }

    2. Recupera la policy IAM esistente per il progetto utilizzando il metodo projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"

      Sostituisci quanto segue:

      • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio precedente.

      • PROJECT_ID: l'ID del progetto.

      In caso di esito positivo, la risposta restituisce la policy IAM del progetto.

    3. Copia la policy IAM del progetto in un file JSON vuoto e aggiungi le seguenti informazioni ai contenuti esistenti:

        {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/cloudasset.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }

      Sostituisci PRINCIPAL con l'identificatore dell'entità a cui concedi l'accesso a Gemini Cloud Assist.

    4. Applica la policy IAM aggiornata al progetto utilizzando il metodo projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"

      Sostituisci quanto segue:

      • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio precedente.

      • PROJECT_ID: l'ID del progetto.

      In caso di esito positivo, la risposta restituisce la policy IAM aggiornata del progetto.

    5. Se l'entità vuole ricevere assistenza per prodotti a cui non ha già accesso, potresti dover concedere ruoli IAM aggiuntivi. Consulta i 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 i diversi prodotti.

    6. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, consulta le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.

  5. (Facoltativo) Configura le impostazioni del progetto.

Configura Gemini Cloud Assist per una cartella

I passaggi seguenti descrivono come configurare Gemini Cloud Assist per una cartella utilizzando la console Google Cloud . Non puoi utilizzare Google Cloud CLI o l'API per configurare Gemini Cloud Assist per le cartelle.

  1. Abilita le API richieste e consigliate.

    1. Vai alla pagina Amministratore di Gemini.

      Vai ad Amministratore di Gemini

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

    3. Seleziona Abilita API 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 che si trova nella sezione API richieste e consigliate.

    5. Nell'elenco API consigliate, seleziona le API facoltative che vuoi attivare.

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

    7. Seleziona Abilita Gemini Cloud Assist senza costi.

      Questo passaggio abilita le API richieste e le API Recommender selezionate per tutti i progetti nella cartella. Se vuoi eccezioni per alcuni progetti nella cartella, puoi bloccare l'abilitazione delle API impostando un vincolo delle policy dell'organizzazione Limita utilizzo servizi delle risorse su questi progetti. Per saperne di più, consulta Limitazione dell'utilizzo delle risorse.

  2. Concedi i seguenti ruoli IAM o crea ruoli personalizzati con autorizzazioni equivalenti sulla cartella:

    • Gemini Cloud Assist User
    • Cloud Asset Viewer

    Se l'entità vuole ricevere assistenza per prodotti a cui non ha già accesso, potresti dover concedere altri ruoli IAM. Consulta i 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 i diversi prodotti.

  3. Se la tua cartella fa parte di un'organizzazione che utilizza vincoli personalizzati, esamina le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.

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

    1. Torna alla pagina Amministratore di Gemini.

      Vai ad Amministratore di Gemini

    2. Seleziona Attiva gestione app.

      Viene visualizzata la pagina delle impostazioni di IAM e amministrazione.

    3. Seleziona Attiva nella sezione Attivazione 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 l'avanzamento dell'abilitazione dell'API. La pagina delle impostazioni di IAM e amministrazione viene aggiornata al termine dell'abilitazione dell'API.

    5. Seleziona Gestisci fatturazione.

      Viene visualizzata la pagina Account collegato.

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

  5. Concedi i ruoli IAM che hai concesso 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 Amministratore di Gemini.

      Vai ad Amministratore di Gemini

    2. Dal selettore di 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.

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

Passaggi successivi