Ativar as ferramentas do Gemini Code Assist

Este documento descreve como ativar as ferramentas do Gemini Code Assist. Google Cloud Os administradores precisam concluir estas etapas para ativar as ferramentas para desenvolvedores nos ambientes de desenvolvimento integrados.

Para mais informações sobre as ferramentas, leia a Visão geral das ferramentas do Gemini Code Assist. Para configurar ferramentas para uso no seu ambiente de desenvolvimento integrado, consulte Configurar ferramentas do Gemini Code Assist.

Antes de começar

  1. Configure o Gemini Code Assist.

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Enable the Developer Connect API.

    Enable the API

    O Developer Connect é usado para criar conexões entre contas de usuário e serviços da ferramenta Gemini Code Assist.

Funções exigidas

Para receber as permissões necessárias para ativar as ferramentas de assistência ao código do Gemini, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto Google Cloud :

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

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Ativar ferramentas

  1. No console do Google Cloud, acesse a página Tools (Ferramentas) do Gemini Code Assist.

    Acessar "Ferramentas"

  2. Localize a ferramenta que você quer ativar e clique em Ativar. A página de detalhes da ferramenta é aberta.

  3. Na seção Configuração, selecione uma região para criar o conector da conta do desenvolvedor para a ferramenta. As regiões disponíveis estão listadas em Locais do Developer Connect.

  4. Clique em Ativar.

    A ferramenta está ativada para seu projeto e está disponível para desenvolvedores nos IDEs.

    Você vai precisar se conectar à sua conta para usar a ferramenta no IDE. Se você quiser usar a ferramenta no ambiente de desenvolvimento integrado, clique em Conectar e siga as instruções para conectar sua conta. Você pode pular a etapa de conexão se não quiser usar a ferramenta.

  5. Para permitir que os usuários se autentiquem na ferramenta, crie uma função personalizada e conceda aos usuários.

    1. Crie um papel personalizado executando o seguinte comando:

      gcloud iam roles create ROLE_NAME \
    --project=PROJECT \
    --title="Gemini Code Assist Tools User" \
    --description="custom role for tools user" \
    --permissions=cloudaicompanion.codeToolsSettings.get,cloudaicompanion.codeToolsSettings.list,cloudaicompanion.settingBindings.codeToolsSettingsGet,cloudaicompanion.settingBindings.codeToolsSettingsList,cloudaicompanion.instances.queryEffectiveSetting

      Substitua:

      • ROLE_NAME pelo nome que você quer dar ao seu papel personalizado.
      • PROJECT pelo ID do projeto Google Cloud .

    2. Para conceder aos usuários o papel personalizado, execute o seguinte comando:

      gcloud projects add-iam-policy-binding PROJECT \
    --member=PRINCIPAL_TYPE:PRINCIPAL \
    --role=projects/PROJECT/roles/ROLE_NAME

      Substitua:

      • PROJECT pelo ID do projeto Google Cloud .
      • PRINCIPAL_TYPE com o tipo principal a que você quer conceder o papel personalizado. Para mais informações sobre tipos principais, consulte Identificadores principais.
      • PRINCIPAL pelo identificador do principal.

      • ROLE_NAME pelo nome que você deu à sua função personalizada.

        O exemplo a seguir concede o papel personalizado tools-user a um único usuário luka@example.com no projeto test-project:

        gcloud projects add-iam-policy-binding test-project \
    --member=user:luka@example.com \
    --role=projects/test-project/roles/tools-user

      Depois de conceder a função personalizada aos usuários, eles poderão fazer a autenticação nas ferramentas ativadas do Gemini Code Assist ao solicitar a ferramenta no chat do Gemini Code Assist com @TOOL_NAME. Em que TOOL_NAME é o nome da ferramenta.

A seguir