Configurar o Gemini Code Assist

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

  1. Compre uma assinatura do Gemini Code Assist.

  2. Atribuir licenças a usuários específicos da sua organização.

  3. Ative a API Gemini para o Google Cloud em um projeto do Google Cloud.

  4. Conceda papéis do Identity and Access Management (IAM) em um projeto do Google Cloud.

  5. Os usuários da sua organização instalam o plug-in Gemini Code Assist para usar o Gemini Code Assist em um ambiente de desenvolvimento integrado.

Comprar uma assinatura do Gemini Code Assist

Para conferir uma lista de recursos disponíveis em cada edição, consulte Recursos compatíveis.

O Gemini Code Assist Enterprise está disponível por USD 19 por mês por usuário com compromisso de 12 meses até 31 de março de 2025. Entre em contato com nossa equipe de vendas para aproveitar essa oferta promocional.

Se você já tem contratos com o Google Cloud, entre em contato com nossa equipe de vendas antes de comprar uma assinatura.

Observação: é necessário ter a permissão consumerprocurement.orders.place do Identity and Access Management (IAM) para comprar uma assinatura do Gemini. A permissão consumerprocurement.orders.place está incluída no papel do IAM roles/billing.admin ou no papel roles/consumerprocurement.orderAdmin. Também é possível adicionar a permissão a um papel personalizado.

  1. Acesse a página Gemini para Google Cloud.

    Acesse o Gemini para Google Cloud

    A página Gemini para Google Cloud é aberta.

  2. Selecione Receber o Gemini Code Assist. Se o projeto já tiver o Gemini Code Assist, o texto Gerenciar o Gemini Code Assist vai aparecer.

    A página Assinar o Gemini Code Assist é aberta.

  3. Em Selecionar a edição da assinatura do Gemini Code Assist, escolha uma edição do Gemini Code Assist. Selecione Compare as edições do Gemini Code Assist para conferir uma lista detalhada dos recursos disponíveis em cada edição.

    Em seguida, selecione Continuar.

  4. Em Configurar assinatura, preencha os campos para configurar a assinatura, incluindo o seguinte:

    • Nome da assinatura.
    • Número de licenças na assinatura. Se você estiver comprando a edição Enterprise, precisará comprar pelo menos 10 licenças.
    • Período de assinatura (mensal ou anual). Com uma assinatura anual, você recebe uma taxa com desconto que é cobrada mensalmente em vez de um pagamento único.
    • A renovação automática da assinatura após o término do período 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 será encerrada quando o período atual terminar, e você precisará passar pelo processo de compra novamente e reatribuir as licenças.

  5. Para confirmar a assinatura, selecione Continuar.

  6. Se você concordar com os termos, selecione I agree to the terms of this purchase e Confirm subscription.

  7. Selecione Próxima: gerenciar atribuições de licenças do Gemini.

A assinatura do Gemini Code Assist foi comprada. Agora, você precisa gerenciar as atribuições de licença do Gemini na sua organização.

Atribuir licenças

Antes de usar o Gemini Code Assist, cada usuário individual na sua organização precisa de uma licença.

Console

Para atribuir licenças do Gemini a usuários individuais no console do Google Cloud, você precisa ter as seguintes permissões:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. Acesse a página Administrador do Gemini.

    Acessar a página "Administrador do Gemini"

  2. Escolha a assinatura que você quer mudar e clique em Modificar assinatura.

  3. Clique em Atribuir licenças. Uma caixa de diálogo de seleção do usuário aparece. Para pesquisar usuários específicos, digite o nome deles na caixa de pesquisa.

  4. Selecione um ou mais usuários na lista e clique em Próxima.

  5. Escolha os serviços do Gemini para os quais você quer atribuir licenças.

  6. Clique em Atribuir licenças.

API

Para atribuir licenças do Gemini com a API, você precisa ter a permissão consumerprocurement.licensePools.assign.

Método HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Substitua:

  • BILLING_ACCOUNT_ID: o ID da conta de faturamento
  • ORDER_ID: a política do IAM

