Release-Versionen für Gemini Code Assist konfigurieren

In diesem Dokument wird beschrieben, wie Sie die Release-Versionen für Gemini Code Assist für ein Projekt über die Google Cloud Console oder eine API konfigurieren.

Wir veröffentlichen Gemini Code Assist-Funktionen in verschiedenen Release-Versionen. Sie können für jedes Google Cloud -Projekt eine einzelne Release-Version festlegen, je nachdem, welches Verhältnis zwischen Funktionsverfügbarkeit und Stabilität Sie bevorzugen. Nutzer in Ihrer Organisation, die Gemini Code Assist in ihrer lokalen IDE verwenden, können Funktionen und Modelle nutzen, die auf der für das Projekt konfigurierten Release-Version basieren.

Die folgenden Release-Versionen sind verfügbar.

  • Allgemein verfügbar. Die Standard-Release-Version. Damit können Sie allgemein verfügbare Modelle und Funktionen verwenden. Bestimmte Funktionen in der Vorabversion können auch ohne Anmeldung für die Release-Version vom Typ „Vorabversion“ über alternative Registrierungsmöglichkeiten genutzt werden. Diese Funktionen sind über die GA-Version zugänglich, unterliegen aber weiterhin den Pre-GA-Angebotsbedingungen.

  • Vorabversion. Sie erhalten Zugriff auf bestimmte Funktionen in der Vorabversion für Gemini Code Assist und können optional Feedback und Nutzungsdaten weitergeben, damit Google zukünftige Releases verbessern kann. Derzeit gibt es in der Release-Version vom Typ „Vorabversion“ keine besonderen Funktionen.

    Wenn Sie die Release-Version vom Typ „Vorabversion“ für ein Projekt aktivieren, stimmen Sie im Namen des Kunden zu, dass die gesamte Nutzung von Gemini Code Assist in diesem Projekt den Pre-GA-Angebotsbedingungen der Google Cloud Platform-spezifischen Nutzungsbedingungen unterliegt. Verwenden Sie die Version nicht für Projekte und Ressourcen, die nicht für die Verwendung mit Pre-GA-Angeboten geeignet sind.

In den folgenden Abschnitten finden Sie die erforderlichen Schritte zum Festlegen oder Ändern Ihres Gemini Code Assist-Release-Versionen.

Vorbereitung

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen für das Projekt die Rolle „Gemini for Google Cloud Settings Admin“ (roles/cloudaicompanion.settingsAdmin) zuzuweisen, damit Sie die erforderlichen Berechtigungen zum Erstellen von Einstellungen und Bindungen erhalten, mit denen die Release-Version gesteuert wird.

Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die genauen erforderlichen Berechtigungen zu sehen:

Erforderliche Berechtigungen

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Release-Versionen über eine API konfigurieren:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • Freigabe von Prompts und Antworten über eine API konfigurieren:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Administratoreinstellungen für Gemini für Google Cloud aufrufen:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Release-Versionen für Gemini Code Assist konfigurieren

Wählen Sie eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Administrator für Gemini auf.

    Zu Gemini for Google Cloud

    Die Seite Gemini for Google Cloud wird geladen.

  2. Klicken Sie im Navigationsmenü auf die Einstellungen.

    Die Seite mit den Einstellungen wird geladen.

  3. Wählen Sie im Bereich Release-Versionen für Gemini Code Assist in lokalen IDEs die Release-Version aus, die Ihren Anforderungen am besten entspricht:

    Vorabversion

    1. Wählen Sie Vorschau aus.
    2. Sehen Sie sich die Details zur Release-Version vom Typ „Vorabversion“ und die Bedingungen für das Trusted Tester-Programm an und klicken Sie dann auf Änderungen speichern.

    Allgemein verfügbar

    1. Wählen Sie GA aus.
    2. Klicken Sie auf Änderungen speichern.

