Configure o Gemini Cloud Assist

Antes de poder usar o Gemini Cloud Assist, o seu administrador tem de realizar os passos de configuração descritos neste documento. O Gemini Cloud Assist pode ser configurado para um projeto ou uma pasta.

Configure o Gemini Cloud Assist para um projeto

Os passos seguintes detalham como configurar o Gemini Cloud Assist para um projeto na consola ou através da CLI do Google Cloud. Google Cloud

Consola

  1. Aceda à página Administração do Gemini.

    Aceda ao Gemini para o Google Cloud

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

  3. Selecione Obter Gemini Cloud Assist.

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

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

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

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

    4. Opcional: selecione Ajudar a Google a melhorar o Cloud Assist partilhando os seus comandos e respostas.

    5. Selecione Ativar o Gemini Cloud Assist sem custos.

  5. Clique em Guardar.

  6. Conceda as funções IAM necessárias para usar o Gemini Cloud Assist.

    1. Aceda à página IAM e administrador.

      Aceda a IAM e administração

    2. Na coluna Principal, encontre um principal ao qual quer conceder acesso ao Gemini Cloud Assist e, de seguida, clique em Editar principal nessa linha.

    3. No painel Editar acesso, clique em Adicionar outra função.

    4. Em Selecionar uma função, selecione Utilizador do Gemini Cloud Assist.

    5. Clique em Adicionar outra função e selecione Visualizador de recomendações.

    6. Se o principal quiser receber assistência com produtos aos quais ainda não tem acesso, pode ter de lhe conceder funções do IAM adicionais clicando em Adicionar outra função e selecionando funções adicionais. Consulte os requisitos da IAM para usar o Gemini Cloud Assist para ver uma tabela das funções da IAM que permitem uma experiência do Gemini Cloud Assist ideal para diferentes produtos.

gcloud

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

    Activate Cloud Shell

  2. Ative a API Gemini Cloud Assist com o comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Este passo também ativa a API Gemini para o Google Cloud, que também é necessária para usar o Gemini Cloud Assist.

    Se quiser ativar a API Gemini Cloud Assist numGoogle Cloud projeto--project diferente, adicione o parâmetro:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    O resultado é semelhante ao seguinte:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

  3. (Opcional) Ative as APIs recomendadas através do comando gcloud services enable, tal como fez para ativar a API Gemini Cloud Assist.

  4. Conceda funções de IAM num Google Cloud projeto. Para mais informações, consulte Conceda uma única função e gcloud projects add-iam-policy-binding.

    1. Conceda a função de roles/geminicloudassist.user:

      gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user

      Substitua o seguinte:

      • PROJECT_ID: o ID do seu projeto Google Cloud , por exemplo,1234567890.
      • PRINCIPAL: o identificador do principal, por exemplo, user:cloudysanfrancisco@gmail.com.

      A saída é uma lista de associações de políticas que inclui o seguinte:

      - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

    2. Repita o passo anterior para a função roles/recommender.viewer.

    3. Se o principal quiser receber assistência com produtos aos quais ainda não tem acesso, pode ter de lhe conceder funções do IAM adicionais. Consulte os requisitos da IAM para usar o Gemini Cloud Assist para ver uma tabela das funções da IAM que permitem uma experiência do Gemini Cloud Assist ideal para diferentes produtos.

    5. API

    Estas instruções usam cURL para chamar métodos da API.

    1. Ative a API Gemini Cloud Assist através do método services.enable:

      curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"

      Substitua PROJECT_ID pelo ID do projeto para o qual está a ativar o Gemini Cloud Assist.

      Se o comando for bem-sucedido, devolve um long-running operation, que inclui um campo name. Pode usar o valor no campo name para verificar o estado da operação.

    2. (Opcional) Ative as APIs recomendadas através do método services.enable, tal como fez para ativar a API Gemini Cloud Assist.

    3. Conceda funções de IAM para o projeto Google Cloud associado.

      1. Crie um ficheiro JSON que contenha as seguintes informações:

          {
    "options": {
      "requestedPolicyVersion": 3
    }
  }

      2. Recupere a Política IAM existente para o projeto através do método projects.getIamPolicy:

          curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"

        Substitua o seguinte:

        • JSON_FILE_NAME: o caminho para o ficheiro JSON que criou no passo anterior.

        • PROJECT_ID: o ID do projeto.

        Se for bem-sucedido, a resposta devolve a política de IAM do projeto.

      3. Copie a política de IAM do projeto para um ficheiro JSON vazio e adicione as seguintes informações ao conteúdo existente:

          {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/recommender.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }

        Substitua PRINCIPAL pelo identificador do principal ao qual está a conceder acesso ao Gemini Cloud Assist.

      4. Aplique a política de IAM atualizada ao projeto através do método projects.setIamPolicy:

          curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"

        Substitua o seguinte:

        • JSON_FILE_NAME: o caminho para o ficheiro JSON que criou no passo anterior.

        • PROJECT_ID: o ID do projeto.

        Se for bem-sucedido, a resposta devolve a política de IAM atualizada do projeto.

      5. Se o principal quiser receber assistência com produtos aos quais ainda não tem acesso, pode ter de lhe conceder funções do IAM adicionais. Consulte os requisitos da IAM para usar o Gemini Cloud Assist para ver uma tabela das funções da IAM que permitem uma experiência do Gemini Cloud Assist ideal para diferentes produtos.

