Antes de usar Gemini Code Assist, sua equipe precisa para executar as etapas de configuração descritas neste documento:
Opcional: Comprar uma assinatura do Gemini Code Assist. O Gemini Code Assist está disponível para teste sem custos até 8 de novembro de 2024, limitado a um usuário por conta de faturamento.
Ativar a API Gemini para Google Cloud em um projeto do Google Cloud. Geralmente, essa etapa é realizada por um administrador.
Conceder papéis do Identity and Access Management (IAM) em um projeto do Google Cloud. Geralmente, essa etapa é realizada por um administrador.
Opcional: para usar o Gemini Code Assist em um ambiente de desenvolvimento integrado, instalar o plug-in do Cloud Code.
Opcional: comprar uma assinatura do Gemini Code Assist
O Gemini Code Assist está disponível para teste sem assinatura em sem custo financeiro até 8 de novembro de 2024, limitado a um usuário por conta de faturamento. Organizações com vários usuários por conta de faturamento precisam comprar um conforme descrito nesta seção. Se você já tiver contratos com Google Cloud, entre em contato com nossa equipe de vendas antes de comprar um assinatura.
No console do Google Cloud, acesse a página Gemini para Google Cloud.
Acessar o Gemini para Google Cloud
A página Gemini para Google Cloud será aberta.
Selecione Gemini Code Assist.
O painel Gemini Code Assist vai aparecer.
Clique em Instalar o Gemini Code Assist.
Se necessário, selecione uma conta de faturamento e clique em Continuar para a página de administrador do Gemini.
A página Compre uma assinatura do Gemini Code Assist é aberta.
Em Configurar assinatura, preencha os campos para configurar o incluindo o prazo do compromisso (mensal ou anual) e o o número de licenças na assinatura.
Escolha se você quer renovar sua assinatura automaticamente após o prazo de compromisso (mensal ou anual). A renovação automática mantém sua assinatura e licenças ativas. Se a assinatura não for renovada automaticamente, ela vai terminar quando o período atual termina, e você precisa passar pelo processo de compra novamente para recuperá-las.
Para revisar os detalhes da assinatura, clique em Continuar.
Se você concordar com os termos, clique em Concluir compra e confirme sua assinatura.
O faturamento agora está ativado para o Gemini. Agora você precisa ativar a API Gemini para o Google Cloud em um ou mais projetos associados a essa conta de faturamento. Usuários não vai ter acesso ao Gemini até que você o ative em pelo menos um projeto.
Ativar a API Gemini para Google Cloud em um projeto do Google Cloud
Nesta seção, descrevemos as etapas necessárias para ativar Gemini para API do Google Cloud em um projeto do Google Cloud.
Console
Para ativar a API Gemini para Google Cloud, acesse página do 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 já está disponível nas edições selecionadas projeto do Google Cloud a todos os usuários que tenham os papéis do IAM.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
No menu do seletor de projetos, escolha um projeto.
Ative a API Gemini para Google Cloud usando o comando
gcloud services enable
:gcloud services enable cloudaicompanion.googleapis.com
Se você quiser ativar a API Gemini para Google Cloud de uma forma projeto do Google Cloud, 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 Google Cloud já está disponível no projeto do Google Cloud a todos os usuários com o papéis do IAM necessários.
Conceder papéis de IAM em um projeto do Google Cloud
Nesta seção, descrevemos as etapas necessárias para conceder ao usuário do Cloud AI Companion 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 a principal que você quer ativar o acesso ao Gemini e clicar em Edite o principal nessa linha.
No painel Editar acesso, clique em
Adicionar outro papel.Em Selecionar papel, escolha Usuário do Cloud AI Companion.
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, escolha um projeto.
Conceda o papel de usuário do Cloud AI Companion:
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 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 esses papéis podem acessar Os recursos do Gemini para Google Cloud na Console do Google Cloud no projeto especificado. Para mais informações, consulte Informações gerais do Gemini para Google Cloud.
Opcional: usar o Gemini Code Assist em um ambiente de desenvolvimento integrado
Se você quer usar o Gemini no seu ambiente de desenvolvimento integrado, instale o plug-in Cloud Code. Para ver mais informações, consulte os tópicos a seguir:
- Cloud Workstations: 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, poderá fazer 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ções totalmente qualificados:
roles/cloudaicompanion.user
roles/serviceusage.serviceUsageConsumer
Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Criar e conceder papéis personalizados.
Todos os papéis personalizados que você criar precisam das seguintes permissões para acessar o Gemini:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
cloudaicompanion.instances.completeCode
cloudaicompanion.instances.completeTask
cloudaicompanion.instances.generateCode
cloudaicompanion.instances.generateText
serviceusage.services.use
A seguir
- Saiba mais sobre os tipos de assistência de IA generativa disponíveis no Gemini para o Google Cloud.
- Aprender como o Gemini para Google Cloud usa seus dados.
- Aprender como acessar e gerenciar os controles de admin do Gemini.