Corpo da solicitação:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

O resultado será assim:

{}

A resposta vai estar vazia se a licença for atribuída.

Agora, você precisa ativar a API Gemini para o Google Cloud em um ou mais projetos associados a essa conta de faturamento. Os usuários não vão encontrar a Gemini Code Assist até que você a ative em pelo menos um projeto.

Ativar a API Gemini para Google Cloud em um projeto do Google Cloud

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

Console

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

    Acesse 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 agora está disponível no projeto selecionado do Google Cloud para todos os usuários que têm as funções necessárias do IAM.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

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

    gcloud services enable cloudaicompanion.googleapis.com

    Se você quiser ativar a API Gemini para Google Cloud em um projeto do Google Cloud diferente, 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 o Google Cloud agora está disponível no projeto especificado do Google Cloud para todos os usuários que têm as funções de IAM necessárias.

APIs necessárias para usuários com firewalls

Além de ativar a API Gemini para o Google Cloud, os usuários com firewalls também precisam ativar as seguintes APIs:

  • oauth2.googleapis.com: usado para fazer login no Google Cloud.
  • serviceusage.googleapis.com: usado para verificar se o projeto do Gemini Code Assist do usuário está configurado corretamente.
  • cloudaicompanion.googleapis.com: o endpoint principal da API Gemini para o Google Cloud.
  • cloudcode-pa.googleapis.com: uma API interna que oferece recursos relacionados ao IDE.
  • cloudresourcemanager.googleapis.com: usado nos ambientes de desenvolvimento integrados para seletores de projeto. A API Resource Manager pode não ser necessária se os projetos forem configurados explicitamente no arquivo settings.json.
  • people.googleapis.com: oferece acesso a informações sobre perfis e contatos.
  • firebaselogging-pa.googleapis.com: uma API interna usada para enviar a telemetria do produto, incluindo eventos sobre se as sugestões foram aceitas.
  • feedback-pa.googleapis.com: uma API interna usada para envio de feedback no IDE.
  • apihub.googleapis.com: usado pelo recurso do navegador da API Cloud Code.

Opcional: configurar o VPC Service Controls

Se a sua organização tiver um perímetro de serviço, adicione os seguintes recursos ao perímetro:

  • API Gemini para Google Cloud
  • API Gemini Code Assist

Se você estiver usando o Gemini Code Assist fora do perímetro do serviço, também vai precisar modificar a política de entrada para permitir o acesso a esses serviços.

Para mais informações, consulte Configurar o VPC Service Controls para Gemini.

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

Esta seção descreve as etapas necessárias para conceder aos usuários os papéis de IAM do usuário do Gemini para o Google Cloud e do consumidor de uso do serviço.

Console

  1. Para conceder os papéis do 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 dar acesso ao Gemini e clique em Editar principal nessa linha.

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

  4. Em Selecionar um papel, selecione Usuário do Gemini para o Google Cloud.

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

  6. Clique em Salvar.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

  3. Conceda a função de usuário do Gemini para o Google Cloud:

    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

  4. Conceda o papel de 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 essas funções podem acessar os recursos do Gemini para o Google Cloud no console do Google Cloud no projeto especificado. Para mais informações, consulte Visão geral do Gemini para o Google Cloud.

Instalar o plug-in Gemini Code Assist em um ambiente de desenvolvimento integrado

Os usuários da sua organização instalam o Gemini Code Assist no ambiente de desenvolvimento integrado de preferência. Para ver mais informações, consulte os seguintes tópicos:

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, faça o seguinte:

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

    Se você usar essas interfaces, use os nomes de função totalmente qualificados:

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

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

  • Criar e conceder funções personalizadas.

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

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • Atribuir e gerenciar licenças.

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

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Além disso, para que qualquer uma das permissões anteriores funcione, a API Gemini para Google Cloud precisa ser ativada no mesmo projeto do Google Cloud em que você atribuiu cada permissão.

A seguir