Configurar o Gemini Code Assist Standard e Enterprise

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

  1. Compre uma assinatura do Gemini Code Assist Standard ou Enterprise.

  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 em um projeto do Google Cloud.

  5. Os usuários da sua organização instalam o plug-in do Gemini Code Assist para usar o Gemini Code Assist Standard ou Enterprise em um ambiente de desenvolvimento integrado. Essa etapa não é necessária para usuários da CLI Gemini.

Comprar uma assinatura do Gemini Code Assist

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

Para novos clientes do Gemini Code Assist com contas de faturamento que nunca tiveram uma assinatura do Gemini Code Assist, aplicamos automaticamente créditos equivalentes a até 50 licenças sem custo financeiro no primeiro mês, independente da edição do Gemini Code Assist. Não é possível aumentar o número de créditos gratuitos depois que os créditos iniciais de licença gratuita são alocados. Além disso, não é possível mudar a edição do Gemini Code Assist no primeiro mês.

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

  1. Acesse a página Administrador do Gemini.

    Acessar o Admin para Gemini

    A página Administrador do Gemini é aberta.

  2. Selecione Receber o Gemini Code Assist.

    Se você não tiver a permissão consumerprocurement.orders.place necessária, o botão vai estar desativado. Se já houver uma assinatura do Gemini Code Assist para a conta de faturamento associada ao projeto, esse botão vai aparecer como Gerenciar o Gemini Code Assist e permitir que você edite sua assinatura.

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

  3. Em Selecionar edição da assinatura do Gemini Code Assist, escolha uma edição do Gemini Code Assist. Selecione Comparar edições do Gemini Code Assist para ver 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 um preço com desconto que é cobrado mensalmente em vez de um pagamento único.

  5. Para confirmar a assinatura, selecione Continuar.

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

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

A assinatura foi comprada para o Gemini Code Assist Standard ou Enterprise. 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, uma licença precisa ser atribuída a cada usuário individual que deve receber acesso na organização.

Para novos clientes do Gemini Code Assist com contas de faturamento que nunca tiveram uma assinatura do Gemini Code Assist, aplicamos automaticamente créditos equivalentes a até 50 licenças sem custo financeiro no primeiro mês, independente da edição do Gemini Code Assist. Não é possível aumentar o número de créditos gratuitos depois que os créditos iniciais de licença gratuita são alocados. Além disso, não é possível mudar a edição do Gemini Code Assist no primeiro mês.

Console

Para atribuir licenças do Gemini a usuários individuais no API Console, você precisa ter as seguintes permissões na conta de faturamento:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

  1. Acesse a página Administrador do Gemini.

    Acesse o Gemini para Google Cloud

  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 vai aparecer. 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 atribuir licenças.

  6. Clique em Atribuir licenças.

API

Para atribuir licenças do Gemini com a API, use o método billingAccounts.orders.licensePool.assign.

  1. Verifique se você tem a permissão consumerprocurement.licensePools.assign do Identity and Access Management na conta de faturamento que contém o pool de licenças que você quer atribuir.

  2. Crie um arquivo JSON com as informações a seguir:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Em que USER_EMAILS é uma lista separada por vírgulas de contas de usuário que estão recebendo a licença. Por exemplo, "dana@example.com", "lee@example.com".

  3. Use cURL para chamar o método:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Substitua:

    • JSON_FILE_NAME: o caminho para o arquivo JSON criado na Etapa 2.
    • PROJECT_ID: o ID de um projeto. O uso da cota e as cobranças associadas à solicitação de API são aplicados a esse projeto.
    • BILLING_ACCOUNT_ID: o ID da conta de faturamento associada ao pool de licenças.
    • ORDER_ID: o ID do pedido. Se você não souber o ID, recupere-o listando os pedidos associados à sua conta de faturamento.

Se a operação for bem-sucedida, a resposta será semelhante a esta:

  {}

Agora, você precisa ativar a API Gemini para Google Cloud em um ou mais projetos associados a essa conta de faturamento. Os usuários não vão ver 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 Cloud

