Configurar o Gemini Cloud Assist

Console

1. Acesse a página Admin do Gemini .

   Acesse Gemini para o Google Cloud

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

3. Selecione Obter Assistência Gemini Cloud .

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

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

   2. Certifique-se de que as seguintes APIs necessárias estejam habilitadas: Gemini Cloud Assist API e Gemini for Google Cloud API .

   3. Na lista APIs recomendadas , selecione as APIs que você deseja habilitar.

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

   5. Selecione Habilitar Gemini Cloud Assist sem custo .

5. Clique em Salvar .

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

   1. Acesse a página IAM e Admin .

      Acesse IAM e Admin

   2. Na coluna Principal , encontre um principal para o qual você deseja dar acesso ao Gemini Cloud Assist e clique em edit principal nessa linha.

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

   4. Em Selecionar uma função , selecione Usuário do Gemini Cloud Assist .

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

   Se o principal quiser obter assistência com produtos aos quais ainda não tem acesso, talvez seja necessário conceder a ele funções adicionais do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para obter uma tabela de funções do IAM que permitem uma experiência ideal do Gemini Cloud Assist para diferentes produtos.

gcloud

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

   Activate Cloud Shell

2. Habilite a API Gemini Cloud Assist usando o comando gcloud services enable :

   gcloud services enable geminicloudassist.googleapis.com
   

   Esta etapa também habilita a API Gemini para Google Cloud, que também é necessária para usar o Gemini Cloud Assist.

   Se você deseja habilitar a API Gemini Cloud Assist em um local diferenteGoogle Cloud projeto, adicione o parâmetro --project :

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

   A saída é semelhante à seguinte:

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

3. Conceder funções de IAM em um Google Cloud projeto. Para obter mais informações, consulte Conceder uma única função e gcloud projects add-iam-policy-binding .

   1. Conceda a função 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 seuGoogle Cloud projeto — por exemplo, 1234567890 .
      • PRINCIPAL : o identificador do principal — por exemplo, user:cloudysanfrancisco@gmail.com .

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

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

   2. Repita a etapa anterior para a roles/recommender.viewer .

   Se o principal quiser obter assistência com produtos aos quais ainda não tem acesso, talvez seja necessário conceder a ele funções adicionais do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para obter uma tabela de funções do IAM que permitem uma experiência ideal do Gemini Cloud Assist para diferentes produtos.

API

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

1. Habilite a API Gemini Cloud Assist usando o 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 você está habilitando o Gemini Cloud Assist.

   Se o comando for bem-sucedido, ele retornará uma long-running operation , que inclui um campo name . Você pode usar o valor no campo name para verificar o status da operação .

2. Conceder funções IAM para o associado Google Cloud projeto.

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

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

   2. Recupere a política do IAM existente para o projeto usando o 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 arquivo JSON que você criou na etapa anterior.

      • PROJECT_ID : o ID do projeto.

      Se bem-sucedido, a resposta retornará a política de IAM do projeto.

   3. Copie a política de IAM do projeto para um arquivo 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 você está concedendo acesso ao Gemini Cloud Assist.

   4. Aplique a política do IAM atualizada ao projeto usando o 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 arquivo JSON que você criou na etapa anterior.

      • PROJECT_ID : o ID do projeto.

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

   Se o principal quiser obter assistência com produtos aos quais ainda não tem acesso, talvez seja necessário conceder a ele funções adicionais do IAM. Consulte os requisitos do IAM para usar o Gemini Cloud Assist para obter uma tabela de funções do IAM que permitem uma experiência ideal do Gemini Cloud Assist para diferentes produtos.