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.

Les types d'ancrage disponibles sont les suivants :

  • 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. Pour en savoir plus, consultez Ancrage avec la recherche Google.

  • 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 (tels que la finance, la santé et le secteur public) qui nécessitent une conformité stricte en matière de résidence des données. Pour en savoir plus, consultez Ancrage Web pour les entreprises.

Par défaut, Gemini Cloud Assist utilise l'ancrage avec la recherche Google fourni par l'ancrage de recherche Vertex AI 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

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

Vérifier les autorisations IAM

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

Vous pouvez également mettre à jour des rôles IAM personnalisés avec des autorisations Identity and Access Management (IAM) spécifiques, détaillées dans les sections suivantes.

Configurer l'ancrage 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 sur le projet propriétaire de l'abonnement :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • geminiGcpEnablementSettings.create
    • geminiGcpEnablementSettings.get
    • geminiGcpEnablementSettings.update
    • settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate
    • settingBindings.geminiGcpEnablementSettingsCreate
    • settingBindings.geminiGcpEnablementSettingsUse

  2. Dans la Google Cloud console, accédez à Gemini Cloud Assist, puis cliquez sur Paramètres.

    Accéder aux paramètres

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

  4. Cliquez sur Enregistrer.

API

Pour configurer l'ancrage pour Gemini Cloud Assist à l'aide de l'API, vous devez d'abord créer une ressource geminiGcpEnablementSettings pour définir le type d'ancrage. Ensuite, vous créez une ressource settingBindings, qui est un enfant du paramètre que vous avez créé, pour lier le paramètre à un projet.

  1. Vérifiez que vous disposez des autorisations Identity and Access Management (IAM) suivantes :

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • geminiGcpEnablementSettings.create
    • geminiGcpEnablementSettings.get
    • geminiGcpEnablementSettings.update
    • settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate
    • settingBindings.geminiGcpEnablementSettingsCreate
    • settingBindings.geminiGcpEnablementSettingsUse

  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)

      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/PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      Remplacez les éléments suivants :

      • PROJECT : ID du projet.
      • GROUNDING_TYPE: type d'ancrage, à savoir GROUNDING_WITH_GOOGLE_SEARCH ou WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: nom de paramètre unique, tel que gt1 pour Grounding type.

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

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

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

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

    Remplacez les éléments suivants :

    • PROJECT: ID du projet auquel le paramètre doit être appliqué.
    • GROUNDING_SETTING_ID: GROUNDING_SETTING_ID que vous avez spécifié lors de la création du paramètre.
    • GROUNDING_BINDING_ID: ID unique pour la ressource de liaison de paramètre, tel que b1.

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

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

Étape suivante