Configurar o Gemini Code Assist Standard e Enterprise

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

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

  2. Atribua licenças a usuários individuais em sua organização .

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

  4. Conceder funções de Gerenciamento de Identidade e Acesso (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 IDE.

Adquira uma assinatura do Gemini Code Assist

Para obter uma lista de recursos disponíveis em cada edição, consulte Recursos com suporte .

Para novos clientes do Gemini Code Assist com contas de cobrança que nunca tiveram uma assinatura do Gemini Code Assist, aplicamos automaticamente créditos equivalentes a até 50 licenças gratuitas no primeiro mês, independentemente da edição do Gemini Code Assist . Observe que você não pode aumentar o número de créditos gratuitos após os créditos iniciais da licença gratuita serem alocados. Além disso, você não pode alterar a edição do Gemini Code Assist durante o primeiro mês.

Se você tem contratos existentes com Google Cloud, entre em contato com nossa equipe de vendas antes de adquirir uma assinatura.

Observação: você precisa ter a permissão consumerprocurement.orders.place de Gerenciamento de Identidade e Acesso (IAM) na conta de cobrança para adquirir uma assinatura Gemini. A permissão consumerprocurement.orders.place está incluída na função do IAM roles/billing.admin ou na função roles/consumerprocurement.orderAdmin . Como alternativa, você pode adicionar a permissão a uma função personalizada.

  1. Acesse a página Admin do Gemini .

    Vá para Admin para Gemini

    A página Admin do Gemini é aberta.

  2. Selecione Obter Assistência de Código Gemini .

    Observe que, se você não tiver a permissão consumerprocurement.orders.place necessária, este botão estará desabilitado. Se já existir uma assinatura do Gemini Code Assist para a conta de cobrança associada ao projeto, este botão será exibido como Gerenciar Gemini Code Assist e permitirá que você edite sua assinatura .

    A página de assinatura do Get Gemini Code Assist é aberta.

  3. Em Selecionar Edição de Assinatura do Gemini Code Assist , selecione uma edição do Gemini Code Assist. Selecione Comparar Edições do Gemini Code Assist para ver uma lista detalhada dos recursos disponíveis para 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. Observe que, se você adquirir a edição Enterprise, precisará adquirir pelo menos 10 licenças.
    • Período de assinatura (mensal ou anual). Com uma assinatura anual, você recebe um desconto 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, em seguida, selecione Confirmar assinatura .

  7. Selecione Avançar: Gerenciar atribuições de licença do Gemini .

A assinatura do Gemini Code Assist Standard ou Enterprise foi adquirida. Agora você precisa gerenciar as atribuições de licenças do Gemini na sua organização.

Atribuir licenças

Antes de usar o Gemini Code Assist, uma licença deve 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 cobrança que nunca tiveram uma assinatura do Gemini Code Assist, aplicamos automaticamente créditos equivalentes a até 50 licenças gratuitas no primeiro mês, independentemente da edição do Gemini Code Assist . Observe que você não pode aumentar o número de créditos gratuitos após os créditos iniciais da licença gratuita serem alocados. Além disso, você não pode alterar a edição do Gemini Code Assist durante o primeiro mês.

Console

Para atribuir licenças Gemini a usuários individuais noGoogle Cloud console, você deve ter as seguintes permissões na conta de cobrança:

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

    Acesse Gemini para o Google Cloud

  2. Selecione a assinatura que você deseja alterar e clique em Modificar assinatura .

  3. Clique em Atribuir Licenças . Uma caixa de diálogo para seleção de usuários será exibida. Para pesquisar usuários específicos, digite o nome deles na caixa de pesquisa.

  4. Selecione um ou mais usuários da lista e clique em Avançar .

  5. Selecione os serviços Gemini para os quais você deseja atribuir licenças.

  6. Clique em Atribuir licenças .

API

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

  1. Verifique se você tem a permissão consumerprocurement.licensePools.assign Identity and Access Management (IAM) na conta de cobrança que contém o pool de licenças cuja licença você pretende atribuir.

  2. Crie um arquivo JSON que contenha as seguintes informações:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Onde USER_EMAILS é uma lista separada por vírgulas de contas de usuários às quais a licença está sendo atribuída. 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 o seguinte:

    • JSON_FILE_NAME : o caminho para o arquivo JSON que você criou na Etapa 2.
    • PROJECT_ID : o ID de um projeto. O uso da cota e as cobranças associadas à solicitação da API são aplicadas a este projeto.
    • BILLING_ACCOUNT_ID : a ID da conta de cobrança associada ao pool de licenças.
    • ORDER_ID : o ID do pedido. Caso não saiba o ID do pedido, você pode recuperá-lo listando os pedidos associados à sua conta de cobrança .

Se for bem-sucedido, a resposta será semelhante à seguinte:

  {}

Agora você precisa habilitar a API Gemini para Google Cloud em um 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.

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

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

Console

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

    Acesse Gemini para o Google Cloud

  2. No seletor de projetos, selecione um projeto.

  3. Clique em Habilitar .

    A página é atualizada e mostra o status Habilitado . O Gemini agora está disponível no aplicativo selecionado.Google Cloud projeto para todos os usuários que tenham as funções do IAM necessárias.

gcloud CLI

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

    Activate Cloud Shell

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

  2. Habilite o Gemini para a API do Google Cloud para Gemini usando o comando gcloud services enable :

    gcloud services enable cloudaicompanion.googleapis.com

    Se você deseja habilitar a API Gemini para Google Cloud em um local diferenteGoogle Cloud projeto, adicione o parâmetro --project :

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

    Substitua PROJECT_ID pelo seu Google Cloud ID do projeto.

    A saída é semelhante à seguinte:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Gêmeos para Google Cloud já está disponível no especificadoGoogle Cloud projeto para todos os usuários que tenham as funções do IAM necessárias .

Configure o firewall para tráfego de API entre seu IDE e o Google

Além de habilitar a API Gemini para Google Cloud, os usuários atrás de firewalls também precisam permitir a passagem de 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 Gemini Code Assist do usuário está configurado corretamente.
  • cloudaicompanion.googleapis.com : o principal Gemini para Google Cloud Ponto final da API.
  • cloudcode-pa.googleapis.com : uma API interna que fornece recursos relacionados ao IDE.
  • cloudresourcemanager.googleapis.com : usado nos IDEs para seletores de projetos. A API do Gerenciador de Recursos pode não ser necessária se os projetos estiverem configurados explicitamente no seu arquivo settings.json .
  • people.googleapis.com : fornece 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 sugestões foram aceitas.
  • feedback-pa.googleapis.com : uma API interna usada para envio de feedback no IDE.
  • apihub.googleapis.com : usado pelo recurso Navegador da API do Cloud Code.
  • lh3.googleusercontent.com e lh5.googleusercontent.com : usados ​​para obter fotos do usuário.

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

Para habilitar a conectividade do seu IDE para Google Cloud Para APIs, seu firewall deve permitir tráfego TCP de saída para os intervalos de endereços IP publicamente documentados do Google. Esses intervalos são gerenciados dinamicamente pelo Google.

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

Opcional: Configurar controles de serviço da VPC

Se sua organização tiver um perímetro de serviço, você deverá adicionar os seguintes recursos ao seu perímetro:

  • Gemini para Google Cloud API
  • API de Assistência de Código Gemini

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

Para obter mais informações, consulte Configurar controles de serviço de VPC para Gemini .

Conceder funções de IAM em um Google Cloud projeto

Esta seção descreve as etapas necessárias para conceder as funções de IAM Gemini para Usuário do Google Cloud e Consumidor de Uso de Serviço aos usuários.

Console

  1. Para conceder as funções do IAM necessárias para usar o Gemini, acesse a página IAM e administração .

    Acesse IAM e Admin

  2. Na coluna Principal , encontre um principal para o qual você deseja dar acesso ao Gemini e clique em principal nessa linha.

  3. No painel Editar acesso , clique em outra função .

  4. Em Selecionar uma função , selecione Gemini para Usuário do Google Cloud .

  5. Clique em Adicionar outra função e selecione Consumidor de uso do serviço .

  6. Clique em Salvar .

gcloud CLI

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

    Activate Cloud Shell

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

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

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/cloudaicompanion.user

    Substitua o seguinte:

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

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

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

  3. Repita a etapa anterior para a função roles/serviceusage.serviceUsageConsumer .

Para obter mais informações, consulte Conceder uma única função e gcloud projects add-iam-policy-binding .

Todos os usuários que receberam essas funções podem acessar o Gemini para Google Cloud recursos noGoogle Cloud console dentro do projeto especificado. Para obter mais informações, consulte Gemini para Google Cloud visão geral .

Instalar o plugin Gemini Code Assist

Os usuários da sua organização instalam o plugin Gemini Code Assist no IDE compatível de sua preferência

Código VS

  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 por Gemini Code Assist .

  3. Clique em Instalar .

  4. Se solicitado, reinicie o VS Code.

    Após a instalação bem-sucedida da extensão, o Gemini Code Assist aparecerá na barra de atividades e estará pronto para uso. Você pode configurar ainda mais a 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 procure por Gemini Code Assist .

IntelliJ

  1. Clique em settings IDE e Configurações do projeto > Plugins .
  2. Na aba Marketplace , procure por Gemini Code Assist .
  3. Clique em Instalar para instalar o plugin.
  4. Quando a instalação estiver concluída, clique em Reiniciar IDE .

  5. Quando o IDE for reiniciado, o Gemini Code Assist aparecerá na sua 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 em seu IDE. Saiba mais sobre os recursos suportados:

Comece com os seguintes guias:

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

A tabela a seguir fornece uma lista de diretórios onde 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

Entre no Google e selecione um Google Cloud projeto

Depois que os usuários instalam o Gemini Code Assist em seus IDEs, eles precisam fazer login em suas contas do Google e, se for a primeira vez que usam o Gemini Code Assist Standard ou Enterprise em seu IDE, eles selecionam um Google Cloud projeto.

Código VS

Se você selecionar um Google Cloud Em um projeto sem a API Gemini para Google Cloud habilitada, você receberá uma notificação que oferece a opção de habilitar a API a partir do IDE. Selecione Habilitar a API na janela de notificação para habilitar a API para o seu projeto. Para obter mais informações, consulte Configurar o Gemini Code Assist Standard e Enterprise para um projeto .

Se você preferir seguir o passo a passo do Code with Gemini Code Assist diretamente no seu IDE, clique em Iniciar VS Code e siga as etapas do passo a passo para se conectar a Google Cloud e ative o Gemini Code Assist Standard ou Enterprise.

Inicie o VS Code

Caso contrário, siga estas etapas:

  1. Inicie seu IDE.

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

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

  4. Quando solicitado a permitir 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 perguntado se você baixou o Gemini Code Assist do Google, clique em Entrar .

    Agora você está conectado a Google Cloud.

    Em seguida, para selecionar um Google Cloud projeto que tenha a API Gemini para Google Cloud habilitada, 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 Gemini Code .

  9. Selecione um Google Cloud projeto que tem a API Gemini para Google Cloud habilitada.

    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 que se abre no navegador da web, selecione sua Conta do Google.

  4. Na tela que solicita que você verifique se baixou o aplicativo do Google, clique em Fazer login .

    O Gemini Code Assist agora está autorizado a acessar sua conta.

    Em seguida, se esta for a primeira vez que você usa o Gemini Code Assist Standard ou Enterprise em seu IDE, você deve selecionar um Google Cloudprojeto seguindo estes passos:

  5. Retorne ao seu IDE. Na janela da ferramenta Gemini Code Assist, se você concordar em permitir que o Google habilite 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 Selecionar projeto do Google Cloud , pesquise e selecione seu Google Cloud projeto e clique em OK .

  7. Clique em CONCLUIR .

Seu Google Cloud O projeto está selecionado com a API Gemini Code Assist habilitada. Você está pronto para usar o Gemini Code Assist Standard ou Enterprise no seu IDE!

Tarefas de configuração avançadas

Em vez de usar o Google Cloud console ou a CLI do gcloud para conceder funções do IAM predefinidas, você pode fazer qualquer um dos seguintes:

  • Use APIs REST do IAM ou bibliotecas de cliente do IAM para conceder funções.

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

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

    Para obter mais informações sobre como conceder funções, consulte Gerenciar acesso a projetos, pastas e organizações .

  • Crie e conceda funções personalizadas.

    Quaisquer funções personalizadas 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.

    Quaisquer funções personalizadas que você criar precisarão das seguintes permissões para que você possa 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

Observe também que, para que qualquer uma das permissões anteriores funcione, a API Gemini para Google Cloud precisa ser habilitada da mesma forma. Google Cloud projeto ao qual você atribuiu cada permissão.

O que vem a seguir