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 Google Cloud console ou d'une API.

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

Les canaux de publication suivants sont disponibles :

• Disponibilité générale. Version disponible par défaut. Vous permet d'utiliser des modèles et des fonctionnalités en disponibilité générale. Notez qu'il est possible d'accéder à certaines fonctionnalités en version preview sans avoir à vous inscrire au canal Preview, en utilisant d'autres mécanismes d'inscription à la version preview. Ces fonctionnalités seront accessibles dans le canal en disponibilité générale, mais seront toujours couvertes par les Conditions des offres pré-DG.

• Preview. Vous permet d'accéder à certaines fonctionnalités en version preview pour 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 version disponible Preview.

  Lorsque vous activez le version disponible 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 Google Cloud Conditions spécifiques du service de la plate-forme. 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 requises pour définir ou modifier votre version disponible Gemini Code Assist.

Avant de commencer

• Vérifiez que votre Google Cloud projetest 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 version disponible, 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 prompts et des réponses à l'aide d'une API :
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
• Afficher les paramètres d'administrateur 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 Google Cloud console, 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 version disponible qui répond le mieux à vos besoins :

   Preview

   1. Sélectionnez Preview.
   2. Consultez les détails du version disponible 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 du version disponible 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 Preview ou STABLE pour 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 de paramètre unique, par exemple rc1 pour Release Channel.

      Le résultat affiche le 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 version disponible :

        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: 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 de paramètre du version disponible :

      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 la liaison de paramètre du canal de publication fourni dans la réponse à l'étape précédente.

2. Facultatif : Créez le paramètre de partage des prompts 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 de paramètre unique, par exemple dswg1 pour Data Sharing with Google

      Le résultat affiche le 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 de paramètre du prompt et de la 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: 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 de paramètre du prompt et de la 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 de paramètre du prompt et de la réponse fourni dans la réponse à l'étape précédente.

Étape suivante

• En savoir plus sur les tarifs de Gemini Code Assist.
• Affichez les autres paramètres d'administrateur Gemini Code Assist.