Configurare i canali di rilascio di Gemini Code Assist

Questo documento descrive come configurare i canali di rilascio di Gemini Code Assist per un progetto utilizzando la console Google Cloud o un'API.

Rilasciamo le funzionalità di Gemini Code Assist in diversi canali di rilascio. Puoi impostare ogni Google Cloud progetto su un singolo canale di rilascio a seconda dell'equilibrio scelto tra disponibilità e stabilità delle funzionalità. Gli utenti della tua organizzazione che utilizzano Gemini Code Assist nel loro IDE locale possono utilizzare funzionalità e modelli in base al canale di rilascio configurato per il progetto.

Sono disponibili i seguenti canali di rilascio:

  • In disponibilità generale. Il canale di rilascio predefinito. Consente di utilizzare modelli e funzionalità disponibili a livello generale. Tieni presente che è possibile accedere a determinate funzionalità di anteprima senza registrarsi al canale Anteprima, utilizzando meccanismi alternativi di registrazione all'anteprima. Queste funzionalità saranno accessibili all'interno del canale GA, ma sono ancora coperte dai Termini dell'offerta pre-GA.

  • Anteprima. Consente di accedere a determinate funzionalità di anteprima per Gemini Code Assist e, facoltativamente, fornire feedback e dati sull'utilizzo per aiutare Google a migliorare le release future. Tieni presente che al momento non sono presenti funzionalità distinte nel canale di rilascio dell'anteprima.

    Se attivi il canale di rilascio in anteprima in un progetto, accetti a nome del cliente che tutto l'utilizzo di Gemini Code Assist in questo progetto è soggetto ai Termini dell'offerta pre-GA dei Termini di servizio specifici della piattaforma.Google Cloud Non utilizzare questo canale per risorse e progetti non idonei all'utilizzo con le offerte pre-GA.

Le sezioni seguenti forniscono i passaggi necessari per impostare o modificare il canale di rilascio di Gemini Code Assist.

Prima di iniziare

Ruoli obbligatori

Per le autorizzazioni richieste per creare impostazioni e binding che controllano il canale di rilascio, chiedi all'amministratore di concederti il ruolo Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) sul progetto.

Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Configura i canali di rilascio utilizzando un'API:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • Configura la condivisione di prompt e risposte utilizzando un'API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Visualizza le impostazioni di Gemini per l'amministratore di Google Cloud :
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Configurare i canali di rilascio di Gemini Code Assist

Seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

    Viene caricata la pagina Gemini in Google Cloud.

  2. Fai clic su Impostazioni nel menu di navigazione.

    Viene caricata la pagina Impostazioni.

  3. Nella sezione Canali di rilascio per Gemini Code Assist negli IDE locali, seleziona il canale di rilascio più adatto alle tue esigenze:

    Anteprima

    1. Seleziona Anteprima.
    2. Controlla i dettagli del canale di rilascio dell'anteprima e i termini del programma Trusted Tester, quindi fai clic su Salva modifiche.

    In disponibilità generale

    1. Seleziona GA.
    2. Fai clic su Salva modifiche.

API

  1. Crea l'impostazione del canale di rilascio e un valore specifico dell'impostazione:

    1. Ottieni un token di autenticazione. Per ottenerlo, devi autenticarti utilizzando l'autenticazione gcloud CLI:

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

    2. Crea l'impostazione. Queste istruzioni utilizzano cURL per chiamare i metodi 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"

      Sostituisci quanto segue:

      • RELEASE_CHANNEL: il canale di rilascio, EXPERIMENTAL per l'anteprima o STABLE per la disponibilità generale.
      • CONTAINER_PROJECT_NAME: l'ID progetto del progetto in cui è archiviata la risorsa di binding. Questo è il progetto padre dell'associazione.
      • RC_SETTING_ID: un nome di impostazione univoco, ad esempio rc1 per Release Channel.

      L'output mostra releaseChannel impostato su 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. Crea l'associazione dell'impostazione del canale di rilascio:

        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"

      Sostituisci quanto segue:

      • TARGET_PROJECT_NAME: il progetto di destinazione a cui deve essere associata l'associazione. Spesso questo corrisponde al progetto contenitore. Tuttavia, puoi associare un'impostazione a più progetti in modo che la risorsa di impostazione non debba essere duplicata.
      • CONTAINER_PROJECT_NAME: l'ID progetto del progetto in cui è archiviata la risorsa di binding. Questo è il progetto padre dell'associazione.
      • RC_SETTING_ID: lo stesso RC_SETTING_ID che hai utilizzato quando hai creato l'impostazione, ma a cui è stato aggiunto b1. Ad esempio, utilizza rc1b1 per Release Channel.
      • RC_BINDING_ID: un nome univoco per l'associazione delle impostazioni, ad esempio rc_binding.

      L'output include i metadati dell'operazione nel seguente 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. (Facoltativo) Controlla lo stato della creazione del binding dell'impostazione del canale di rilascio:

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

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: l'ID progetto del progetto in cui è archiviata la risorsa di binding. Questo è il progetto padre dell'associazione.
      • RC_BINDING_OPERATION_ID: l'ID operazione di creazione dell'associazione dell'impostazione del canale di rilascio fornito nella risposta del passaggio precedente.

  2. (Facoltativo) Crea l'impostazione di condivisione del prompt e della risposta e un valore specifico per l'impostazione:

    1. Ottieni il token:

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

    2. Crea l'impostazione:

      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"

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: l'ID progetto principale
      • DSWG_SETTING_ID: un nome univoco per l'impostazione, ad esempio dswg1 per Data Sharing with Google

      L'output mostra enablePreviewDataSharing impostato su 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. Crea l'associazione dell'impostazione di prompt e risposta:

        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"

      Sostituisci quanto segue:

      • TARGET_PROJECT_NAME: il progetto di destinazione a cui deve essere applicata l'impostazione.
      • CONTAINER_PROJECT_NAME: l'ID progetto principale.
      • DSWG_SETTING_ID: lo stesso DSWG_SETTING_ID che hai utilizzato quando hai creato l'impostazione, ma a cui è stato aggiunto b1. Ad esempio, utilizza dswg1b1 per Data Sharing with Google.
      • DSWG_BINDING_ID: un nome univoco per l'associazione delle impostazioni, ad esempio dswg_binding.

      L'output include i metadati dell'operazione nel seguente 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. (Facoltativo) Controlla lo stato della creazione del binding dell'impostazione di prompt e risposta:

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

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: l'ID progetto del progetto in cui è archiviata la risorsa di binding. Questo è il progetto padre dell'associazione.
      • DSWG_BINDING_OPERATION_ID: l'ID operazione di creazione del binding dell'impostazione di prompt e risposta fornito nella risposta del passaggio precedente.

Passaggi successivi