Configurer les canaux de publication Gemini Code Assist

Ce document explique comment configurer les canaux de publication Gemini Code Assist pour un projet à l'aide de la console Google Cloud ou d'une API.

Nous publions les fonctionnalités Gemini Code Assist dans différents canaux de publication. Vous pouvez définir un seul canal de publication pour chaque projet Google Cloud , en fonction de l'équilibre que vous souhaitez trouver entre la disponibilité et la stabilité des fonctionnalités. Les utilisateurs de votre organisation qui utilisent Gemini Code Assist dans leur IDE local peuvent utiliser des fonctionnalités et des modèles basés sur le canal de publication configuré pour le projet.

Les canaux de publication suivants sont disponibles :

• Disponibilité générale Version disponible par défaut. Vous permet d'utiliser les modèles et fonctionnalités en disponibilité générale. Notez qu'il est possible d'accéder à certaines fonctionnalités en preview sans s'inscrire à la chaîne Preview, en utilisant d'autres mécanismes d'inscription à la preview. Ces fonctionnalités seront accessibles dans le canal de disponibilité générale, mais resteront soumises aux conditions des offres de pré-DG.

• Aperçu Vous permet d'accéder à certaines fonctionnalités en avant-première de Gemini Code Assist et, si vous le souhaitez, de fournir des commentaires et des données d'utilisation pour aider Google à améliorer les futures versions. Notez qu'il n'existe actuellement aucune fonctionnalité distincte dans le canal de diffusion Preview.

  Lorsque vous activez le canal de publication en version preview pour un projet, vous acceptez pour le compte du client que toute utilisation de Gemini Code Assist dans ce projet soit soumise aux Conditions des offres de pré-DG des Conditions spécifiques du service de la plate-formeGoogle Cloud . N'utilisez pas ce canal pour les projets et ressources qui ne peuvent pas être utilisés avec des offres de pré-DG.

Les sections suivantes décrivent les étapes à suivre pour définir ou modifier votre canal de diffusion Gemini Code Assist.

Avant de commencer

• Vérifiez que votre projet Google Cloud est associé à un compte de facturation. Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets.

Rôles requis

Pour obtenir les autorisations requises pour créer des paramètres et des liaisons qui contrôlent le canal de publication, demandez à votre administrateur de vous accorder le rôle Administrateur des paramètres Gemini pour Google Cloud (roles/cloudaicompanion.settingsAdmin) sur le projet.

Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

• cloudaicompanion.releaseChannelSettings.create
• cloudaicompanion.releaseChannelSettings.delete
• cloudaicompanion.releaseChannelSettings.get
• cloudaicompanion.releaseChannelSettings.list
• cloudaicompanion.releaseChannelSettings.update
• cloudaicompanion.dataSharingWithGoogleSettings.create
• Configurer les canaux de publication à l'aide d'une API :
• cloudaicompanion.settingBindings.releaseChannelSettingsCreate
• cloudaicompanion.settingBindings.releaseChannelSettingsDelete
• cloudaicompanion.settingBindings.releaseChannelSettingsGet
• cloudaicompanion.settingBindings.releaseChannelSettingsList
• cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
• cloudaicompanion.settingBindings.releaseChannelSettingsUse
• Configurer le partage des requêtes et des réponses à l'aide d'une API :
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
• Afficher les paramètres d'administrateur de Gemini pour Google Cloud  :
• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings

Configurer les canaux de publication Gemini Code Assist

Sélectionnez l'une des options suivantes :

Console

1. Dans la console Google Cloud , accédez à la page Administration de Gemini.

   Accéder à Gemini pour Google Cloud

   La page Gemini pour Google Cloud se charge.

2. Cliquez sur Paramètres dans le menu de navigation.

   La page Paramètres se charge.

3. Dans la section Canaux de publication pour Gemini Code Assist dans les IDE locaux, sélectionnez le canal de publication qui correspond le mieux à vos besoins :

   Aperçu

   1. Sélectionnez Aperçu.
   2. Consultez les détails du canal de version Preview et les conditions du programme Trusted Tester, puis cliquez sur Enregistrer les modifications.

   Disponibilité générale

   1. Sélectionnez GA.
   2. Cliquez sur Enregistrer les modifications.

