Configurar o Duet AI para desenvolvedores para um projeto

Antes de usar a Duet AI para desenvolvedores em produtos com suporte do Google Cloud, sua equipe precisa realizar as etapas descritas neste documento:

  1. Compre uma assinatura de uma ou mais ofertas de produtos da Duet AI.

  2. Ative a Duet AI em um projeto do Google Cloud. Essa etapa geralmente é executada por um administrador.

  3. Se você quiser usar a Duet AI em um ambiente de desenvolvimento integrado, instale o plug-in do Cloud Code.

Comprar uma assinatura da Duet AI

Se você estiver usando apenas a Duet AI para BigQuery, Spanner ou Colab Enterprise, pule esta seção.

A Duet AI para Desenvolvedores está disponível para teste sem uma assinatura até 11 de maio de 2024, limitado a um usuário por conta de faturamento. Organizações com vários usuários por conta de faturamento precisam comprar uma assinatura, conforme descrito nesta seção. Se você tiver contratos com o Google Cloud, entre em contato com nossa equipe de vendas antes de comprar uma assinatura.

  1. No console do Google Cloud, acesse a página Administrador da Duet AI.

    Acesse Administrador da Duet AI

  2. Leia e confirme a mensagem Antes de começar.

  3. Se você não tiver uma assinatura para essa conta de faturamento, a página da promoção vai aparecer. Clique em Começar a usar a Duet AI.

  4. Se solicitado, selecione uma conta de faturamento e clique em Continuar página de administrador da Duet AI.

  5. Na página Assinaturas, clique em Comprar nova assinatura.

  6. Preencha os campos para Configurar assinatura, incluindo um nome opcional para a assinatura, o prazo do compromisso (mensal ou anual) e o número de licenças na assinatura.

    Escolha se você quer renovar automaticamente sua assinatura após o prazo do compromisso (mensal ou anual). Isso mantém sua assinatura e licenças ativas. Se a assinatura não for renovada automaticamente, ela terminará quando o período atual terminar, e você precisará passar pelo processo de compra novamente para recuperar as licenças.

  7. Clique em Continuar para revisar os detalhes da assinatura. Leia e concorde com os termos de compra.

  8. Clique em Concluir compra e confirme sua assinatura.

O faturamento está ativado para a Duet AI. Em seguida, ative a Duet AI em um ou mais projetos associados a esta conta de faturamento. A Duet AI não será mostrada aos usuários até que você a ative em pelo menos um projeto

Ativar a Duet AI em um projeto do Google Cloud

Para ativar a Duet AI em um projeto do Google Cloud, um administrador precisa ativar a API Cloud AI Companion e conceder aos usuários os papéis de usuário complementar do Cloud AI e de leitor do Service Usage.

Console

  1. Para ativar a API, acesse a página API Cloud AI Companion no console do Google Cloud.

    Acesse API Cloud AI Companion

  2. No seletor de projetos, escolha um projeto.

  3. Selecione Ativar.

    A página é atualizada e mostra o status Ativada. A Duet AI agora está disponível no projeto selecionado do Google Cloud para todos os usuários que têm os papéis do IAM necessários.

  4. Para conceder os papéis do IAM necessários para usar a Duet AI, acesse a página IAM.

    Acessar IAM

  5. Na coluna Principal, encontre uma principal para a qual você quer ativar o acesso à Duet AI e clique em Editar principal nessa linha.

  6. No painel Acesso para editar, clique em Adicionar outro papel.

  7. Em Selecionar papel, escolha Usuário do Cloud AI Companion.

  8. Clique em Adicionar outro papel e selecione Visualizador do Service Usage.

  9. Clique em Save.

gcloud

  1. No Console do Google Cloud, ative o Cloud Shell.

    Ativar o Cloud Shell

  2. Na lista suspensa do seletor de projetos, escolha um projeto.

  3. Ative a API Companion do Cloud AI para a Duet AI usando o comando gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com
    

    Se você quiser ativar a API Cloud AI Companion para um projeto diferente do Google Cloud, adicione o parâmetro --project:

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

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

    O resultado será assim:

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

    A Duet AI agora está disponível no projeto especificado do Google Cloud para todos os usuários que têm os papéis do IAM necessários.

  4. Conceda os dois papéis do IAM necessários para usar a Duet AI:

    1. Conceda o papel de usuário do Cloud AI Companion:

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

      Substitua PRINCIPAL pelo identificador do principal. O identificador tem o formato user|group|serviceAccount:email ou domain:domain, por exemplo, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com ou domain:example.domain.com.

      A saída é uma lista de vinculações de política que inclui o seguinte:

      - members:
        - user:PRINCIPAL
        role: roles/cloudaicompanion.user
      
    2. Conceda o papel de Leitor do Service Usage:

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

      A saída é uma lista de vinculações de política que inclui o seguinte:

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

    Para mais informações, consulte Conceder um único papel e gcloud projects add-iam-policy-binding.

Todos os usuários que receberam esses papéis podem acessar os recursos da Duet AI no console do Google Cloud dentro do projeto especificado. Para mais informações, consulte Visão geral da Duet AI no Google Cloud.

Usar a Duet AI em um ambiente de desenvolvimento integrado

Se você for um desenvolvedor que quer usar a Duet AI no seu ambiente de desenvolvimento integrado, instale o plug-in do Cloud Code. Para ver mais informações, consulte os tópicos a seguir:

Tarefas de configuração avançada

Em vez de usar o console do Google Cloud ou a CLI gcloud para conceder papéis predefinidos do IAM, você pode fazer o seguinte:

A seguir