Configura il grounding per Gemini Cloud Assist

Questo documento descrive come configurare il grounding per Gemini Cloud Assist utilizzando la Google Cloud console o un'API. Il grounding è fornito da Vertex AI.

Tipi di grounding disponibili:

  • Grounding con la Ricerca Google (consigliato): indica a Gemini Cloud Assist di utilizzare la Ricerca Google per le risposte più complete e aggiornate. Tieni presente che alcune offerte, come Residenza dei dati, Access Transparency e chiavi di crittografia gestite dal cliente (CMEK), non sono supportate con questa opzione.

  • Grounding web per aziende: utilizza un sottoinsieme limitato di contenuti web. Sebbene ciò possa portare a risposte di qualità inferiore rispetto al grounding con la Ricerca Google, è l'opzione preferita per i settori altamente regolamentati che richiedono una rigorosa conformità alla residenza dei dati, come quello finanziario, sanitario e pubblico.

Per impostazione predefinita, Gemini Cloud Assist utilizza il grounding con la Ricerca Google per migliorare la qualità delle risposte ai prompt. L'utilizzo del grounding con la Ricerca Google comporta una gestione speciale dei dati per i prompt e le risposte, come descritto nei Google Cloud Termini di servizio.

Prima di iniziare

  1. Verifica che il Google Cloud progetto sia collegato a un account di fatturazione.

  2. Per ottenere le autorizzazioni necessarie per configurare il grounding per Gemini Cloud Assist, chiedi all'amministratore di concederti il ruolo di Identity and Access Management (IAM) Amministratore delle impostazioni di Gemini per Google Cloud (roles/cloudaicompanion.settingsAdmin) nel tuo progetto. Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire le impostazioni dell'amministratore di Gemini Cloud Assist.

    Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

    Autorizzazioni obbligatorie

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • Se utilizzi richieste API dirette, questa autorizzazione è richiesta in modo specifico per TARGET_PROJECT.

    Di seguito sono riportate le autorizzazioni aggiuntive richieste se utilizzi la console: Google Cloud

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

Potresti essere in grado di ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.

Configurare il grounding per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Nellaconsole, vai a Gemini Cloud Assist e poi fai clic su Impostazioni. Google Cloud

    Vai alle impostazioni

  2. Seleziona l'opzione di grounding che vuoi utilizzare.

  3. Fai clic su Salva.

API

Per configurare il grounding per Gemini Cloud Assist utilizzando l'API, crea una risorsa geminiGcpEnablementSettings che definisce il tipo di grounding, utilizzando il metodo geminiGcpEnablementSettings.create. Quindi, applica l'impostazione utilizzando il metodo associato settingBindings.create per associare l'impostazione a un progetto.

  1. Crea l'impostazione e un valore specifico per l'impostazione:

    1. Ottieni un token di autenticazione:

      TOKEN=$(gcloud auth print-access-token)

      Per saperne di più sull'autenticazione, consulta Autenticati per usare REST.

    2. Esegui il comando seguente per creare l'impostazione:

      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"

      Sostituisci quanto segue:

      • CONTAINER_PROJECT: l'ID progetto del progetto che archivia i dati delle impostazioni.
      • GROUNDING_TYPE: il tipo di grounding, che può essere GROUNDING_WITH_GOOGLE_SEARCH o WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: un nome univoco per identificare questi dati di impostazione specifici, ad esempio gt1.

      Se il comando ha esito positivo, restituisce un corpo della risposta che mostra webGroundingType impostato sulla selezione:

      {
  "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. Crea l'associazione delle impostazioni:

      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"

    Sostituisci quanto segue:

    • TARGET_PROJECT: l'ID progetto del progetto a cui deve essere applicata l'impostazione. In genere, il progetto di destinazione e il progetto contenitore sono gli stessi.
    • CONTAINER_PROJECT: l'ID progetto del progetto che archivia i dati delle impostazioni.
    • GROUNDING_SETTING_ID: il GROUNDING_SETTING_ID che hai specificato quando hai creato l'impostazione.
    • GROUNDING_BINDING_ID: un ID univoco per identificare questa risorsa di associazione delle impostazioni specifica, ad esempio b1.

    Se il comando ha esito positivo, restituisce i metadati dell'operazione nel seguente formato:

    {
  "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
}

Passaggi successivi