Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configura Gemini Cloud Assist

Prima di poter utilizzare Gemini Cloud Assist, l' 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 seguenti passaggi descrivono in dettaglio come configurare Gemini Cloud Assist per un progetto.

Console

Vai alla pagina Amministrazione per Gemini.

Vai a Gemini in Google Cloud
Seleziona la risorsa del progetto dal selettore di progetti nella parte superiore della pagina.
Seleziona Abilita Gemini Cloud Assist.
Nella finestra di dialogo Abilita 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 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.
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 Gemini Cloud Assist User.
5. Fai clic su Aggiungi un altro ruolo e seleziona Visualizzatore asset cloud.
6. Se l'entità vuole ricevere assistenza per i prodotti a cui non ha ancora accesso, potrebbe essere necessario concedere ruoli IAM aggiuntivi facendo clic su Aggiungi un altro ruolo e selezionando ruoli aggiuntivi. Per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti, consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist.
7. Se il tuo progetto 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.
(Facoltativo) Configura le impostazioni per il progetto.

gcloud

Nella Google Cloud console, attiva Cloud Shell.

Attiva Cloud Shell
Abilita l'API Gemini Cloud Assist utilizzando il gcloud services enable comando:
```
gcloud services enable geminicloudassist.googleapis.com
```
Questo passaggio abilita anche l'API Gemini for Google Cloud, necessaria per utilizzare Gemini Cloud Assist.

Se vuoi abilitare l'API Gemini Cloud Assist in un altro Google Cloud progetto, aggiungi il --project parametro:
```
gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
```
Sostituisci PROJECT_ID con l'ID del progetto per cui 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.
```
Abilita le altre API richieste utilizzando il gcloud services enable comando 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
```
Importante: se il tuo progetto è contenuto all'interno di un perimetro di servizio dei Controlli di servizio VPC, escludi appoptimize.googleapis.com dal comando perché l'API App Optimize non è supportata dai Controlli di servizio VPC.
(Facoltativo) Abilita le API consigliate utilizzando il gcloud services enable comando come hai fatto per abilitare l'API Gemini Cloud Assist.
Concedi i ruoli IAM in un Google Cloud progetto. 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 dell' entità, 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 i prodotti a cui non ha ancora accesso, potrebbe essere necessario concedere ruoli IAM aggiuntivi. Per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti, consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist.
4. Se il tuo progetto 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.
(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 services.enable metodo:
```
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 cui 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 field per controllare lo stato dell'operazione.

Nota: l'abilitazione del servizio geminicloudassist.googleapis.com abilita 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
- apphub.googleapis.com
Importante: se il tuo progetto è contenuto all'interno di un perimetro di servizio dei Controlli di servizio VPC, escludi appoptimize.googleapis.com dal gruppo di API abilitate perché l'API App Optimize non è supportata dai Controlli di servizio VPC.
(Facoltativo) Abilita le API consigliate utilizzando il metodo services.enable come hai fatto per abilitare l'API Gemini Cloud Assist.
Concedi i ruoli IAM per il progetto associato Google Cloud .
1. Crea un file JSON contenente le seguenti informazioni:
```
  {
    "options": {
      "requestedPolicyVersion": 3
    }
  }
```
2. Recupera la policy IAM esistente per il progetto utilizzando il projects.getIamPolicy metodo:
```
  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.
  Se l'operazione ha 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 stai concedendo l'accesso a Gemini Cloud Assist.
4. Applica la policy IAM aggiornata al progetto utilizzando il projects.setIamPolicy metodo:
```
  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.
  Se l'operazione ha esito positivo, la risposta restituisce la policy IAM aggiornata del progetto.
5. Se l'entità vuole ricevere assistenza per i prodotti a cui non ha ancora accesso, potrebbe essere necessario concedere ruoli IAM aggiuntivi. Per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti, consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist.
6. Se il tuo progetto 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.
(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 Google Cloud console. 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 per Gemini.
  
  Vai ad Amministrazione per Gemini
2. Seleziona la risorsa della cartella dal selettore di progetti nella parte superiore della pagina.
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 nella sezione API obbligatorie e consigliate.
5. Nell'elenco API consigliate, seleziona le API facoltative che vuoi abilitare.
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 consigliate selezionate per tutti i progetti nella cartella. Se vuoi delle eccezioni per alcuni progetti nella cartella, puoi bloccare l'abilitazione dell'API impostando un Limita utilizzo servizi delle risorse vincolo della policy dell'organizzazione su questi progetti. Per ulteriori informazioni, consulta Limitare l'utilizzo delle risorse.
Concedi i seguenti ruoli IAM o crea ruoli personalizzati con autorizzazioni equivalenti nella cartella:
- Gemini Cloud Assist User
- Visualizzatore asset cloud
Se l'entità vuole ricevere assistenza per i prodotti a cui non ha ancora accesso, potrebbe essere necessario concedere ruoli IAM aggiuntivi. Per una tabella dei ruoli IAM che consentono un'esperienza ottimale di Gemini Cloud Assist per diversi prodotti, consulta Requisiti IAM per l'utilizzo di Gemini Cloud Assist.
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.
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 per Gemini.
  
  Vai ad Amministrazione per Gemini
2. Seleziona Abilita gestione app.
  
  Viene visualizzata la pagina delle impostazioni IAM e amministrazione.
3. Seleziona Abilita nella sezione Abilitazione app della pagina.
  
  Viene visualizzata la finestra di dialogo Abilita le API dell'applicazione in questa cartella.
4. Seleziona Abilita.
  
  Una barra di stato mostra l'avanzamento dell'abilitazione dell'API. La pagina delle impostazioni 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.
Concedi i ruoli IAM che hai concesso alla cartella nel passaggio 2 oppure crea ruoli personalizzati con autorizzazioni equivalenti per il 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. Seleziona la risorsa della cartella dal selettore di progetti nella parte superiore della pagina.
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.