Questa pagina è stata tradotta dall'API Cloud Translation.

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 Google Cloud console o utilizzando Google Cloud CLI.

Console

Vai alla pagina Amministrazione di Gemini.

Vai a Gemini per Google Cloud
Nel selettore dei 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 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.
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 Ente, individua un'entità per la quale 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

In the Google Cloud console, activate Cloud Shell.

Activate 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, obbligatoria anche per l'utilizzo di 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
```
L'output è simile al seguente:
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```
Concedi 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 quanto segue:
  - PROJECT_ID: l'ID del tuo Google Cloud progetto,ad esempio1234567890.
  - PRINCIPAL: l'identificatore del principale, ad esempio user:cloudysanfrancisco@gmail.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.

API

Queste istruzioni utilizzano cURL per chiamare i metodi dell'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 cui stai attivando Gemini Cloud Assist.

Se il comando va a buon fine, 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, obbligatorio per utilizzare Gemini Cloud Assist.
Concedi i ruoli IAM per il Google Cloud progetto associato.
1. Crea un file JSON contenente le seguenti informazioni:
```
  {
    "options": {
      "requestedPolicyVersion": 3
    }
  }
```
2. Recupera il criterio 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 creato nel passaggio precedente.
  - PROJECT_ID: l'ID del progetto.
  In caso di esito positivo, la risposta restituisce il criterio IAM del progetto.
3. Copia il criterio IAM del progetto in un file JSON vuoto e aggiungi le seguenti informazioni ai contenuti esistenti:
```
  {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/recommender.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }
```
  Sostituisci PRINCIPAL con l'identificatore dell'entità a cui stai concedendo l'accesso a Gemini Cloud Assist.
4. Applica il criterio IAM aggiornato 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 creato nel passaggio precedente.
  - PROJECT_ID: l'ID del progetto.
  In caso di esito positivo, la risposta restituisce il criterio IAM aggiornato del progetto.
Se l'entità vuole ricevere assistenza per i prodotti a cui non ha già accesso, potrebbe essere necessario concederle ulteriori ruoli IAM. 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.