Configurar o Gemini Code Assist para um projeto

Observação: o Gemini Code Assist está disponível para teste sem custos até 11 de julho de 2024, limitado a um usuário por conta de faturamento. As organizações podem comprar uma licença aqui.

Antes de usar o Gemini Code Assist, sua equipe precisa executar as etapas de configuração descritas neste documento:

1. Opcional: compre uma assinatura do Gemini Code Assist. O Gemini Code Assist está disponível para teste sem custos até 11 de julho de 2024, limitado a um usuário por conta de faturamento.

2. Ativar o Gemini Code Assist em um projeto do Google Cloud. Geralmente, um administrador realiza essa etapa.

3. Opcional: para usar o Gemini Code Assist em um ambiente de desenvolvimento integrado, instale o plug-in do Cloud Code.

Opcional: comprar uma assinatura do Gemini Code Assist

O Gemini Code Assist está disponível para teste sem uma assinatura até 11 de julho 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.

Observação :você precisa ter a permissão billing.subscriptions.create Identity and Access Management (IAM) para comprar uma assinatura do Gemini. A permissão billing.subscriptions.create está incluída no papel do IAM roles/billing.admin, ou é possível adicioná-la a um papel personalizado.

1. No console do Google Cloud, acesse a página Gemini para o Google Cloud.

   Acesse o Gemini para o Google Cloud

2. Clique em Primeiros passos no Gemini.

3. Caso seja solicitado, selecione uma conta de faturamento e clique em Continuar para a página Administrador do Gemini.

4. Em Configurar assinatura, preencha os campos para configurar a assinatura, incluindo o prazo do compromisso (mensal ou anual) e o número de licenças na assinatura.

   Observação: uma assinatura anual cobra o preço anual com desconto todos os meses, em vez de um pagamento único.

   Escolha se você quer renovar automaticamente sua assinatura após o prazo do compromisso (mensal ou anual). A renovação automática 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 será necessário passar pelo processo de compra novamente para recuperar as licenças.

5. Para revisar os detalhes da assinatura, clique em Continuar.

6. Se você concordar com os termos, clique em Concluir compra e confirme sua assinatura.

O faturamento está ativado para o Gemini. Agora você precisa ativar o Gemini Code Assist em um ou mais projetos associados a esta conta de faturamento. Os usuários não verão o Gemini até que ele seja ativado em pelo menos um projeto.

Ativar o Gemini Code Assist em um projeto do Google Cloud

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

Console

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

   Acesse o Gemini para o Google Cloud

2. No seletor de projetos, escolha um projeto.

3. Selecione Ativar.

   A página é atualizada e mostra o status Ativada. O Gemini 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 de IAM necessários para usar o Gemini, acesse a página IAM e administrador.

   Acessar IAM e administrador

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

6. No painel Editar acesso, 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 Salvar.

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 Gemini 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.
   

   O Gemini 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 o Gemini:

   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:[e-mail], group:[e-mail], serviceAccount:[e-mail] 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 do Gemini no console do Google Cloud dentro do projeto especificado. Para mais informações, consulte Usar o Gemini para assistência e desenvolvimento de IA.

Opcional: usar o Gemini Code Assist em um ambiente de desenvolvimento integrado

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

• Cloud Workstations: programar com Gemini Code Assist
• Editor do Cloud Shell: Código com Gemini Code Assist
• Cloud Code para VS Code: Code with Gemini Code Assist
• Cloud Code para IntelliJ e outros ambientes de desenvolvimento integrado do JetBrains: código com o Gemini Code Assist

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:

• Use as APIs REST do IAM ou as bibliotecas de cliente do IAM para conceder papéis.

  Se você usar essas interfaces, use os nomes dos papéis totalmente qualificados:

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

  Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

• Criar e conceder papéis personalizados.

  Todos os papéis personalizados que você criar precisam das seguintes permissões para acessar o Gemini:

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

A seguir

• Saiba mais sobre os tipos de assistência de IA generativa disponíveis no Gemini para o Google Cloud.
• Saiba como o Gemini para o Google Cloud usa seus dados.
• Saiba como acessar e gerenciar os controles de administrador do Gemini.