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 tuoi 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 tuo Google Cloud progetto sia collegato a un account di fatturazione.

  2. Verifica che Gemini Cloud Assist sia configurato per il tuo Google Cloud progetto.

  3. Per ottenere le autorizzazioni necessarie per configurare il grounding per Gemini Cloud Assist, chiedi all'amministratore di concederti il ruolo Identity and Access Management (IAM) Amministratore delle impostazioni di Gemini in 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.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

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

Configura il grounding per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Apri la Google Cloud console.

    Vai alla Google Cloud console

  2. In qualsiasi pagina della Google Cloud console, fai clic sulla stella Apri o chiudi la chat di Gemini Cloud Assist.

    Si apre il pannello Cloud Assist.

  3. Fai clic su Altre azioni (), quindi su Impostazioni di Cloud Assist nel menu a discesa.

    Si apre il pannello delle impostazioni Gestisci Gemini Cloud Assist.

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

  5. 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 tua 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 valore 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/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
}

Passaggi successivi