Configura il grounding per Gemini Cloud Assist

Grounding ti consente di connettere Gemini Cloud Assist a fonti web esterne tramite Vertex AI, fornendo risposte più accurate e aggiornate. Questo documento descrive come configurare la base nella console Google Cloud o con un'API.

Tipi di grounding disponibili:

  • Grounding con la Ricerca Google (consigliato): indica a Gemini Cloud Assist di utilizzare Ricerca Google per ottenere 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: Sfrutta un sottoinsieme limitato di contenuti web. Anche se ciò potrebbe 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 di 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 progetto Google Cloud sia collegato a un account di fatturazione.

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

  3. Per ottenere le autorizzazioni necessarie per configurare la fondatezza per Gemini Cloud Assist, chiedi all'amministratore di concederti il ruolo Identity and Access Management (IAM) Gemini in Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) nel tuo progetto. Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire le impostazioni di 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 è necessaria specificamente per TARGET_PROJECT.

    Di seguito sono riportate le autorizzazioni aggiuntive necessarie 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 console Google Cloud .

    Vai alla console Google Cloud

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

    Si apre il riquadro Cloud Assist.

  3. Fai clic su Altre azioni () e poi su Impostazioni Cloud Assist dal 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 la grounding per Gemini Cloud Assist utilizzando l'API, crea una risorsa geminiGcpEnablementSettings che definisce il tipo di grounding, utilizzando il metodo geminiGcpEnablementSettings.create. Quindi, applichi l'impostazione utilizzando il metodo settingBindings.create associato per collegarla 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 questo comando 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 di impostazione.
      • GROUNDING_TYPE: il tipo di base, che è 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 il valore di 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 dell'impostazione:

      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 di impostazione.
    • GROUNDING_SETTING_ID: il GROUNDING_SETTING_ID che hai specificato quando hai creato l'impostazione.
    • GROUNDING_BINDING_ID: un ID univoco per identificare questa particolare risorsa di binding delle impostazioni, 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