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.

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.

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

{}

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.

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.

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:

• Estações de trabalho em nuvem: Programar com o Gemini Code Assist
• Editor do Cloud Shell: Programar com o Gemini Code Assist
• Cloud Code for VS Code: Code with Gemini Code Assist
• Cloud Code para IntelliJ e outros ambientes de desenvolvimento integrado do JetBrains: Programar com o Gemini Code Assist

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

• Saiba mais sobre os tipos de assistência de IA generativa disponíveis no Gemini Code Assist para o Google Cloud.
• Aprender como o Gemini Code Assist para Google Cloud usa seus dados.
• Aprender como acessar e gerenciar os controles de administrador do Gemini Code Assist.
• Saiba como configurar a personalização de código.