Configurer le partage des requêtes et des réponses pour Gemini Cloud Assist

Ce document explique comment configurer le partage des requêtes et des réponses Gemini Cloud Assist pour un projet à l'aide de la console Google Cloud ou d'une API.

Avant de commencer

  • Vérifiez que votre projet Google Cloud est associé à un compte de facturation.

(Facultatif) Accorder des autorisations IAM

Pour configurer le partage des requêtes et des réponses pour Gemini Cloud Assist, vous devez disposer d'autorisations Identity and Access Management (IAM) spécifiques, détaillées dans les sections suivantes. Vérifiez que ces autorisations sont ajoutées aux rôles IAM personnalisés.

Vous pouvez également attribuer le rôle IAM prédéfini Administrateur des paramètres Gemini pour Google Cloud (roles/cloudaicompanion.settingsAdmin), qui inclut toutes les autorisations requises pour tous les paramètres d'administrateur Gemini pour Google Cloud .

Configurer le partage des requêtes et des réponses Gemini Cloud Assist

Les sections suivantes décrivent les étapes à suivre pour configurer Gemini Cloud Assist afin de partager les requêtes et les réponses de votre organisation avec Google pour améliorer le produit. Ce paramètre demande à Google de traiter les requêtes et les réponses de tous les utilisateurs de Gemini Cloud Assist dans le projet à des fins d'amélioration du produit, ce qui aide Google à améliorer Gemini Cloud Assist.

Par défaut, Google n'examine pas les requêtes que vos utilisateurs saisissent et envoient à Gemini Cloud Assist, ni les réponses qui leur sont renvoyées. Cela limite la capacité de Google à améliorer Gemini Cloud Assist en comprenant mieux les sujets importants pour votre organisation et la qualité de nos réponses. Si vous activez le partage des requêtes et des réponses pour un projet, Google stocke les requêtes et les réponses anonymisées envoyées depuis le projet pendant deux ans maximum. Les requêtes et les réponses de votre organisation ne sont jamais utilisées pour entraîner ni affiner aucun modèle LLM.

Si vous activez le partage des requêtes et des réponses avec Google, vous pouvez le désactiver à tout moment en accédant à la page Admin pour Gemini dans la console Google Cloud .

Activer le partage des requêtes et des réponses pour Gemini Cloud Assist

Sélectionnez l'une des options suivantes :

Console

  1. Vérifiez que vous disposez des autorisations Identity and Access Management (IAM) suivantes pour le projet propriétaire de l'abonnement :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Dans la console Google Cloud , accédez à la page Administration pour Gemini.

    Accéder à Gemini pour Google Cloud

    La page Gemini pour Google Cloud se charge.

  3. Cliquez sur Paramètres dans le menu de navigation de gauche.

    La page Paramètres se charge.

  4. Cliquez sur Activer le partage de données pour partager les requêtes et les réponses avec Google pour tous les utilisateurs de Gemini Cloud Assist dans le projet.

API

Pour activer le partage de données pour Gemini Cloud Assist, utilisez la méthode CreateDataSharingWithGoogleSetting.

  1. Vérifiez que vous disposez des autorisations Identity and Access Management (IAM) suivantes pour le projet propriétaire de l'abonnement :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Créez le paramètre et une valeur spécifique à ce paramètre :

    1. Obtenez un jeton d'authentification :

      TOKEN=$(gcloud auth print-access-token)
      
    2. Exécutez la commande suivante pour créer le paramètre :

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "enablePreviewDataSharing": true
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"
      

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT_NAME : saisissez l'ID du projet parent.
      • SETTING_ID : saisissez un nom de paramètre unique, tel que dswg1 pour Data Sharing with Google.

      Si la commande aboutit, elle renvoie un corps de réponse qui indique que enablePreviewDataSharing est défini sur true :

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": true
      }
      

      Pour en savoir plus sur l'authentification, consultez S'authentifier pour utiliser REST.

  3. Créez la liaison de paramètre :

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "target": "projects/TARGET_PROJECT_NAME",
          "product": "GEMINI_CLOUD_ASSIST"
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"
    

    Remplacez les éléments suivants :

    • TARGET_PROJECT_NAME : saisissez le projet cible auquel le paramètre doit être appliqué.
    • SETTING_ID : utilisez le même SETTING_ID que celui que vous avez utilisé pour créer le paramètre, mais ajoutez-y b1. Par exemple, utilisez dswg1b1 pour Data Sharing with Google.

    Si la commande réussit, elle renvoie les métadonnées de l'opération au format suivant :

    {
      "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
        "createTime": "2025-01-23T15:27:50.076075570Z",
        "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
    }
    

Désactiver le partage des requêtes et des réponses pour Gemini Cloud Assist

Sélectionnez l'une des options suivantes :

Console

  1. Vérifiez que vous disposez des autorisations IAM (Identity and Access Management) suivantes pour le projet dont vous souhaitez modifier les paramètres :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Dans la console Google Cloud , accédez à la page Administration pour Gemini.

    Accéder à Gemini pour Google Cloud

    La page Gemini pour Google Cloud se charge.

  3. Cliquez sur Paramètres dans le menu de navigation de gauche.

    La page Paramètres se charge.

  4. Cliquez sur Désactiver le partage de données pour ne plus partager les requêtes et les réponses avec Google pour tous les utilisateurs de Gemini Cloud Assist dans le projet.

API

Pour désactiver le partage de données pour Gemini Cloud Assist, utilisez la méthode DeleteDataSharingWithGoogleSetting.

  1. Vérifiez que vous disposez des autorisations IAM (Identity and Access Management) suivantes pour le projet dont vous souhaitez modifier les paramètres :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Désactivez le partage des requêtes et des réponses pour le paramètre spécifié :

    1. Obtenez le jeton :

      TOKEN=$(gcloud auth print-access-token)
      
    2. Exécutez la commande suivante pour désactiver le paramètre :

      curl -X PATCH \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "enablePreviewDataSharing": false
          } ' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"
      

      Cette commande PATCH ne réussit que si la ressource de paramètre existe déjà depuis que vous avez activé le partage des requêtes et des réponses.

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT_NAME : saisissez l'ID du projet parent.
      • SETTING_ID : saisissez le nom du paramètre existant, par exemple dswg1 pour Data Sharing with Google.

      Si la commande aboutit, elle renvoie un corps de réponse qui indique que enablePreviewDataSharing est défini sur false :

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": false
      }
      

Étapes suivantes