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. Adquira uma assinatura do Gemini Code Assist Standard ou Enterprise.

  2. Atribua licenças aos usuários 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 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 do Gemini ou do Gemini no Android Studio.

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 gratuitas 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 Admin do Gemini.

    Acessar o Admin para Gemini

    A página Admin do Gemini é aberta.

  2. Selecione Adquirir 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 Adquirir 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.

    Por padrão, as novas assinaturas são configuradas para atribuição automática de licenças. Um usuário da sua organização recebe automaticamente uma licença quando usa o Gemini Code Assist em um ambiente de desenvolvimento integrado compatível, desde que todas as condições a seguir sejam atendidas:

    • O usuário selecionou um projeto associado à conta de faturamento da assinatura.
    • O usuário tem a permissão cloudaicompanion.licences.selfAssign do IAM no projeto selecionado.

    Depois de configurar o Gemini Code Assist, você pode atribuir licenças manualmente.

  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 organização.

Atribuir licenças

Antes de usar uma licença do Gemini Code Assist, os usuários precisam ter a função de usuário do Gemini para Google Cloud ou permissões semelhantes em um projeto em que a API já esteja ativada.

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 gratuitas 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.

Por padrão, as novas assinaturas são configuradas para atribuição automática de licenças. Um usuário da sua organização recebe automaticamente uma licença quando usa o Gemini Code Assist em um ambiente de desenvolvimento integrado compatível, desde que todas as condições a seguir sejam atendidas:

  • O usuário selecionou um projeto associado à conta de faturamento da assinatura.
  • O usuário tem a permissão cloudaicompanion.licences.selfAssign do IAM no projeto selecionado.

Se uma licença ficar inativa por 30 dias, ela será atribuída automaticamente a outro usuário na sua organização que atenda às condições anteriores.

Depois de configurar o Gemini Code Assist, você pode conferir as atribuições de licença. Para isso, acesse a página Administrador do Gemini, selecione sua conta de faturamento, clique em Gerenciar assinatura do Gemini Code Assist e selecione a guia Gerenciamento de licenças. Se você precisar de um controle mais preciso sobre as atribuições de licença, use essa guia para mudar do gerenciamento automático para o manual.

A API Gemini para Google Cloud precisa estar ativada 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. O Gemini Code Assist requer um projeto do Cloud para gerenciar o acesso à API, a cota e o faturamento. Por isso, é necessário ativar a API Gemini para Google Cloud em um projeto do Cloud de sua escolha antes que os usuários possam acessar o Gemini Code Assist.

Console

  1. Para ativar a API Gemini para Google Cloud, acesse a página 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 agora está disponível no projeto do Cloud selecionado para todos os usuários que têm as funções de IAM necessárias.

gcloud

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

  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 já 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 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 ambiente de desenvolvimento integrado.
  • cloudresourcemanager.googleapis.com: usado nos ambientes de desenvolvimento integrados para seletores de projetos. A API Resource Manager poderá 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 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 IP para acessar domínios do Google Cloud, você tem várias opções:

Opcional: configurar o VPC Service Controls

Se a 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 de Usuário do Gemini para Google Cloud e IAM de consumidor do Service Usage.

Console

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

    Acessar IAM e administrador

  2. Clique em Conceder acesso e insira o nome do principal para quem você quer conceder acesso ao Gemini.

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

  4. Em Atribuir papéis, selecione Usuário do Gemini para o Google Cloud.

  5. Clique em Adicionar papéis e selecione Consumidor do Service Usage.

  6. Clique em Salvar.

gcloud

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

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

  2. Conceda a função do 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 da 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 o papel 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 Google Cloud.

Instalar o plug-in do Gemini Code Assist

Os usuários da organização instalam o plug-in do Gemini Code Assist no ambiente de desenvolvimento integrado compatível de preferência. Os usuários de ambientes de desenvolvimento integrado compatíveis do JetBrains precisam seguir as instruções do IntelliJ.

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. 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 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 ambiente de desenvolvimento integrado e 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 terminar, clique em Reiniciar ambiente de desenvolvimento integrado.

  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 eles usam o Gemini Code Assist Standard ou Enterprise no ambiente de desenvolvimento integrado, eles selecionam um projeto do Google Cloud. É o mesmo projeto usado para configurar o Gemini Code Assist e gerenciar o acesso à API, a cota e o faturamento.

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 preferir, 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 solicitada permissão para que o Gemini Code Assist abra o site externo, clique em Abrir.

  5. Siga as instruções para fazer login na 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 apara uso.

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

IntelliJ

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

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

  2. Clique em Fazer login no Google. Se preferir, clique em Copiar link e cole o URL no navegador.

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

  4. Na tela que pede para confirmar o download do 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 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 ambiente de desenvolvimento integrado.

Tarefas de configuração avançada

As seções a seguir descrevem tarefas de configuração avançada que você pode realizar para personalizar o Gemini Code Assist.

Considerações avançadas sobre o IAM

Em vez de usar o console do Google Cloud ou o 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 precisarão 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 precisarão 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.

Mudar o canal de lançamento do projeto do Google Cloud

Lançamos recursos do Gemini Code Assist em diferentes canais de lançamento, seja em disponibilidade geral ou em prévia. Ao configurar o Gemini Code Assist, seu projeto é definido automaticamente como o canal de lançamento de disponibilidade geral.

Você pode mudar o canal de lançamento do Gemini Code Assist para o canal de prévia ou voltar para o canal de disponibilidade geral a qualquer momento.

A seguir