Configura Gemini Code Assist

Prima di poter utilizzare Gemini Code Assist, il tuo team ha bisogno per eseguire la procedura di configurazione descritta in questo documento:

  1. (Facoltativo) Acquista un abbonamento a Gemini Code Assist. È possibile provare Gemini Code Assist senza costi fino al 8 novembre 2024, limitato a un utente per account di fatturazione.

  2. Abilita l'API Cloud AI Companion in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.

  3. Concedi i ruoli IAM (Identity and Access Management) in un progetto Google Cloud. Di solito questo passaggio viene eseguito da un amministratore.

  4. (Facoltativo) Per usa Gemini Code Assist in un IDE, installare il plug-in Cloud Code.

(Facoltativo) Acquista un abbonamento a Gemini in Code Assist

È possibile provare Gemini Code Assist senza abbonamento all'indirizzo senza costi fino all'8 novembre 2024, con un limite di un utente per account di fatturazione. Le organizzazioni con più utenti per account di fatturazione devono acquistare un abbonamento, come descritto in questa sezione. Se hai già dei contratti con Google Cloud, contatta il nostro team di vendita prima di acquistare un abbonamento.

  1. Nella console Google Cloud, vai alla pagina Gemini per Google Cloud.

    Vai a Gemini per Google Cloud

    Si apre la pagina Gemini per Google Cloud.

  2. Seleziona Gemini Code Assist.

    Viene visualizzato il riquadro Gemini Code Assist.

  3. Fai clic su Ottieni Gemini Code Assist.

  4. Se richiesto, seleziona un account di fatturazione e fai clic su Vai alla pagina Amministrazione per Gemini.

    Si apre la pagina Acquista abbonamento a Gemini in Code Assist.

  5. In Configura abbonamento, completa i campi per configurare abbonamento, inclusi il periodo dell'impegno (mensile o annuale) e di licenze incluse nell'abbonamento.

    Scegli se vuoi rinnovare automaticamente l'abbonamento dopo il (mensile o annuale). Il rinnovo automatico mantiene il tuo abbonamento licenze attive. Se l'abbonamento non si rinnova automaticamente, termina quando termina il periodo attuale e dovrai completare la procedura di acquisto di nuovo per recuperare le licenze.

  6. Per rivedere i dettagli dell'abbonamento, fai clic su Continua.

  7. Se accetti i termini, fai clic su Completa acquisto, quindi conferma abbonamento.

Ora la fatturazione è abilitata per Gemini. Ora devi abilita l'API Cloud AI Companion in uno o più progetti associati a questo account di fatturazione. Utenti non vedrà Gemini finché non lo attivi in almeno uno progetto.

Abilita l'API Cloud AI Companion in un progetto Google Cloud

In questa sezione vengono descritti i passaggi necessari per attivare il API Cloud AI Companion in un progetto Google Cloud.

Console

  1. Per abilitare l'API Cloud AI Companion, vai alla sezione Gemini per Google Cloud.

    Vai a Gemini per Google Cloud

  2. Nel selettore di progetti, seleziona un progetto.

  3. Fai clic su Attiva.

    La pagina si aggiorna e mostra lo stato Attivato. Gemini è ora disponibile nel un progetto Google Cloud a tutti gli utenti che dispongono dei requisiti i ruoli IAM.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

  2. Seleziona un progetto nel menu del selettore dei progetti.

  3. Abilita l'API Cloud AI Companion per Gemini utilizzando Il comando gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com

    Se vuoi abilitare l'API Cloud AI Companion in un'altra progetto Google Cloud, aggiungi Parametro --project:

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

    Sostituisci PROJECT_ID con il tuo progetto Google Cloud ID.

    L'output è simile al seguente:

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

Gemini per Google Cloud è ora disponibile nel progetto Google Cloud specificato per tutti utenti che hanno i ruoli IAM richiesti.

Concedi ruoli IAM in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per concedere all'utente Cloud AI Companion i ruoli IAM consumer per l'utilizzo di servizi e Service Usage.

Console

  1. per concedere i ruoli IAM richiesti da utilizzare Gemini, vai alla sezione IAM e Console di amministrazione.

    Vai a IAM e Amministratore

  2. Nella colonna Entità, trova un elemento principal per il quale hai vuoi abilitare l'accesso a Gemini, quindi 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 Cloud AI Companion.

  5. Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer (Consumatore di Service Usage).

  6. Fai clic su Salva.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

  2. Seleziona un progetto nel menu del selettore dei progetti.

  3. Concedi il ruolo Utente Cloud AI Companion:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    Sostituisci PRINCIPAL con l'identificatore di l'entità. L'identificatore assume la forma user|group|serviceAccount:email o domain:domain, per 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/cloudaicompanion.user

  4. Concedi il ruolo Consumer utilizzo dei servizi:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

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

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

Per ulteriori informazioni, vedi Assegna un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere a Gemini per Google Cloud disponibili nella console Google Cloud all'interno del progetto specificato. Per ulteriori informazioni le informazioni, vedi Panoramica di Gemini per Google Cloud.

(Facoltativo) Usa Gemini Code Assist in un IDE

Se sei uno sviluppatore e vuoi usare Gemini nel tuo IDE, devi installare il plug-in Cloud Code. Per ulteriori informazioni, vedi le seguenti:

Attività di configurazione avanzata

Anziché utilizzare la console Google Cloud o gcloud CLI concedere ruoli IAM predefiniti, puoi eseguire una delle seguenti operazioni:

  • Utilizzare le API REST IAM o librerie client IAM per concedere i ruoli.

    Se utilizzi queste interfacce, utilizza i nomi completi dei ruoli:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

  • Creare e concedere ruoli personalizzati.

    Eventuali ruoli personalizzati che crei devono le seguenti autorizzazioni per accedere a Gemini:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • serviceusage.services.use

Passaggi successivi