Configurare Duet AI per gli sviluppatori per un progetto

Prima di poter utilizzare Duet AI per gli sviluppatori nei prodotti Google Cloud supportati, il tuo team deve eseguire i passaggi descritti in questo documento:

  1. Acquista un abbonamento a una o più offerte di prodotti Duet AI.

  2. Attiva Duet AI in un progetto Google Cloud. In genere questo passaggio viene eseguito da un amministratore.

  3. Se vuoi utilizzare Duet AI in un IDE, installa il plug-in Cloud Code.

Acquistare un abbonamento a Duet AI

Se utilizzi Duet AI solo per BigQuery, Spanner o Colab Enterprise, puoi saltare questa sezione.

Duet AI per gli sviluppatori è disponibile per la prova senza abbonamento senza costi fino all'11 maggio 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à contratti con Google Cloud, contatta il nostro team di vendita prima di acquistare un abbonamento.

  1. Nella console Google Cloud, vai alla pagina Amministratore Duet AI.

    Vai a Amministratore Duet AI

  2. Leggi e accetta il messaggio Prima di iniziare.

  3. Se non disponi di un abbonamento esistente per questo account di fatturazione, viene visualizzata la pagina della promozione. Fai clic su Inizia a utilizzare Duet AI.

  4. Se richiesto, seleziona un account di fatturazione e fai clic su Continua la pagina Amministratore di Duet AI.

  5. Nella pagina Abbonamenti, fai clic su Acquista nuovo abbonamento.

  6. Completa i campi per Configura abbonamento, tra cui un nome facoltativo per l'abbonamento, la durata dell'impegno (mensile o annuale) e il numero di licenze nell'abbonamento.

    Scegli se vuoi rinnovare automaticamente l'abbonamento una volta trascorso il periodo dell'impegno (mensile o annuale). In questo modo, l'abbonamento e le licenze rimangono attivi. Se l'abbonamento non si rinnova automaticamente, termina allo scadere del periodo corrente e dovrai ripetere la procedura di acquisto per riacquisire le licenze.

  7. Fai clic su Continua per rivedere i dettagli dell'abbonamento. Leggi e accetta i termini di acquisto.

  8. Fai clic su Completa l'acquisto e conferma l'abbonamento.

La fatturazione è ora abilitata per Duet AI. Quindi, attiva Duet AI in uno o più progetti associati a questo account di fatturazione. Gli utenti vedranno Duet AI solo dopo che lo avrai attivato in almeno un progetto

Attiva Duet AI in un progetto Google Cloud

Per attivare Duet AI in un progetto Google Cloud, un amministratore deve abilitare l'API Cloud AI Companion e concedere gli utenti Cloud AI Companion e i ruoli Identity and Access Management (IAM) Visualizzatore utilizzo del servizio agli utenti.

Console

  1. Per abilitare l'API, vai alla pagina API Cloud AI Companion nella console Google Cloud.

    Vai all'API Cloud AI Companion

  2. Nel selettore dei progetti, seleziona un progetto.

  3. Fai clic su Abilita.

    La pagina viene aggiornata e mostra lo stato Attivata. Duet AI è ora disponibile nel progetto Google Cloud selezionato per tutti gli utenti che dispongono dei ruoli IAM richiesti.

  4. Per concedere i ruoli IAM necessari per utilizzare Duet AI, vai alla pagina IAM.

    Vai a IAM

  5. Nella colonna Entità, trova un'entità per la quale vuoi abilitare l'accesso a Duet AI, quindi fai clic su Modifica entità in quella riga.

  6. Nel riquadro Modifica accesso, fai clic su Aggiungi un altro ruolo.

  7. In Seleziona un ruolo, scegli Utente Cloud AI Companion.

  8. Fai clic su Aggiungi un altro ruolo e seleziona Visualizzatore Service Usage.

  9. Fai clic su Salva.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

  2. Nell'elenco a discesa del selettore dei progetti, seleziona un progetto.

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

    gcloud services enable cloudaicompanion.googleapis.com
    

    Se vuoi abilitare l'API Cloud AI Companion per un altro progetto Google Cloud, aggiungi il parametro --project:

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

    Sostituisci PROJECT_ID con l'ID progetto Google Cloud.

    L'output è simile al seguente:

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

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

  4. Concedi i due ruoli IAM richiesti per usare Duet AI:

    1. 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 dell'entità. L'identificatore ha il formato user|group|serviceAccount:email o domain:domain, 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
      
    2. Concedi il ruolo Visualizzatore utilizzo dei servizi:

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

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

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

    Per saperne di più, vedi Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti a cui sono stati concessi questi ruoli possono accedere alle funzionalità di Duet AI nella console Google Cloud all'interno del progetto specificato. Per saperne di più, consulta la panoramica di Duet AI in Google Cloud.

Utilizza Duet AI in un IDE

Se sei uno sviluppatore e vuoi utilizzare Duet AI nel tuo IDE, devi installare il plug-in Cloud Code. Per ulteriori informazioni, consulta quanto segue:

Attività di configurazione avanzate

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

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

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

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageViewer

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

  • Creare e concedere ruoli personalizzati.

    Tutti i ruoli personalizzati che crei richiedono le seguenti autorizzazioni per accedere a Duet AI:

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

Passaggi successivi