Antes de usar o Gemini Cloud Assist, seu administrador precisa realizar as etapas de configuração descritas neste documento. O Gemini Cloud Assist pode ser configurado para um projeto ou uma pasta.
Configurar o Gemini Cloud Assist para um projeto
As etapas a seguir detalham como configurar o Gemini Cloud Assist para um projeto no console do Google Cloud ou usando a CLI do Google Cloud.
Console
Acesse a página Administrador do Gemini.
No seletor de projetos na parte de cima da página, selecione o recurso do projeto.
Selecione Usar o Gemini Cloud Assist.
Na caixa de diálogo Get Gemini Cloud Assist, faça o seguinte:
Selecione a seta de expansão
encontrada na seção APIs obrigatórias e recomendadas.Verifique se as seguintes APIs necessárias estão ativadas: API Gemini Cloud Assist e API Gemini para Google Cloud.
Na lista APIs recomendadas, selecione as APIs que você quer ativar.
Opcional: selecione Ajude o Google a melhorar o Cloud Assist compartilhando seus comandos e respostas.
Selecione Ativar o Gemini Cloud Assist sem custo financeiro.
Clique em Salvar.
Conceda os papéis do IAM necessários para usar o Gemini Cloud Assist.
Acessar a página AM e administrador
Na coluna Principal, encontre uma principal para a qual você quer dar acesso ao Gemini Cloud Assist 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 Cloud Assist.
Clique em Adicionar outro papel e selecione Leitor de recomendação.
Se o principal quiser receber assistência com produtos aos quais ele ainda não tem acesso, talvez seja necessário conceder a ele outras funções do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para conferir uma tabela de papéis do IAM que permitem uma experiência ótima do Gemini Cloud Assist para diferentes produtos.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Ative a API Gemini Cloud Assist usando o comando
gcloud services enable
:gcloud services enable geminicloudassist.googleapis.com
Essa etapa também ativa a API Gemini para Google Cloud, que também é necessária para usar o Gemini Cloud Assist.
Se você quiser ativar a API Gemini Cloud Assist em um projeto do Google Cloud diferente, adicione o parâmetro
--project
:gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
O resultado será assim:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
Conceder papéis do IAM em um projeto do Google Cloud. Para mais informações, consulte Conceder um único papel e
gcloud projects add-iam-policy-binding
.Conceda o papel
roles/geminicloudassist.user
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/geminicloudassist.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/geminicloudassist.user
Repita a etapa anterior para a função
roles/recommender.viewer
.
Se o principal quiser receber assistência com produtos aos quais ele ainda não tem acesso, talvez seja necessário conceder a ele outras funções do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para conferir uma tabela de papéis do IAM que permitem uma experiência ótima do Gemini Cloud Assist para diferentes produtos.
Configurar o Gemini Cloud Assist para uma pasta
As etapas a seguir detalham como configurar o Gemini Cloud Assist para uma pasta no console do Google Cloud. Não é possível usar a CLI do Google Cloud para configurar o Gemini Cloud Assist.
Ative as APIs obrigatórias e recomendadas.
Acesse a página Administrador do Gemini.
No seletor de projetos na parte de cima da página, selecione o recurso da pasta.
Selecione Receber assistência do Gemini Cloud.
A caixa de diálogo Ativar a API para projetos atuais na pasta é exibida.
Na caixa de diálogo Ativar a API para projetos atuais em uma pasta,selecione a seta de expansão
na seção APIs obrigatórias e recomendadas.Verifique se as seguintes APIs necessárias estão ativadas: API Gemini Cloud Assist e API Gemini para Google Cloud.
Na lista APIs recomendadas, selecione as APIs que você quer ativar.
Opcional: selecione Ajude o Google a melhorar o Cloud Assist compartilhando seus comandos e respostas.
Selecione Ativar o Gemini Cloud Assist sem custo financeiro.
Esta etapa ativa as APIs recomendadas necessárias e selecionadas para todos os projetos na pasta. Se você quiser exceções para alguns projetos na pasta, é possível bloquear a ativação da API definindo uma restrição da política de organização Restringir o uso do serviço de recursos nesses projetos. Para mais informações, consulte Como restringir o uso de recursos.
Conceda os seguintes papéis do IAM ou crie papéis personalizados com permissões equivalentes na pasta:
- Usuário do Gemini para Google Cloud
- Leitor de recursos do Cloud
- Visualizador de Recomendador
Se o principal quiser receber assistência com produtos aos quais ele ainda não tem acesso, talvez seja necessário conceder a ele outras funções do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para conferir uma tabela de papéis do IAM que permitem uma experiência ótima do Gemini Cloud Assist para diferentes produtos.
Se você estiver usando o Gemini Cloud Assist com aplicativos, também precisará ativar o gerenciamento de aplicativos. Essa etapa cria um projeto de gerenciamento que precisa ser vinculado a uma conta de faturamento.
Volte para a página Administrador do Gemini.
Selecione Ativar o gerenciamento de apps.
A página de configurações IAM e administrador vai aparecer.
Selecione Ativar na seção Ativação do app da página.
A caixa de diálogo Ativar APIs de aplicativos nesta pasta é exibida.
Selecione Ativar.
Uma barra de status mostra o progresso da ativação da API. A página de configurações do IAM e Administrador é atualizada quando a ativação da API é concluída.
Selecione Gerenciar faturamento.
A página Conta vinculada aparece.
Selecione uma conta de faturamento na lista e clique em Definir conta.
Conceda os papéis do IAM que você concedeu à pasta na etapa 2 ou crie papéis personalizados com permissões equivalentes ao projeto de gerenciamento criado na etapa anterior.
Encontre o projeto de gerenciamento da pasta:
Volte para a página Administrador do Gemini.
No seletor de projetos na parte de cima da página, selecione o recurso da pasta.
Selecione Gerenciar configurações do Gemini Cloud Assist.
A caixa de diálogo Gerenciar Gemini Cloud Assist é exibida.
Anote o projeto de gerenciamento.
(Opcional) Defina as configurações dos projetos na pasta.