Configure o Gemini Cloud Assist para uma pasta

Os passos seguintes detalham como configurar o Gemini Cloud Assist para uma pasta através da Google Cloud consola. Não pode usar a Google Cloud CLI nem a API para configurar o Gemini Cloud Assist para pastas.

  1. Ative as APIs obrigatórias e recomendadas.

    1. Aceda à página Administração do Gemini.

      Aceder à administração do Gemini

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

    3. Selecione Ativar APIs Cloud Assist.

      É apresentada a caixa de diálogo Ativar API para projetos existentes na pasta.

    4. Na caixa de diálogo Ativar API para projetos existentes numa pasta, selecione a seta do expansor na secção APIs obrigatórias e recomendadas.

    5. Na lista APIs recomendadas, selecione as APIs opcionais que quer ativar.

    6. Opcional: selecione Ajudar a Google a melhorar o Cloud Assist partilhando os seus comandos e respostas.

    7. Selecione Ativar o Gemini Cloud Assist sem custos.

      Este passo ativa as APIs obrigatórias e recomendadas selecionadas para todos os projetos na pasta. Se quiser exceções para alguns projetos na pasta, pode bloquear a ativação da API definindo uma restrição da política da organização Restringir a utilização do serviço de recursos nesses projetos. Para mais informações, consulte o artigo Restringir a utilização de recursos.

  2. Conceda as seguintes funções de IAM ou crie funções personalizadas com autorizações equivalentes na pasta:

    • Utilizador do Cloud Assist
    • Cloud Asset Viewer
    • Recommender Viewer

    Se o diretor quiser receber assistência com produtos aos quais ainda não tem acesso, pode ter de lhe conceder funções do IAM adicionais. Consulte os requisitos da IAM para usar o Gemini Cloud Assist para ver uma tabela das funções da IAM que permitem uma experiência do Gemini Cloud Assist ideal para diferentes produtos.

  3. Se estiver a usar o Gemini Cloud Assist com aplicações, também tem de ativar a gestão de aplicações ao nível da pasta. Este passo cria um projeto de gestão ao qual tem de associar uma conta de faturação.

    1. Regresse à página Administração do Gemini.

      Aceder à administração do Gemini

    2. Selecione Ativar gestão de apps.

      É apresentada a página de definições de IAM e administrador.

    3. Selecione Ativar na secção Ativação de apps da página.

      É apresentada a caixa de diálogo Ativar APIs de aplicações nesta pasta.

    4. Selecione Ativar.

      Uma barra de estado apresenta o progresso da ativação da API. A página de definições IAM e administrador é atualizada quando a ativação da API é concluída.

    5. Selecione Gerir faturação.

      É apresentada a página Conta associada.

    6. Selecione uma conta de faturação na lista e, de seguida, selecione Definir conta.

  4. Conceda as funções de IAM que concedeu à pasta no passo 2 ou crie funções personalizadas com autorizações equivalentes ao projeto de gestão criado no passo anterior.

    Encontre o projeto de gestão da pasta:

    1. Regresse à página Administração do Gemini.

      Aceder à administração do Gemini

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

    3. Selecione Gerir definições do Gemini Cloud Assist.

      É apresentada a caixa de diálogo Faça a gestão do Gemini Cloud Assist.

    4. Anote o projeto de gestão.

  5. (Opcional) Configure as definições dos projetos na pasta.

o criar.

O que se segue?