Configurar o Gemini Cloud Assist

Para habilitar o uso do Gemini Cloud Assist, o administrador precisar fazer a configuração descrita neste documento. O Gemini Cloud Assist pode ser configurado para um projeto ou uma pasta.

Configurar o Gemini Cloud Assist para um projeto

Siga estas etapas para configurar o Gemini Cloud Assist para um projeto no console do Google Cloud ou com a CLI do Google Cloud.

Console

Acesse a página Admin do Gemini.

Acessar o Gemini para Google Cloud
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 Usar o Gemini Cloud Assist, faça o seguinte:
1. Selecione a seta de expansão na seção APIs necessárias e recomendadas.
2. Ative estas APIs obrigatórias: 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 custos financeiros.
Clique em Salvar.
Conceda os papéis do IAM necessários para usar o Gemini Cloud Assist.
1. Acesse a página IAM e administrador.
  
  Acessar IAM e administrador
2. Na coluna Principal, encontre a principal que deverá acessar o Gemini Cloud Assist e clique em Editar principal nessa linha.
3. No painel Editar acesso, clique em Adicionar outro papel.
4. Em Selecionar papel, selecione Usuário do Gemini Cloud Assist.
5. Clique em Adicionar outro papel e selecione Leitor do recomendador.
Se a principal quiser receber ajuda com produtos a que ainda não tem acesso, talvez seja necessário conceder mais funções do IAM a ela. O artigo Requisitos do IAM para usar o Gemini Cloud Assist contém uma tabela dos papéis do IAM que melhoram a experiência do Gemini Cloud Assist em diferentes produtos.

gcloud

In the Google Cloud console, activate Cloud Shell.

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.

Para ativar a API Gemini Cloud Assist em outro projeto doGoogle Cloud , 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.
```
Conceda papéis do IAM em um projeto do Google Cloud . Saiba mais em 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:
  - PROJECT_ID: o ID do seu projetoGoogle Cloud . Por exemplo, 1234567890.
  - PRINCIPAL: o identificador do principal. Por exemplo, user:cloudysanfrancisco@gmail.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 o papel roles/recommender.viewer.
Se a principal quiser receber ajuda com produtos a que ainda não tem acesso, talvez seja necessário conceder mais funções do IAM a ela. O artigo Requisitos do IAM para usar o Gemini Cloud Assist contém uma tabela dos papéis do IAM que melhoram a experiência do Gemini Cloud Assist em diferentes produtos.

API

Nestas instruções, usamos cURL para chamar métodos de API.

Ative 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 em que você está ativando o Gemini Cloud Assist.

Se for bem-sucedido, o comando vai retornar long-running operation, que inclui o campo name. Use o valor do campo name para verificar o status da operação.

Observação: ao ativar o serviço geminicloudassist.googleapis.com, você também ativa o serviço cloudaicompanion.googleapis.com, que é necessário para usar o Gemini Cloud Assist.
Conceda papéis do IAM para o projeto do Google Cloud associado.
1. Crie um arquivo JSON com as informações a seguir:
```
  {
    "options": {
      "requestedPolicyVersion": 3
    }
  }
```
2. Recupere a política do IAM atual do 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:
  - JSON_FILE_NAME: o caminho para o arquivo JSON que você criou na etapa anterior.
  - PROJECT_ID: o ID do projeto.
  Se o comando for bem-sucedido, a resposta será a política do IAM do projeto.
3. Copie a política do IAM do projeto para um arquivo JSON vazio e adicione as seguintes informações ao conteúdo atual:
```
  {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/recommender.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }
```
  Substitua PRINCIPAL pelo identificador do principal que deverá acessar o 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:
  - JSON_FILE_NAME: o caminho para o arquivo JSON que você criou na etapa anterior.
  - PROJECT_ID: o ID do projeto.
  Se o comando for bem-sucedido, a resposta será a política do IAM atualizada do projeto.
Se a principal quiser receber ajuda com produtos a que ainda não tem acesso, talvez seja necessário conceder mais papéis do IAM a ela. O artigo Requisitos do IAM para usar o Gemini Cloud Assist contém uma tabela dos papéis do IAM que melhoram a experiência do Gemini Cloud Assist em diferentes produtos.

Configurar o Gemini Cloud Assist para uma pasta

Estas são as etapas para configurar o Gemini Cloud Assist para uma pasta usando o console do Google Cloud . Não é possível usar a CLI do Google Cloud nem a API para isso.

Ative as APIs obrigatórias e recomendadas.
1. Acesse a página Admin do Gemini.
  
  Acessar Admin do Gemini
2. No seletor de projetos na parte de cima da página, selecione o recurso de pasta.
3. Selecione Ativar APIs Cloud Assist.
  
  A caixa de diálogo Ativar a API para projetos atuais na pasta aparece.
4. Na caixa de diálogo Ativar a API para projetos atuais na pasta, selecione a seta de expansão da seção APIs necessárias e recomendadas.
5. Na lista APIs recomendadas, selecione as APIs opcionais que você quer ativar.
6. Opcional: selecione Ajude o Google a melhorar o Cloud Assist compartilhando seus comandos e respostas.
7. Selecione Ativar o Gemini Cloud Assist sem custos financeiros.
  
  Com isso, as APIs necessárias e recomendadas selecionadas serão ativadas para todos os projetos na pasta. Se quiser bloquear a ativação da API para alguns projetos da pasta, estabeleça uma limitação de política organizacional do tipo Restringir o uso do serviço de recursos para esses projetos. Saiba mais em Como restringir locais de recursos.
Conceda os seguintes papéis do IAM ou crie papéis personalizados com permissões equivalentes na pasta:
- Usuário do Cloud Assist
- Leitor de recursos do Cloud
- Leitor do recomendador
Se a principal quiser receber ajuda com produtos a que ainda não tem acesso, talvez seja necessário conceder mais funções do IAM a ela. O artigo Requisitos do IAM para usar o Gemini Cloud Assist contém uma tabela dos papéis do IAM que melhoram a experiência do Gemini Cloud Assist em diferentes produtos.
Se você usa o Gemini Cloud Assist com aplicativos, também precisa ativar o gerenciamento de aplicativos. Um projeto de gerenciamento será criado, e você deverá vincular uma conta de faturamento a ele.
1. Volte à página Admin do Gemini.
  
  Acessar Admin 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 de apps da página.
  
  A caixa de diálogo Ativar APIs de aplicativos nesta pasta aparece.
4. Selecione Ativar.
  
  Uma barra de status mostra o progresso da ativação da API. A página de configurações IAM e administrador é atualizada quando a ativação da API é concluída.
5. Selecione Gerenciar o faturamento.
  
  A página Conta vinculada é exibida.
6. 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:
1. Volte à página Admin do Gemini.
  
  Acessar Admin do Gemini
2. No seletor de projetos na parte de cima da página, selecione o recurso de pasta.
3. Selecione Gerenciar as configurações do Gemini Cloud Assist.
  
  A caixa de diálogo Gerenciar o Gemini Cloud Assist é exibida.
4. Anote o projeto de gerenciamento.
(Opcional) Configure as configurações dos projetos na pasta.

A seguir

Conheça os preços do Gemini Cloud Assist.
Saiba como usar o painel do Cloud Assist no console Google Cloud .