Configurer l'ancrage pour Gemini Cloud Assist

Ce document explique comment configurer l'ancrage pour Gemini Cloud Assist à l'aide de la Google Cloud console ou d'une API. L'ancrage est fourni par Vertex AI.

Types d'ancrage disponibles :

  • Ancrage avec la recherche Google (recommandé): demande à Gemini Cloud Assist d'utiliser la recherche Google pour obtenir les réponses les plus complètes et les plus récentes. Notez que certaines offres, comme la résidence des données, Access Transparency et les clés de chiffrement gérées par le client (CMEK), ne sont pas compatibles avec cette option.

  • Ancrage Web pour les entreprises: exploite un sous-ensemble limité de contenus Web. Bien que cela puisse entraîner des réponses de moins bonne qualité par rapport à l'ancrage avec la recherche Google, il s'agit de l'option privilégiée pour les secteurs hautement réglementés qui exigent une conformité stricte en matière de résidence des données, tels que la finance, la santé et le secteur public.

Par défaut, Gemini Cloud Assist utilise l'ancrage avec la recherche Google pour améliorer la qualité de ses réponses à vos prompts. L'utilisation de l'ancrage avec la recherche Google implique un traitement spécial des données pour vos prompts et vos réponses, comme décrit dans les Google Cloud Conditions d'utilisation du service.

Avant de commencer

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

  2. Vérifiez que Gemini Cloud Assist est configuré pour votre Google Cloud projet.

  3. Pour obtenir les autorisations requises pour configurer l'ancrage pour Gemini Cloud Assist, demandez à votre administrateur de vous accorder le rôle IAM (Identity and Access Management) Administrateur des paramètres de Gemini pour Google Cloud (roles/cloudaicompanion.settingsAdmin) sur votre projet. Ce rôle prédéfini contient les autorisations requises pour gérer les paramètres d'administrateur de Gemini Cloud Assist.

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

    Autorisations requises

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • Si vous utilisez des requêtes API directes, cette autorisation est requise spécifiquement pour le TARGET_PROJECT.

    Voici les autorisations supplémentaires requises si vous utilisez la Google Cloud console :

    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

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

Configurer l'ancrage pour Gemini Cloud Assist

Sélectionnez l'une des options suivantes :

Console

  1. Ouvrez la Google Cloud console.

    Accéder à la Google Cloud console

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

    Le panneau Cloud Assist s'ouvre.

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

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

  4. Sélectionnez l'option d'ancrage que vous souhaitez utiliser.

  5. Cliquez sur Enregistrer.

API

Pour configurer l'ancrage pour Gemini Cloud Assist à l'aide de l'API, vous créez une ressource geminiGcpEnablementSettings qui définit le type d'ancrage, à l'aide de la méthode geminiGcpEnablementSettings.create. Ensuite, vous appliquez le paramètre à l'aide de la méthode associée settingBindings.create pour lier le paramètre à un projet.

  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)

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

    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 '{
    "webGroundingType": "GROUNDING_TYPE"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      Remplacez les éléments suivants :

      • CONTAINER_PROJECT: ID du projet qui stocke les données de configuration.
      • GROUNDING_TYPE: type d'ancrage, à savoir GROUNDING_WITH_GOOGLE_SEARCH ou WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: nom unique permettant d'identifier ces données de configuration spécifiques, par exemple gt1.

      Si la commande aboutit, elle renvoie un corps de réponse qui indique que webGroundingType est défini sur votre sélection :

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "webGroundingType": "GROUNDING_TYPE"
}

  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",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

    Remplacez les éléments suivants :

    • TARGET_PROJECT: ID du projet auquel le paramètre doit être appliqué. En règle générale, le projet cible et le projet de conteneur sont identiques.
    • CONTAINER_PROJECT: ID du projet qui stocke les données de configuration.
    • GROUNDING_SETTING_ID: GROUNDING_SETTING_ID que vous avez spécifié lors de la création du paramètre.
    • GROUNDING_BINDING_ID: ID unique permettant d'identifier cette ressource de liaison de paramètre spécifique, par exemple b1.

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

    {
  "name": "projects/CONTAINER_PROJECT/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/TARGET_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Étape suivante