Antes de usar Gemini Code Assist, sua equipe precisa para executar as etapas de configuração descritas neste documento:
Ative a API Gemini para o Google Cloud em um projeto do Google Cloud.
Conceda papéis do Identity and Access Management (IAM) em um projeto do Google Cloud.
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.
Observação: é necessário ter oconsumerprocurement.orders.place
Permissão do Identity and Access Management (IAM) para comprar uma
assinatura. A permissão consumerprocurement.orders.place
está incluída no
papel do IAM roles/billing.admin
ou no
papel roles/consumerprocurement.orderAdmin
.
Como alternativa, é possível adicionar a permissão a um papel personalizado.
Acesse a página Gemini para Google Cloud.
Acesse o Gemini para Google Cloud
A página Gemini para Google Cloud será aberta.
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.
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.
Para revisar os detalhes da assinatura, clique em Continuar.
Se você concordar com os termos, selecione Concordo com os termos desta compra, e clique em Confirmar assinatura.
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.
Console
Para atribuir licenças do Gemini a usuários individuais no console do Google Cloud, você precisa ter as seguintes permissões:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
Acesse a página Administrador do Gemini.
Escolha a assinatura que você quer mudar e clique em Modifique a assinatura.
Clique em Atribuir licenças. Uma caixa de diálogo de seleção do usuário aparece. Para pesquisar usuários específicos, digite o nome deles na caixa de pesquisa.
Selecione um ou mais usuários na lista e clique em Próxima.
Escolha os serviços do Gemini para os quais você quer atribuir licenças.
Clique em Atribuir licenças.
API
Para atribuir licenças do Gemini com a API, você precisa ter o
consumerprocurement.licensePools.assign
.
Método HTTP: POST
URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/
Substitua:
BILLING_ACCOUNT_ID
: o ID da conta de faturamentoORDER_ID
: a política do IAM
Corpo da solicitação:
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
O resultado será assim:
{}
A resposta vai estar vazia se a licença for atribuída.
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.
Console
Para ativar a API Gemini para Google Cloud, acesse a página Gemini para Google Cloud.
No seletor de projetos, escolha um projeto.
Clique em Ativar.
A página é atualizada e mostra o status Ativado. O Gemini agora está disponível no projeto selecionado do Google Cloud para todos os usuários que têm as funções necessárias do IAM.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
No menu do seletor de projetos, selecione um projeto.
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 do Google Cloud diferente, adicione o parâmetro
--project
:gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
Substitua
PROJECT_ID
pelo ID do projeto do 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 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 seusettings.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.
Console
Para conceder os papéis do IAM necessários para usar Gemini, acesse a página IAM e Admin.
Na coluna Principal, encontre uma principal para a qual você quer dar acesso ao Gemini e clique em Editar principal nessa linha.
No painel Editar acesso, clique em
Adicionar outro papel.Em Selecionar um papel, selecione Usuário do Gemini para o Google Cloud.
Clique em Adicionar outro papel e selecione Consumidor do Service Usage.
Clique em Salvar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
No menu do seletor de projetos, selecione um projeto.
Conceda o papel do usuário do Gemini para Google Cloud:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
Substitua
PRINCIPAL
pelo identificador do principal. O identificador tem o formatouser|group|serviceAccount:email
oudomain:domain
, por exemplo,user:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
oudomain:example.domain.com
.A saída é uma lista de vinculações de política que inclui o seguinte:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
Conceda o papel de consumidor do Service Usage:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
A saída é uma lista de vinculações de política que inclui o seguinte:
- members: - user:PRINCIPAL role: 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 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.