Configurar o Gemini Code Assist

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

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

1. Opcional: Comprar uma assinatura do Gemini Code Assist. O Gemini Code Assist está disponível para teste sem custos 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, instalar o plug-in do Cloud Code.

Opcional: comprar uma assinatura do Gemini Code Assist

O Gemini Code Assist está disponível para teste sem assinatura em 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 um conforme descrito nesta seção. Se você já tiver contratos com Google Cloud, entre em contato com nossa equipe de vendas antes de comprar um assinatura.

Observação: é necessário ter o billing.subscriptions.create do Identity and Access Management (IAM) para comprar um assinatura do Gemini. O billing.subscriptions.create está incluída no arquivo Papel do IAM roles/billing.admin, ou 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 Prosseguir para a página "Administrador no Gemini".

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

5. Em Configurar assinatura, preencha os campos para configurar o incluindo o prazo do compromisso (mensal ou anual) e o 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 fazer um pagamento único.

   Escolha se você quer renovar sua assinatura automaticamente após o prazo de 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 vai terminar quando o período atual termina, e você precisa passar pelo processo de compra novamente para recuperá-las.

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

7. 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 a API Cloud AI Companion em um ou mais projetos associados a esta conta de faturamento. Usuários não vai 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

Esta seção descreve as etapas necessárias para ativar o API Cloud AI Companion em um projeto do Google Cloud.

Console

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

   Acessar o Gemini para Google Cloud

2. No seletor de projetos, escolha um projeto.

3. Clique em Ativar.

   A página é atualizada e mostra o status Ativado. O Gemini já está disponível nas edições selecionadas projeto do Google Cloud a todos os usuários que tenham os papéis do IAM.

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. Ativar 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 uma projeto 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 para todos no projeto especificado do Google Cloud 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 ao usuário do Cloud AI Companion e de consumidor do Service Usage e do IAM aos usuários.

Console

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

   Acessar IAM e administrador

2. Na coluna Principal, encontre a principal que você quer ativar o acesso ao Gemini e clicar em Edite o 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 o Gemini para Google Cloud recursos no console do Google Cloud no projeto especificado. Para mais informações, consulte Informações gerais do Gemini para Google Cloud.

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

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

• Cloud Workstations: Programar com o Gemini Code Assist
• Editor do Cloud Shell: Programar com o Gemini Code Assist
• Cloud Code para VS Code: Programar com o 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çada

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

• Use as APIs REST do IAM. ou 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 da as seguintes permissões para acessar o Gemini:

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

A seguir

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