API

1. Créez le paramètre de canal de publication et une valeur spécifique à ce paramètre :

   1. Obtenez un jeton d'authentification. Vous devez être authentifié à l'aide de l'authentification gcloud CLI pour l'obtenir :

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

   2. Créez le paramètre. Ces instructions utilisent cURL pour appeler les méthodes d'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"
      

      Remplacez les éléments suivants :

      • RELEASE_CHANNEL : canal de publication, EXPERIMENTAL pour l'aperçu ou STABLE pour la disponibilité générale.
      • CONTAINER_PROJECT_NAME : ID du projet dans lequel la ressource de liaison est stockée. Il s'agit du projet parent de la liaison.
      • RC_SETTING_ID : nom unique du paramètre, par exemple rc1 pour Release Channel.

      Le résultat affiche releaseChannel défini sur 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. Créez la liaison de paramètre du canal de publication :

        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"
      

      Remplacez les éléments suivants :

      • TARGET_PROJECT_NAME : projet cible auquel la liaison doit être associée. Il s'agit souvent du projet de conteneur. Toutefois, vous pouvez associer un paramètre à plusieurs projets afin que la ressource de paramètre n'ait pas besoin d'être dupliquée.
      • CONTAINER_PROJECT_NAME : ID du projet dans lequel la ressource de liaison est stockée. Il s'agit du projet parent de la liaison.
      • RC_SETTING_ID : le même RC_SETTING_ID que celui que vous avez utilisé pour créer le paramètre, mais avec b1 ajouté. Par exemple, utilisez rc1b1 pour Release Channel.
      • RC_BINDING_ID : nom unique de la liaison de paramètres, par exemple rc_binding.

      Le résultat inclut les métadonnées de l'opération au format suivant :

      {
        "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. Facultatif : Vérifiez l'état de la création de la liaison du paramètre de canal de version :

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

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT_NAME : ID du projet dans lequel la ressource de liaison est stockée. Il s'agit du projet parent de la liaison.
      • RC_BINDING_OPERATION_ID : ID de l'opération de création de liaison du paramètre de canal de version fourni dans la réponse à l'étape précédente.

2. Facultatif : Créez le paramètre de partage des requêtes et des réponses, ainsi qu'une valeur spécifique à ce paramètre :

   1. Obtenez le jeton :

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

   2. Créez le paramètre :

      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"
      

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT_NAME : ID du projet parent
      • DSWG_SETTING_ID : nom unique du paramètre, par exemple dswg1 pour Data Sharing with Google

      Le résultat affiche enablePreviewDataSharing défini sur 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. Créez la liaison du paramètre de requête et de réponse :

        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"
      

      Remplacez les éléments suivants :

      • TARGET_PROJECT_NAME : projet cible auquel le paramètre doit être appliqué.
      • CONTAINER_PROJECT_NAME : ID du projet parent.
      • DSWG_SETTING_ID : le même DSWG_SETTING_ID que celui que vous avez utilisé pour créer le paramètre, mais avec b1 ajouté. Par exemple, utilisez dswg1b1 pour Data Sharing with Google.
      • DSWG_BINDING_ID : nom unique de la liaison de paramètres, par exemple dswg_binding.

      Le résultat inclut les métadonnées de l'opération au format suivant :

      {
      "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. Facultatif : Vérifiez l'état de la création de la liaison du paramètre de requête et de réponse :

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

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT_NAME : ID du projet dans lequel la ressource de liaison est stockée. Il s'agit du projet parent de la liaison.
      • DSWG_BINDING_OPERATION_ID : ID de l'opération de création de la liaison du paramètre d'invite et de réponse fourni dans la réponse à l'étape précédente.

Étapes suivantes

• Découvrez les tarifs de Gemini Code Assist.
• Affichez les autres paramètres d'administrateur Gemini Code Assist.