Configurer le partage des prompts 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.

Lorsqu'il est activé, Google traite les requêtes et les réponses de tous les utilisateurs de Gemini Cloud Assist dans le projet afin d'améliorer le produit. 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 les modèles LLM.

Vous pouvez modifier ce paramètre à tout moment.

Avant de commencer

Pour obtenir les autorisations requises pour configurer le partage des requêtes et des réponses pour Gemini Cloud Assist, demandez à votre administrateur de vous attribuer le rôle IAM (Identity and Access Management) prédéfini Administrateur Gemini Cloud Assist (roles/geminicloudassist.admin), qui inclut toutes les autorisations requises pour afficher et modifier les paramètres d'administrateur de Gemini Cloud Assist.

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

Autorisations requises

  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • cloudaicompanion.dataSharingWithGoogleSettings.update
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
    • Si vous utilisez des requêtes API directes, cette autorisation est requise spécifiquement pour TARGET_PROJECT.

Voici d'autres autorisations requises si vous utilisez la console Google Cloud  :

  • cloudaicompanion.instance.queryEffectiveSetting
  • cloudaicompanion.instance.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • settingBindings.dataSharingWithGoogleSettingsUpdate
  • settingBindings.dataSharingWithGoogleSettingsDelete

Vous pouvez également obtenir ces autorisations avec d'autres rôles prédéfinis ou rôles personnalisés.

Activer le partage des prompts et des réponses pour Gemini Cloud Assist

Sélectionnez l'une des options suivantes :

Console

  1. Ouvrez la console Google Cloud .

    Accéder à la console Google Cloud

  2. Sur n'importe quelle page de la console Google Cloud , cliquez sur spark Ouvrir ou fermer le chat Gemini Cloud Assist.

    Le panneau Cloud Assist s'ouvre.

  3. Cliquez sur Autres actions (), puis sur Paramètres Cloud Assist dans le menu déroulant.

    Le panneau de paramètres Gérer Gemini Cloud Assist s'ouvre.

  4. Dans la section Partage de données pour Gemini Cloud Assist, assurez-vous que l'option Aider Google à améliorer Gemini Cloud Assist en partageant vos requêtes et réponses est sélectionnée.

  5. Cliquez sur Enregistrer.

API

Pour activer le partage des données pour Gemini Cloud Assist, créez un paramètre avec la méthode dataSharingWithGoogleSettings.create et appliquez-le à l'aide de la méthode settingBindings.create associée.

  1. 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.

  2. 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 aboutit, 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 prompts et des réponses pour Gemini Cloud Assist

Sélectionnez l'une des options suivantes :

Console

  1. Ouvrez la console Google Cloud .

    Accéder à la console Google Cloud

  2. Sur n'importe quelle page de la console Google Cloud , cliquez sur spark Ouvrir ou fermer le chat Gemini Cloud Assist.

    Le panneau Cloud Assist s'ouvre.

  3. Cliquez sur Autres actions (), puis sur Paramètres Cloud Assist dans le menu déroulant.

    Le panneau de paramètres Gérer Gemini Cloud Assist s'ouvre.

  4. Dans la section Partage de données pour Gemini Cloud Assist, assurez-vous que l'option Aider Google à améliorer Gemini Cloud Assist en partageant vos requêtes et réponses n'est pas sélectionnée.

  5. Cliquez sur Enregistrer.

API

Pour désactiver le partage des requêtes et des réponses pour Gemini Cloud Assist, utilisez la méthode dataSharingWithGoogleSettings.patch.

  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 n'aboutit que si vous avez créé la ressource de paramètre quand vous avez activé le partage des prompts 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