Configurar o Gemini Cloud Assist

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

  1. Acesse a página Administrador do Gemini.

    Acesse o Gemini para Google Cloud

  2. No seletor de projetos na parte de cima da página, selecione o recurso do projeto.

  3. Selecione Usar o Gemini Cloud Assist.

  4. Na caixa de diálogo Get Gemini Cloud Assist, faça o seguinte:

    1. Selecione a seta de expansão encontrada na seção APIs obrigatórias e recomendadas.

    2. Verifique se as seguintes APIs necessárias estão ativadas: API Gemini Cloud Assist e API Gemini para Google Cloud.

    3. Na lista APIs recomendadas, selecione as APIs que você quer ativar.

    4. Opcional: selecione Ajude o Google a melhorar o Cloud Assist compartilhando seus comandos e respostas.

    5. Selecione Ativar o Gemini Cloud Assist sem custo financeiro.

  5. Clique em Salvar.

  6. Conceda os papéis do IAM necessários para usar o Gemini Cloud Assist.

    1. Acessar a página AM e administrador

      Acessar IAM e administrador

    2. Na coluna Principal, encontre uma principal para a qual você quer dar acesso ao Gemini Cloud Assist e clique em Editar principal nessa linha.

    3. No painel Editar acesso, clique em Adicionar outro papel.

    4. Em Selecionar um papel, selecione Usuário do Gemini Cloud Assist.

    5. 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

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

    Activate Cloud Shell

  2. 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.
    
  3. 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.

    1. 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 formato user|group|serviceAccount:email ou domain:domain, por exemplo, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com ou domain: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
      
    2. 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.

  1. Ative as APIs obrigatórias e recomendadas.

    1. Acesse a página Administrador do Gemini.

      Acessar a página "Administrador do Gemini"

    2. No seletor de projetos na parte de cima da página, selecione o recurso da pasta.

    3. Selecione Receber assistência do Gemini Cloud.

      A caixa de diálogo Ativar a API para projetos atuais na pasta é exibida.

    4. 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.

    5. Verifique se as seguintes APIs necessárias estão ativadas: API Gemini Cloud Assist e API Gemini para Google Cloud.

    6. Na lista APIs recomendadas, selecione as APIs que você quer ativar.

    7. Opcional: selecione Ajude o Google a melhorar o Cloud Assist compartilhando seus comandos e respostas.

    8. 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.

  2. 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.

  3. 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.

    1. Volte para a página Administrador do Gemini.

      Acessar a página "Administrador do Gemini"

    2. Selecione Ativar o gerenciamento de apps.

      A página de configurações IAM e administrador vai aparecer.

    3. Selecione Ativar na seção Ativação do app da página.

      A caixa de diálogo Ativar APIs de aplicativos nesta pasta é exibida.

    4. 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.

    5. Selecione Gerenciar faturamento.

      A página Conta vinculada aparece.

    6. Selecione uma conta de faturamento na lista e clique em Definir conta.

  4. 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:

    1. Volte para a página Administrador do Gemini.

      Acessar a página "Administrador do Gemini"

    2. No seletor de projetos na parte de cima da página, selecione o recurso da pasta.

    3. Selecione Gerenciar configurações do Gemini Cloud Assist.

      A caixa de diálogo Gerenciar Gemini Cloud Assist é exibida.

    4. Anote o projeto de gerenciamento.

  5. (Opcional) Defina as configurações dos projetos na pasta.

A seguir