Configurar o Gemini Code Assist

Observação: o Gemini Code Assist está disponível para teste sem custo financeiro até 8 de novembro de 2024, limitado a um usuário por conta de faturamento. As organizações podem comprar uma licença neste link.

Antes de usar o Gemini Code Assist, sua equipe precisa realizar 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 financeiros até 8 de novembro de 2024, limitado a um usuário por conta de faturamento.

2. Ativar a API Cloud AI Companion em um projeto do Google Cloud Geralmente, essa etapa é realizada por um administrador.

3. Conceder papéis do Identity and Access Management (IAM) em um projeto do Google Cloud. Geralmente, essa etapa é realizada por um administrador.

4. 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 custo financeiro até 8 de novembro 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 atuais 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 roles/billing.admin do IAM. Também é possível adicionar a permissão a um papel personalizado.

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

   Acessar o Gemini para Google Cloud

   A página Gemini para Google Cloud será aberta.

2. Selecione Gemini Code Assist.

   O painel Gemini Code Assist vai aparecer.

3. Clique em Instalar o Gemini Code Assist.

4. Se solicitado, selecione uma conta de faturamento e clique em Ir para a página Administrador do Gemini.

   A página Compre uma assinatura do Gemini Code Assist é aberta.

5. 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 sua assinatura automaticamente após o termo do compromisso (mensal ou anual). A renovação automática mantém a assinatura e as licenças ativas. Se a assinatura não for renovada automaticamente, ela vai terminar quando o prazo atual terminar, e você precisará passar pelo processo de compra novamente para recuperar as licenças.

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

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

O faturamento está ativado para o Gemini. Agora você precisa ativar a API Cloud AI Companion em um ou mais projetos associados a essa conta de faturamento. Os usuários não vão ter acesso ao Gemini até que você o ative em pelo menos um projeto.

Ativar a API Cloud AI Companion em um projeto do Google Cloud

Nesta seção, descrevemos as etapas necessárias para ativar a API Cloud AI Companion em um projeto do Google Cloud.

Console

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

   Acessar o Gemini para Google Cloud

2. No seletor de projetos, escolha um projeto.

3. Selecione Ativar.

   A página é atualizada e mostra o status Ativado. 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.

gcloud

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

   Ativar o Cloud Shell

2. No menu do seletor de projetos, escolha um projeto.

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

   gcloud services enable cloudaicompanion.googleapis.com
   

   Se você quiser ativar a API Cloud AI Companion em 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 para Google Cloud 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.

Conceder papéis de IAM em um projeto do Google Cloud

Nesta seção, descrevemos as etapas necessárias para conceder aos usuários os papéis do IAM de usuário e consumidor do Service Usage do Cloud AI Companion.

Console

1. Para conceder os papéis de IAM necessários para usar o Gemini, acesse a página IAM e administrador.

   Acessar IAM e administrador

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

3. No painel Editar acesso, clique em Adicionar outro papel.

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

5. Clique em Adicionar outro papel e selecione Consumidor do Service Usage.

6. Clique em Salvar.

gcloud

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

   Ativar o Cloud Shell

2. No menu do seletor de projetos, escolha um projeto.

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

4. Conceda o papel Consumidor do Service Usage:

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

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

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

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 para Google Cloud no console do Google Cloud dentro do projeto especificado. Para saber mais, consulte Visão geral do Gemini para Google Cloud.

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

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

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

Tarefas de configuração avançadas

Em vez de usar o console do Google Cloud ou a CLI gcloud para conceder papéis de IAM predefinidos, é possível 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 de funções totalmente qualificados:

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

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

A seguir

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