Configurar o Gemini Cloud Assist no Cloud Billing

Para configurar o Gemini Cloud Assist no Cloud Billing, siga estas etapas:

  1. Ative a API Gemini Cloud Assist em um Google Cloud projeto. Geralmente, essa etapa é realizada por um administrador.

  2. No projeto Google Cloud , conceda papéis do Identity and Access Management (IAM) aos mesmos usuários que acessam os dados de custo e utilização do Cloud Billing. Geralmente, essa etapa é realizada por um administrador.

  3. Para usuários que precisam acessar os dados do Cloud Billing e o Gemini Cloud Assist no Cloud Billing, conceda funções do IAM na conta do Cloud Billing que está vinculada ao projeto em que a API Gemini Cloud Assist está ativada. Geralmente, essa etapa é realizada por um administrador.

Ativar a API Gemini Cloud Assist em um projeto do Google Cloud

Esta seção descreve as etapas necessárias para ativar a API Gemini Cloud Assist em um projeto Google Cloud .

Console

  1. Para ativar a API Gemini Cloud Assist, acesse a página API Gemini Cloud Assist.

    Acessar a API Gemini Cloud Assist

  2. No seletor de projetos, selecione o que você quer usar como um projeto "Gemini".

    É possível ativar a API Gemini Cloud Assist em mais de um projeto. Para usuários do Cloud Billing que têm permissões no nível da conta de faturamento na conta do Cloud Billing, recomendamos que você use um projeto de administração do FinOps para conter a API.

  3. Clique em Ativar.

    A página é atualizada e mostra o status API ativada.

gcloud

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

    Activate Cloud Shell

  2. No menu do seletor de projetos, selecione o projeto que você quer usar como um projeto "Gemini".

    É possível ativar a API Gemini Cloud Assist em mais de um projeto. Para usuários do Cloud Billing que têm permissões no nível da conta de faturamento na conta do Cloud Billing, recomendamos que você use um projeto de administração do FinOps para conter a API.

  3. Ative a API Gemini Cloud Assist usando o comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Se você quiser ativar a API Gemini Cloud Assist em um projeto Google Cloud diferente, adicione o parâmetro --project:

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

    Substitua PROJECT_ID pelo ID do projeto Google Cloud .

    O resultado será assim:

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

Depois de ativar a API Gemini Cloud Assist no projeto Google Cloud especificado, o Gemini Cloud Assist vai estar disponível para todos os usuários que tiverem as funções de IAM necessárias no projeto especificado.

Conceder papéis do IAM em um Google Cloud projeto

Esta seção descreve as etapas para conceder as permissões necessárias do projeto para usar o Gemini Cloud Assist. No projeto Google Cloud em que você ativou a API Gemini Cloud Assist, conceda os seguintes papéis do IAM aos usuários (principais) no projeto:

  • Usuário do Gemini Cloud Assist
  • Consumidor do Service Usage

Console

  1. Para conceder os papéis do IAM necessários para usar o Gemini Cloud Assist, acesse a página IAM e administrador.

    Acessar IAM e administrador

  2. Na coluna Principal, encontre uma principal para a qual você quer ativar o 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 Consumidor do Service Usage.

  6. Clique em Salvar.

gcloud

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

    Activate Cloud Shell

  2. No menu do seletor de projetos, selecione um projeto.

  3. Conceda o papel Usuário do Gemini Cloud Assist:

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

    Substitua:

    • PROJECT_ID: o ID do projeto Google 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

  4. Repita a etapa anterior para a função roles/serviceusage.serviceUsageConsumer.

Para mais informações, consulte Conceder um único papel e gcloud projects add-iam-policy-binding.

Todos os usuários (principais) que receberam essas funções podem acessar os recursos do Gemini Cloud Assist no console Google Cloud no projeto especificado. Se os usuários do projeto também tiverem acesso para visualizar os dados do Cloud Billing, eles poderão usar o Gemini Cloud Assist nos relatórios do Cloud Billing e no FinOps Hub para receber assistência de IA na criação de relatórios de custos e para resumir os principais insights sobre custos e recomendações de otimização da nuvem. Para mais informações, consulte Visão geral do Gemini Cloud Assist no Cloud Billing.

Tarefas avançadas de configuração do IAM para projetos

Em vez de usar o console do Google Cloud ou a gcloud CLI para conceder papéis predefinidos do IAM em um projeto, faça o seguinte:

  • Use APIs REST do IAM ou bibliotecas de cliente do IAM para conceder papéis.

    Se você usar essas interfaces, use os nomes de função totalmente qualificados:

    • roles/geminicloudassist.user
    • roles/serviceusage.serviceUsageConsumer

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  • Criar e conceder funções personalizadas.

    Todos os papéis personalizados para permissões de projeto que você criar precisam das seguintes permissões para acessar o Gemini Cloud Assist:

    • geminicloudassist.companions.generateChat
    • geminicloudassist.companions.generateCode
    • serviceusage.services.use

Conceder papéis do IAM em uma conta do Cloud Billing

Para usuários que precisam acessar os dados de custo do Cloud Billing, é necessário conceder permissões na conta do Cloud Billing adequadas para acessar a página Relatórios e o hub de FinOps. Para usar o Gemini Cloud Assist no Cloud Billing, conceda aos usuários acesso à conta do Cloud Billing que está vinculada ao projeto em que a API Gemini Cloud Assist está ativada.

A seguir