Esta seção descreve as etapas necessárias para ativar a API Gemini para Google Cloud em um projeto do 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 do Cloud selecionado para todos os usuários que têm as funções necessárias do IAM.

gcloud

Para usar um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud.

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

  2. 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 diferente do Cloud, adicione o parâmetro --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto do 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 do Cloud especificado para todos os usuários que têm as funções de IAM necessárias.

Configurar o firewall para o tráfego de API entre seu ambiente de desenvolvimento integrado e o Google

Além de ativar o Gemini para o Google Cloud, os usuários atrás de firewalls também precisam permitir que o tráfego passe pelas 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 Google Cloud.
  • cloudcode-pa.googleapis.com: uma API interna que oferece recursos relacionados ao IDE.
  • cloudresourcemanager.googleapis.com: usado nos IDEs para seletores de projetos. A API Resource Manager pode não ser necessária se os projetos estiverem 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 telemetria de produtos, incluindo eventos sobre se as sugestões foram aceitas.
  • feedback-pa.googleapis.com: uma API interna usada para envio de feedback no ambiente de desenvolvimento integrado.
  • apihub.googleapis.com: usado pelo recurso Navegador de APIs do Cloud Code.
  • lh3.googleusercontent.com e lh5.googleusercontent.com: usados para obter fotos do usuário.

Determinar endereços IP para domínios padrão do Google Cloud

Para ativar a conectividade do seu ambiente de desenvolvimento integrado (IDE) com as APIs do Google Cloud, o firewall precisa permitir o tráfego TCP de saída para os intervalos de endereços IP documentados publicamente do Google. Esses intervalos são gerenciados dinamicamente pelo Google.

Para manter uma lista de intervalos de endereços IP para acessar domínios do Google Cloud, você tem várias opções:

Opcional: configurar o VPC Service Controls

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

  • API Gemini para Google Cloud
  • API Gemini Code Assist

Se você estiver usando o Gemini Code Assist Standard ou Enterprise fora do perímetro de serviço, também 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 o Gemini.

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

Nesta seção, descrevemos as etapas necessárias para conceder aos usuários os papéis do Gemini para Google Cloud User e do Service Usage Consumer IAM.

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

Para usar um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud.

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

  2. 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:

    • PROJECT_ID: o ID do seu projeto do Cloud. Por exemplo,1234567890.
    • PRINCIPAL: o identificador do principal. Por exemplo, user:cloudysanfrancisco@gmail.com.

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

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  3. Repita a etapa anterior para a função 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 de APIs no projeto especificado. Para mais informações, consulte Visão geral do Gemini para o Google Cloud.

Instalar o plug-in do Gemini Code Assist

Os usuários da sua organização instalam o plug-in do Gemini Code Assist no ambiente de desenvolvimento integrado compatível de preferência.

VS Code

  1. Para abrir a visualização Extensões no VS Code, clique em Ícone de extensão Extensões ou pressione Ctrl/Cmd+Shift+X.

  2. Pesquisar por Gemini Code Assist.

  3. Clique em Instalar.

  4. Se solicitado, reinicie o VS Code.

    Depois que a extensão for instalada, o Gemini Code Assist vai aparecer na barra de atividades e estará pronto para uso. É possível definir outras configurações da instalação do Gemini Code Assist especificando suas preferências na barra de tarefas superior do aplicativo: navegue até Código > Configurações > Configurações > Extensões e pesquise Gemini Code Assist.

IntelliJ

  1. Clique em settings Configurações do IDE e do projeto > Plug-ins.
  2. Na guia Marketplace, pesquise Gemini Code Assist.
  3. Clique em Instalar para instalar o plug-in.
  4. Quando a instalação terminar, clique em Restart IDE.

  5. Quando o ambiente de desenvolvimento integrado for reiniciado, o Gemini Code Assist vai aparecer na barra de atividades.

    O ícone do Gemini Code Assist aparece na barra de atividades.

Agora os usuários estão prontos para usar o Gemini Code Assist Standard ou Enterprise no ambiente de desenvolvimento integrado. Saiba mais sobre os recursos compatíveis:

Comece com os seguintes guias:

Lista de diretórios em que o Gemini Code Assist armazena informações em cache

