Configurar canais de lançamento do Gemini Code Assist

Este documento descreve como configurar os canais de lançamento do Gemini Code Assist para um projeto usando o Google Cloud console ou uma API.

Lançamos os recursos do Gemini Code Assist em diferentes canais de lançamento. É possível definir cada Google Cloud projeto para um único canal de lançamento dependendo do equilíbrio escolhido entre disponibilidade e estabilidade de recursos. Os usuários da sua organização que usam o Gemini Code Assist no ambiente de desenvolvimento integrado local podem usar recursos e modelos com base no canal de lançamento configurado para o projeto.

Os canais de lançamento a seguir estão disponíveis:

• Disponibilidade geral. O canal de lançamento padrão. Permite usar modelos e recursos de disponibilidade geral. É possível acessar determinados recursos de pré-lançamento sem ativar o canal de pré-lançamento, usando mecanismos alternativos de inscrição. Esses recursos estarão acessíveis no canal de GA, mas ainda serão cobertos pelos Termos dos produtos e recursos em pré-GA.

• Pré-lançamento. Permite acessar determinados recursos de pré-lançamento do Gemini Code Assist e, opcionalmente, enviar feedback e dados de uso para ajudar o Google a melhorar as versões futuras. Observação: não há recursos distintos no canal de lançamento de pré-lançamento.

  Ao ativar o canal de lançamento de versão de pré-lançamento em um projeto, você concorda, em nome do cliente, que todo o uso do Gemini Code Assist nesse projeto está sujeito aos Termos da Oferta de produtos e recursos em pré-GA dos Google Cloud Termos de Serviço Específicos da Plataforma. Não use esse canal para projetos e recursos que não sejam adequados para uso com ofertas pré-GA.

As seções a seguir fornecem as etapas necessárias para definir ou mudar o canal de lançamento do Gemini Code Assist.

Antes de começar

• Verifique se o projeto do Google Cloud está vinculado a uma conta de faturamento. Para mais informações, consulte Verificar o status de faturamento dos seus projetos.

Funções exigidas

Para as permissões necessárias para criar configurações e vinculações que controlam o canal de lançamento, peça ao administrador para conceder a você o papel de administrador de configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) no projeto.

Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

• cloudaicompanion.releaseChannelSettings.create
• cloudaicompanion.releaseChannelSettings.delete
• cloudaicompanion.releaseChannelSettings.get
• cloudaicompanion.releaseChannelSettings.list
• cloudaicompanion.releaseChannelSettings.update
• cloudaicompanion.dataSharingWithGoogleSettings.create
• Configurar canais de lançamento usando uma API:
• cloudaicompanion.settingBindings.releaseChannelSettingsCreate
• cloudaicompanion.settingBindings.releaseChannelSettingsDelete
• cloudaicompanion.settingBindings.releaseChannelSettingsGet
• cloudaicompanion.settingBindings.releaseChannelSettingsList
• cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
• cloudaicompanion.settingBindings.releaseChannelSettingsUse
• Configurar o compartilhamento de comandos e respostas usando uma API:
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
• Ver as configurações de administrador do Gemini Code Assist:
• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings

Configurar canais de lançamento do Gemini Code Assist

Selecione uma das seguintes opções:

Console

1. No Google Cloud console do, acesse a página Admin do Gemini.

   Acessar Admin do Gemini

2. Clique em Configurações no menu de navegação.

3. Na seção Canais de lançamento do Gemini Code Assist em ambientes de desenvolvimento integrado locais , selecione o canal de lançamento que melhor atende às suas necessidades:

   Visualizar

   1. Selecione Visualizar.
   2. Analise os detalhes do canal de lançamento de pré-lançamento e os termos do programa de testadores confiáveis e clique em Salvar alterações.

   Disponibilidade geral

   1. Selecione GA.
   2. Clique em Salvar alterações.

API

