Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 Google Cloud console o un'API.

Le funzionalità di Gemini Code Assist vengono rilasciate in diversi canali di rilascio. Puoi impostare ogni Google Cloud progetto su un singolo canale di rilascio a seconda del bilanciamento 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à in disponibilità generale. Tieni presente che è possibile accedere a determinate funzionalità di anteprima senza attivare il canale di anteprima, utilizzando meccanismi alternativi di registrazione all'anteprima. Queste funzionalità saranno accessibili all'interno del canale GA, ma sono comunque coperte dai Termini dell'offerta pre-GA.
Anteprima. Consente di accedere a determinate funzionalità di anteprima per Gemini Code Assist e, facoltativamente, di 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 in anteprima.

Se attivi il canale di rilascio in anteprima in un progetto, accetti a nome del cliente che l'utilizzo di Gemini Code Assist in questo progetto è soggetto ai Termini dell'offerta pre-GA dei Google Cloud Termini di servizio specifici della piattaforma. 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

Verifica che il tuo Google Cloud progetto sia collegato a un account di fatturazione. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti.

Ruoli obbligatori

Per le autorizzazioni necessarie per creare impostazioni e binding che controllano il canale di rilascio, chiedi all'amministratore di concederti il ruolo Amministratore delle impostazioni di Gemini in Google Cloud (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' Google Cloud amministratore:

cloudaicompanion.instances.queryEffectiveSetting
cloudaicompanion.instances.queryEffectiveSettingBindings

Configura i canali di rilascio di Gemini Code Assist

Seleziona una delle seguenti opzioni:

Console

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

Vai a Gemini in Google Cloud

Viene caricata la pagina Gemini in Google Cloud.
Fai clic su Impostazioni nel menu di navigazione.

Viene caricata la pagina Impostazioni.
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. Esamina i dettagli del canale di rilascio in 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

Crea l'impostazione del canale di rilascio e un valore specifico per l'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 del binding.
  - 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 il binding 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 associato il binding. Spesso è lo stesso del 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 del binding.
  - RC_SETTING_ID: lo stesso RC_SETTING_ID che hai utilizzato quando hai creato l'impostazione, ma con l'aggiunta di b1. Ad esempio, utilizza rc1b1 per Release Channel.
  - RC_BINDING_ID: un nome univoco per il binding 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 del binding.
  - RC_BINDING_OPERATION_ID: l'ID operazione di creazione del binding dell'impostazione del canale di rilascio fornito nella risposta nel passaggio precedente.

(Facoltativo) Crea l'impostazione di condivisione di prompt e risposte e un valore specifico per l'impostazione:

Ottieni il token:

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

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 padre
DSWG_SETTING_ID: un nome di impostazione univoco, 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
}

Crea il binding dell'impostazione di prompt e risposte:

  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 padre.
DSWG_SETTING_ID: lo stesso DSWG_SETTING_ID che hai utilizzato quando hai creato l'impostazione, ma con l'aggiunta di b1. Ad esempio, utilizza dswg1b1 per Data Sharing with Google.
DSWG_BINDING_ID: un nome univoco per il binding 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
}

(Facoltativo) Controlla lo stato della creazione del binding dell'impostazione di prompt e risposte:
```
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 del binding.
- DSWG_BINDING_OPERATION_ID: l'ID operazione di creazione del binding dell'impostazione di prompt e risposte fornito nella risposta nel passaggio precedente.

Passaggi successivi

Scopri di più sui prezzi di Gemini Code Assist.
Visualizza altre impostazioni di amministratore di Gemini Code Assist.

Configurare i canali di rilascio di Gemini Code Assist Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.