API

  1. Erstellen Sie die Einstellung für die Release-Version sowie einen einstellungsspezifischen Wert:

    1. Rufen Sie einen Authentifizierungstoken ab. Sie müssen sich mit der gcloud CLI authentifizieren, um es zu erhalten:

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

    2. Erstellen Sie die Einstellung. In dieser Anleitung wird cURL verwendet, um API-Methoden aufzurufen.

        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"

      Ersetzen Sie Folgendes:

      • RELEASE_CHANNEL: die Release-Version, entweder EXPERIMENTAL für „Vorabversion“ oder STABLE für „Allgemein Verfügbar“.
      • CONTAINER_PROJECT_NAME: die ID des Projekts, in dem die Bindungsressource gespeichert ist. Dies ist das übergeordnete Projekt der Bindung.
      • RC_SETTING_ID: ein eindeutiger Name für die Einstellung, z. B. rc1 für Release Channel.

      Die Ausgabe zeigt, dass releaseChannel auf RELEASE_CHANNEL gesetzt ist:

      {
  "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. Erstellen Sie die Bindung für die Einstellung der Release-Version:

        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"

      Ersetzen Sie Folgendes:

      • TARGET_PROJECT_NAME: das Zielprojekt, an das die Bindung gebunden werden soll. Dieses ist oft identisch mit dem Containerprojekt. Sie können eine Einstellung jedoch an mehrere Projekte binden, sodass die Einstellungsressource nicht dupliziert werden muss.
      • CONTAINER_PROJECT_NAME: die ID des Projekts, in dem die Bindungsressource gespeichert ist. Dies ist das übergeordnete Projekt der Bindung.
      • RC_SETTING_ID: die RC_SETTING_ID, die Sie beim Erstellen der Einstellung verwendet haben, aber mit angehängtem b1. Verwenden Sie beispielsweise rc1b1 für Release Channel.
      • RC_BINDING_ID: ein eindeutiger Name für die Bindung von Einstellungen, z. B. rc_binding.

      Die Ausgabe enthält die Vorgangsmetadaten im folgenden Format:

      {
  "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. Optional: Prüfen Sie den Status der Erstellung der Bindung für die Einstellung der Release-Version:

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

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: die ID des Projekts, in dem die Bindungsressource gespeichert ist. Dies ist das übergeordnete Projekt der Bindung.
      • RC_BINDING_OPERATION_ID: die ID des Vorgangs zum Erstellen der Bindung für die Einstellung der Release-Version, die in der Antwort im vorherigen Schritt angegeben wurde.

  2. Optional: Erstellen Sie die Einstellung für die Weitergabe von Prompts und Antworten sowie einen einstellungsspezifischen Wert:

    1. Rufen Sie das Token ab:

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

    2. Erstellen Sie die Einstellung:

      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"

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: die ID des übergeordneten Projekts
      • DSWG_SETTING_ID: ein eindeutiger Name für die Einstellung, z. B. dswg1 für Data Sharing with Google

      Die Ausgabe zeigt, dass enablePreviewDataSharing auf true gesetzt ist:

      {
  "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. Erstellen Sie die Bindung für die Prompt- und Antworteinstellung:

        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"

      Ersetzen Sie Folgendes:

      • TARGET_PROJECT_NAME: das Zielprojekt, auf das die Einstellung angewendet werden soll.
      • CONTAINER_PROJECT_NAME: die ID des übergeordneten Projekts.
      • DSWG_SETTING_ID: die DSWG_SETTING_ID, die Sie beim Erstellen der Einstellung verwendet haben, aber mit angehängtem b1. Verwenden Sie beispielsweise dswg1b1 für Data Sharing with Google.
      • DSWG_BINDING_ID: ein eindeutiger Name für die Bindung von Einstellungen, z. B. dswg_binding.

      Die Ausgabe enthält die Vorgangsmetadaten im folgenden Format:

      {
"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. Optional: Prüfen Sie den Status der Erstellung der Bindung für die Einstellung für Prompts und Antworten:

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

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: die ID des Projekts, in dem die Bindungsressource gespeichert ist. Dies ist das übergeordnete Projekt der Bindung.
      • DSWG_BINDING_OPERATION_ID: die ID des Vorgangs zum Erstellen der Bindung für die Prompt- und Antworteinstellungen, die in der Antwort im vorherigen Schritt angegeben wurde.

Weitere Informationen