Configurar o Gemini Code Assist Standard e Enterprise

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

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

  2. Atribuir licenças a usuários individuais na sua organização.

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

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

  5. Os usuários da sua organização instalam o plug-in Gemini Code Assist para usar o Gemini Code Assist Standard ou Enterprise 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.

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 para o primeiro mês, independentemente da edição do Gemini Code Assist. Não é possível aumentar o número de créditos sem custo financeiro depois que os créditos de licença sem custo financeiro iniciais forem alocados. Além disso, não é possível mudar a edição do Gemini Code Assist no primeiro mês.

Se você já tem contratos com a 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) na conta de faturamento 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 Administrador do Gemini.

    Acessar a página "Administrador do 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, esse botão será desativado. Se uma assinatura do Gemini Code Assist já existir para a conta de faturamento associada ao projeto, esse botão vai aparecer como Gerenciar Gemini Code Assist e vai permitir que você edite sua assinatura.

    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 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ça do Gemini.

A assinatura agora é 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 vai 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 para o primeiro mês, independentemente da edição do Gemini Code Assist. Não é possível aumentar o número de créditos sem custo financeiro depois que os créditos de licença sem custo financeiro iniciais forem 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 consoleGoogle Cloud , 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 os quais você quer 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 (IAM) na conta de faturamento que contém o conjunto de licenças que você pretende 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 de cota e as cobranças associadas à solicitação de API são aplicadas 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 do pedido, poderá recuperá-lo 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 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.

Ative a API Gemini para Google Cloud em um Google Cloud projeto

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

CLI da gcloud

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

    Activate Cloud Shell

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

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

    Substitua PROJECT_ID pelo ID do projeto 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 Google 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 o ambiente de desenvolvimento integrado e o Google

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

  • oauth2.googleapis.com: usado para fazer login em 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 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 ambiente de desenvolvimento integrado.
  • apihub.googleapis.com: usado pelo recurso do navegador da API Cloud Code.
  • lh3.googleusercontent.com e lh5.googleusercontent.com: usados para receber fotos do usuário.

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

Para ativar a conectividade do seu ambiente de desenvolvimento integrado com as APIs 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 IP para acessar domínios 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 ao perímetro:

  • API Gemini para Google Cloud
  • API Gemini Code Assist

Se você estiver usando o Gemini Code Assist Standard ou Enterprise fora do seu perímetro de 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.

CLI da gcloud

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

    Activate Cloud Shell

  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 projeto Google 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 Google Cloud no consoleGoogle Cloud no projeto especificado. Para mais informações, consulte Visão geral do Gemini para Google Cloud .

Instalar o plug-in do Gemini Code Assist

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

VS Code

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

  2. Pesquise Gemini Code Assist.

  3. Clique em Install (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 do aplicativo de nível superior: acesse Code > Settings > Settings > Extensions e pesquise Gemini Code Assist.

IntelliJ

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

  5. Quando o ambiente de desenvolvimento integrado é reiniciado, o Gemini Code Assist aparece 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 estes guias:

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

A tabela a seguir mostra 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 Google Cloud projeto

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

VS Code

Se você selecionar um projeto do Google Cloud sem a API Gemini para o 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 você preferir seguir o tutorial Programar com o Gemini Code Assist diretamente no seu ambiente de desenvolvimento integrado, clique em Launch VS Code e siga as etapas no tutorial para se conectar a Google Cloud e ativar o Gemini Code Assist Standard ou Enterprise.

Iniciar o VS Code

Caso contrário, siga estas etapas:

  1. Inicie o ambiente de desenvolvimento integrado.

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

  3. No painel de chat 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 for perguntado se você fez o download do Gemini Code Assist pelo Google, clique em Fazer login.

    Você se conectou a 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 Google Cloud projeto com a API Gemini para Google Cloud ativada.

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

    O ícone 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 que abrir no navegador da Web, selecione sua Conta do Google.

  4. Na tela que pede para você confirmar se fez 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 esta for a primeira vez que você usa o Gemini Code Assist Standard ou Enterprise no seu ambiente de desenvolvimento integrado, selecione um projeto Google Cloud seguindo estas etapas:

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

  6. Na caixa de diálogo Select Google Cloud Project, pesquise e selecione o projeto Google Cloud e clique em OK.

  7. Clique em FINALIZAR.

Seu projeto Google Cloud é selecionado com a API Gemini Code Assist ativada. Você já 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 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ê cria 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 atribuir e gerenciar 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 ser ativada no mesmo projeto Google Cloud em que você atribuiu cada permissão.

A seguir