A tabela a seguir fornece uma lista de diretórios em que o Gemini Code Assist armazena informações de extensão, como tokens de autenticação:

Windows

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Linux

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

Faça login no Google e selecione um projeto do Google Cloud

Depois de instalar o Gemini Code Assist nos ambientes de desenvolvimento integrado, os usuários precisam fazer login nas Contas do Google. Se for a primeira vez que usam o Gemini Code Assist Standard ou Enterprise no ambiente de desenvolvimento integrado, eles precisam selecionar um projeto do Google Cloud.

VS Code

Se você selecionar um projeto do Google Cloud sem a API Gemini para Google Cloud ativada, vai receber uma notificação com a opção de ativar a API no ambiente de desenvolvimento integrado. Selecione Ativar a API na janela de notificação para ativar a API no projeto. Para mais informações, consulte Configurar o Gemini Code Assist Standard e Enterprise para um projeto.

Se preferir seguir o tutorial Programar com o Gemini Code Assist diretamente no seu ambiente de desenvolvimento integrado, clique em Iniciar o VS Code e siga as etapas do tutorial para se conectar ao Google Cloud e ativar o Gemini Code Assist Standard ou Enterprise.

Inicie o VS Code.

Se isso não acontecer, siga estas etapas:

  1. Inicie o ambiente de desenvolvimento integrado.

  2. Na barra de atividades, clique em Gemini Code Assist.

  3. No painel de conversa do Gemini Code Assist, clique em Fazer login no Google Cloud.

  4. Quando for solicitado que você permita que o Gemini Code Assist abra o site externo, clique em Abrir.

  5. Siga as instruções para fazer login na sua Conta do Google.

  6. Quando perguntarem se você baixou o Gemini Code Assist do Google, clique em Fazer login.

    Você se conectou ao Google Cloud.

    Em seguida, para selecionar um projeto do Google Cloud com a API Gemini para Google Cloud ativada, siga estas etapas:

  7. Na barra de status do Gemini Code Assist, clique em Gemini Code Assist.

    A barra de status do Gemini está disponível.

  8. No menu Gemini Code Assist, selecione Selecionar projeto do Gemini Code.

  9. Selecione um projeto do Google Cloud com a API Gemini para Google Cloud ativada.

    O Gemini Code Assist Standard ou Enterprise está pronto para uso.

    O ícone do Gemini na barra de status está definido como normal.

IntelliJ

Para fazer login na sua Conta do Google, siga estas etapas:

  1. Na barra de atividades, clique em spark Gemini Code Assist.

  2. Clique em Fazer login no Google.

  3. Na página aberta no navegador da Web, selecione sua Conta do Google.

  4. Na tela que pede para você confirmar o download desse app pelo Google, clique em Fazer login.

    O Gemini Code Assist agora tem autorização para acessar sua conta.

    Em seguida, se for a primeira vez que você usa o Gemini Code Assist Standard ou Enterprise no seu ambiente de desenvolvimento integrado, selecione um projeto do Google Cloud seguindo estas etapas:

  5. Volte ao ambiente de desenvolvimento integrado. Na janela da ferramenta Gemini Code Assist, se você concordar em permitir que o Google ative as APIs necessárias para usar o Gemini Code Assist em seu nome no projeto selecionado, clique em Selecionar um projeto do GCP para continuar.

  6. Na caixa de diálogo Selecionar projeto do Google Cloud, pesquise e selecione seu projeto do Google Cloud e clique em OK.

  7. Clique em CONCLUIR.

Seu projeto do Google Cloud está selecionado com a API Gemini Code Assist ativada. Agora você pode usar o Gemini Code Assist Standard ou Enterprise no seu ambiente de desenvolvimento integrado.

Tarefas de configuração avançada

Em vez de usar o console da API ou o gcloud para conceder papéis predefinidos do IAM, faça 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çã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 Standard e Enterprise:

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

  • Atribuir e gerenciar licenças.

    Todos os papéis personalizados que você criar precisam das seguintes permissões para que você atribua e gerencie licenças do 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 estar ativada no mesmo projeto do Google Cloud em que você atribuiu cada permissão.

A seguir