1. Crie a configuração do canal de lançamento e um valor específico dela:

   1. Receba um token de autenticação. É necessário fazer a autenticação usando a CLI gcloud para recebê-lo:

      TOKEN=$(gcloud auth print-access-token)
      

   2. Crie a configuração. Estas instruções usam cURL para chamar métodos de API:

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
            "release_channel": "RELEASE_CHANNEL",
          } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"
      

      Substitua:

      • RELEASE_CHANNEL: o canal de lançamento, EXPERIMENTAL para pré-lançamento ou STABLE para disponibilidade geral.
      • CONTAINER_PROJECT_NAME: o ID do projeto em que o recurso de vinculação está armazenado. Esse é o projeto principal da vinculação.
      • RC_SETTING_ID: um nome de configuração exclusivo, por exemplo, rc1 para Release Channel.

      A saída mostra o releaseChannel definido como RELEASE_CHANNEL:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/releaseChannelSettings/RC_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "releaseChannel": RELEASE_CHANNEL
      }
      

   3. Crie a vinculação de configuração do canal de lançamento:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"
      

      Substitua:

      • TARGET_PROJECT_NAME: o projeto de destino a que a vinculação deve ser associada. Geralmente, é o mesmo que o projeto do contêiner. No entanto, é possível vincular uma configuração a vários projetos para que o recurso de configuração não precise ser duplicado.
      • CONTAINER_PROJECT_NAME: o ID do projeto em que o recurso de vinculação está armazenado. Esse é o projeto principal da vinculação.
      • RC_SETTING_ID: o mesmo RC_SETTING_ID usado ao criar a configuração, mas anexado com b1. Por exemplo, use rc1b1 para Release Channel.
      • RC_BINDING_ID: um nome exclusivo para a vinculação de configurações, por exemplo, rc_binding.

      A saída inclui os metadados da operação no seguinte formato:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
          "createTime": "2025-01-23T15:27:50.076075570Z",
          "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
          "verb": "create",
          "requestedCancellation": false,
          "apiVersion": "v1"
        },
        "done": false
      }
      

   4. Opcional: verifique o status da criação da vinculação de configuração do canal de lançamento:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID
      

      Substitua:

      • CONTAINER_PROJECT_NAME: o ID do projeto em que o recurso de vinculação está armazenado. Esse é o projeto principal da vinculação.
      • RC_BINDING_OPERATION_ID: o ID da operação de criação da vinculação de configuração do canal de lançamento fornecido na resposta na etapa anterior.

2. Opcional: crie a configuração de compartilhamento de comandos e respostas e um valor específico dela:

   1. Receba o token:

      TOKEN=$(gcloud auth print-access-token)
      

   2. Crie a configuração:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_preview_data_sharing": true,
        } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"
      

      Substitua:

      • CONTAINER_PROJECT_NAME: o ID do projeto principal
      • DSWG_SETTING_ID: um nome de configuração exclusivo, por exemplo, dswg1 para Data Sharing with Google

      A saída mostra o enablePreviewDataSharing definido como true:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": true
      }
      

   3. Crie a vinculação de configuração de comandos e respostas:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"
      

      Substitua:

      • TARGET_PROJECT_NAME: o projeto de destino a que a configuração deve ser aplicada.
      • CONTAINER_PROJECT_NAME: o ID do projeto principal.
      • DSWG_SETTING_ID: o mesmo DSWG_SETTING_ID usado ao criar a configuração, mas anexado com b1. Por exemplo, use dswg1b1 para Data Sharing with Google.
      • DSWG_BINDING_ID: um nome exclusivo para a vinculação de configurações, por exemplo, dswg_binding.

      A saída inclui os metadados da operação no seguinte formato:

      {
      "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
        "createTime": "2025-01-23T15:27:50.076075570Z",
        "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
      }
      

   4. Opcional: verifique o status da criação da vinculação de configuração de comandos e respostas:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID
      

      Substitua:

      • CONTAINER_PROJECT_NAME: o ID do projeto em que o recurso de vinculação está armazenado. Esse é o projeto principal da vinculação.
      • DSWG_BINDING_OPERATION_ID: o ID da operação de criação da vinculação de configuração de comandos e respostas fornecido na resposta na etapa anterior.

A seguir

• Saiba mais sobre os preços do Gemini Code Assist.
• Ver outras configurações de administrador do Gemini Code Assist.