Configura 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 seguenti descrivono in dettaglio come configurare Gemini Cloud Assist per un progetto nella console Google Cloud o utilizzando Google Cloud CLI.

Console

Vai alla pagina Amministrazione di Gemini.

Vai a Gemini in Google Cloud
Dal selettore di progetti nella parte superiore della pagina, seleziona la risorsa del progetto.
Seleziona Ottieni Gemini Cloud Assist.
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 consigliate, seleziona le API aggiuntive che vuoi abilitare per migliorare il rendimento 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.
Fai clic su Salva.
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à, individua un'entità a cui vuoi concedere l'accesso a Gemini Cloud Assist, quindi fai clic su Modifica entità in quella riga.
3. Nel riquadro Accesso in modifica, 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 ancora accesso, potrebbe essere necessario concederle altri ruoli IAM facendo clic su Aggiungi un altro ruolo e selezionando altri ruoli. 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.
7. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, controlla le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.
(Facoltativo) Configura le impostazioni per il progetto.

gcloud

Nella console Google Cloud , attiva Cloud Shell.

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

Se vuoi abilitare l'API Gemini Cloud Assist in un altro progettoGoogle Cloud , 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 attivando Gemini Cloud Assist.

L'output è simile al seguente:
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```

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

(Facoltativo) Abilita le API consigliate utilizzando il comando gcloud services enable come hai fatto per abilitare l'API Gemini Cloud Assist.
Concedi ruoli IAM in un progetto Google Cloud . Per ulteriori informazioni, 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 Google Cloud progetto,ad esempio1234567890.
  - PRINCIPAL: l'identificatore del principal, ad esempio user:cloudysanfrancisco@gmail.com.
  L'output è un elenco di associazioni di 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, 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.
4. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, controlla le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.
(Facoltativo) Configura le impostazioni per il progetto.

API

Queste istruzioni utilizzano cURL per chiamare i metodi API.

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

Nota: l'attivazione del servizio geminicloudassist.googleapis.com attiva anche il servizio cloudaicompanion.googleapis.com, necessario per utilizzare Gemini Cloud Assist.
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
(Facoltativo) Abilita le API consigliate utilizzando il metodo services.enable come hai fatto per abilitare l'API Gemini Cloud Assist.
Concedi ruoli IAM per il progetto Google Cloud associato.
1. Crea un file JSON contenente 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 del principal a cui stai concedendo 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, 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.
6. Se il tuo progetto fa parte di un'organizzazione che utilizza vincoli personalizzati, controlla le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.
(Facoltativo) Configura le impostazioni per il progetto.

Configura Gemini Cloud Assist per una cartella

I seguenti passaggi descrivono in dettaglio 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.

Abilita le API richieste e consigliate.
1. Vai alla pagina Amministrazione di Gemini.
  
  Vai ad Amministrazione per 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 all'interno di una cartella, seleziona la freccia di espansione 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 quelle consigliate selezionate per tutti i progetti nella cartella. Se vuoi eccezioni per alcuni progetti nella cartella, puoi bloccare l'attivazione dell'API impostando un vincolo dei criteri dell'organizzazione Limita utilizzo di Service Usage per questi progetti. Per saperne di più, consulta Limitazione dell'utilizzo delle risorse.
Concedi i seguenti ruoli IAM o crea ruoli personalizzati con autorizzazioni equivalenti nella cartella:
- Utente Gemini Cloud Assist
- Visualizzatore di asset cloud
Se l'entità vuole ricevere assistenza per prodotti a cui non ha ancora 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.
Se la tua cartella fa parte di un'organizzazione che utilizza vincoli personalizzati, rivedi le autorizzazioni richieste per la chat per assicurarti che la chat di Gemini Cloud Assist non sia bloccata.
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 Amministrazione di 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 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 IAM e amministrazione viene aggiornata al termine dell'attivazione dell'API.
5. Seleziona Gestisci fatturazione.
  
  Viene visualizzata la pagina Account collegato.
6. Seleziona un account di fatturazione dall'elenco e poi seleziona Imposta account.
Concedi i ruoli IAM che hai concesso alla cartella nel passaggio 2 oppure 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 di Gemini.
  
  Vai ad Amministrazione per 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.
(Facoltativo) Configura le impostazioni per i progetti nella cartella.

Passaggi successivi

Scopri di più sui prezzi di Gemini Cloud Assist.
Scopri come utilizzare il riquadro Cloud Assist nella Google Cloud console.
Scopri come configurare impostazioni aggiuntive per Gemini Cloud Assist.