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 console do Google Cloud ou uma API.

Lançamos recursos do Gemini Code Assist em diferentes canais de lançamento. É possível definir cada projeto do Google Cloud 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 seguintes canais de lançamento estão disponíveis:

  • Disponibilidade geral. O canal de lançamento padrão. Permite usar modelos e recursos geralmente disponíveis. É possível acessar alguns recursos de pré-lançamento sem ativar o canal de pré-lançamento usando mecanismos alternativos de inscrição. Esses recursos vão estar acessíveis no canal GA, mas ainda serão cobertos pelos Termos das Ofertas Pré-GA.

  • Visualização. Permite acessar alguns 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. No momento, não há recursos distintos no canal de pré-lançamento.

    Ao ativar o canal 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 Pré-GA dos Termos de Serviço Específicos do Google Cloud Platform. Não use esse canal para projetos e recursos que não sejam adequados para uso com soluções pré-GA.

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

Antes de começar

Funções exigidas

Para ter 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 das configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) no projeto.

Para conferir 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
  • Configure 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
  • Confira as configurações de administrador do Gemini para Google Cloud:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Configurar canais de lançamento do Gemini Code Assist

Selecione uma das seguintes opções:

Console

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

    Acessar o Gemini para Google Cloud

    A página Gemini para Google Cloud é carregada.

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

    A página Configurações é carregada.

  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. Revise os detalhes do canal de lançamento da prévia e os termos do programa Trusted Tester 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. Consiga um token de autenticação. Você precisa fazer a autenticação usando a autenticação do gcloud para conseguir isso:

      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évia 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 exclusivo para a configuração. 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 quando você criou a configuração, mas com b1 adicionado. 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 da 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 da 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 exclusivo para a configuração. 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 comando e resposta:

        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 quando você criou a configuração, mas com b1 adicionado. 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ções 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 de vinculação de configuração de solicitação e resposta fornecido na resposta na etapa anterior.