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 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 :

  • Disponible pour tous les utilisateurs Version disponible par défaut. Vous permet d'utiliser des modèles et des fonctionnalités disponibles pour tous les utilisateurs. Notez qu'il est possible d'accéder à certaines fonctionnalités en version preview sans vous inscrire au canal Preview, en utilisant d'autres mécanismes d'inscription à la version preview. Ces fonctionnalités seront accessibles dans le canal DG, 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.

    Lorsque vous activez le version disponible de la version preview sur 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 pré-DG.

Les sections suivantes décrivent les étapes à suivre pour définir ou modifier votre version disponible Gemini Code Assist.

Avant de commencer

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 Code Assist :
    • 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 à la page "Administration de Gemini"

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

  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.

    Disponible pour tous les utilisateurs

    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 vous authentifier à 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 Disponible pour tous les utilisateurs.
      • 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 indique que releaseChannel est 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é lors de la création du paramètre, mais avec b1 ajouté à la fin. 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 indique que enablePreviewDataSharing est 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é lors de la création du paramètre, mais avec b1 ajouté à la fin. 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