Configurer l'ancrage pour Gemini Cloud Assist

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

Types d'ancrage disponibles :

  • Ancrage avec la recherche Google (recommandé) : indique à 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 : utilise un sous-ensemble restreint de contenu 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 requêtes. L'ancrage avec la recherche Google implique un traitement spécial des données pour vos requêtes et vos réponses, comme décrit dans les Google Cloud Conditions d'utilisation du service.

Avant de commencer

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

  2. Pour obtenir les autorisations nécessaires pour configurer l'ancrage pour Gemini Cloud Assist, demandez à votre administrateur de vous attribuer 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 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 TARGET_PROJECT.

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

    • cloudaicompanion.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • 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. Dans la console Google Cloud , accédez à Gemini Cloud Assist, puis cliquez sur Paramètres.

    Accéder aux paramètres

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

  3. Cliquez sur Enregistrer.

API

Pour configurer l'ancrage pour Gemini Cloud Assist à l'aide de l'API, vous devez créer 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 settingBindings.create associée 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 paramètre.
      • GROUNDING_TYPE : type d'ancrage (GROUNDING_WITH_GOOGLE_SEARCH ou WEB_GROUNDING_FOR_ENTERPRISE).
      • GROUNDING_SETTING_ID : nom unique permettant d'identifier ces données de paramètre 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 paramètre.
    • GROUNDING_SETTING_ID : GROUNDING_SETTING_ID que vous avez spécifié lorsque vous avez créé le 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/<var>CONTAINER_PROJECT</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</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Étapes suivantes