Configurar o Gemini Code Assist

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

  1. Compre uma assinatura do Gemini Code Assist.

  2. Atribua licenças a usuários específicos na 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 do Cloud Code; o Gemini Code Assist em um ambiente de desenvolvimento integrado.

Comprar uma assinatura do Gemini Code Assist

As etapas necessárias para comprar uma assinatura do Gemini Code Assist dependem da edição que você está comprando: Enterprise ou Standard. Para conferir uma lista dos recursos disponíveis em cada edição, consulte Recursos compatíveis.

Edição Empresarial

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

Edição Padrão

O Gemini Code Assist Standard está disponível para teste sem uma sem custos financeiros até 8 de novembro de 2024, limitada a um usuário por faturamento do Compute Engine. Organizações com vários usuários por conta de faturamento precisam comprar uma assinatura, conforme descrito nesta seção.

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

Observação: é necessário ter o consumerprocurement.orders.place Permissão do Identity and Access Management (IAM) para comprar uma assinatura. A permissão consumerprocurement.orders.place está incluída no papel do IAM roles/billing.admin ou no papel roles/consumerprocurement.orderAdmin. Como alternativa, é 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 será aberta.

  2. Clique em Instalar 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 Configurar assinatura, preencha os campos para configurar a assinatura, incluindo o seguinte:

    • Nome da assinatura.
    • Número de licenças na assinatura.
    • 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 a vigência 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 será encerrada quando o período atual terminar, e você precisará passar pelo processo de compra novamente e reatribuir as licenças.
  4. Para revisar os detalhes da assinatura, clique em Continuar.

  5. Se você concordar com os termos, selecione Concordo com os termos desta compra, e clique em Confirmar assinatura.

  6. Clique em Próxima: gerenciar atribuições de licenças do Gemini.

A assinatura do Gemini Code Assist foi comprada. Agora você precisa gerenciar a atribuição de licenças 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 Modifique a 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 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 Google Cloud em uma ou mais projetos associados a esta conta de faturamento. Os usuários não verão o Gemini Code Assist até que você o 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 protegidos por firewalls

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

  • oauth2.googleapis.com: usados para fazer login no Google Cloud.
  • serviceusage.googleapis.com: usada para verificar se o projeto do Gemini Code Assist do usuário está configurado corretamente.
  • 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 não pode ser necessário se os projetos estiverem configurados explicitamente no seu settings.json. .
  • people.googleapis.com: oferece acesso a informações sobre perfis e contatos.
  • firebaselogging-pa.googleapis.com: uma API interna usada para enviar produtos. telemetria incluindo eventos sobre a aceitação das sugestões.
  • feedback-pa.googleapis.com: uma API interna usada para envio de feedback no ambiente de desenvolvimento integrado.
  • apihub.googleapis.com: usada pelo recurso Navegador da API Cloud Code.

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

Esta seção descreve as etapas necessárias para conceder o acesso do Gemini para 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 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 o papel do usuário do Gemini para 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 do Cloud Code para usar o 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

Para qualquer uma das permissões anteriores funcionar, a O Gemini para a API Google Cloud precisa ser ativado no mesmo projeto do Google Cloud em que a cada permissão atribuída.

A seguir