Configura la fundamentación para Gemini Cloud Assist

La fundamentación te permite conectar Gemini Cloud Assist a fuentes web externas a través de Vertex AI, lo que proporciona respuestas más precisas y actualizadas. En este documento, se describe cómo configurar la fundamentación en la consola de Google Cloud o con una API.

Tipos de fundamentación disponibles:

  • Fundamentación con la Búsqueda de Google (recomendado): Indica a Gemini Cloud Assist que use la Búsqueda de Google para obtener las respuestas más completas y actualizadas. Ten en cuenta que esta opción no admite ciertas ofertas, como la residencia de datos, la Transparencia de acceso y las claves de encriptación administradas por el cliente (CMEK).

  • Fundamentación web para empresas: Aprovecha un subconjunto restringido de contenido web. Si bien esto puede generar respuestas de menor calidad en comparación con la fundamentación con la Búsqueda de Google, es la opción preferida para las industrias altamente reguladas que requieren un cumplimiento estricto de la residencia de datos, como las finanzas, la atención médica y el sector público.

De forma predeterminada, Gemini Cloud Assist usa la fundamentación con la Búsqueda de Google para mejorar la calidad de sus respuestas a tus instrucciones. El uso de la fundamentación con la Búsqueda de Google implica un tratamiento especial de los datos para tus instrucciones y respuestas, como se describe en las condiciones del servicio deGoogle Cloud .

Antes de comenzar

  1. Verifica que tu proyecto de Google Cloud esté vinculado a una cuenta de facturación.

  2. Verifica que Gemini Cloud Assist esté configurado para tu Google Cloud proyecto.

  3. Para obtener los permisos necesarios para configurar la fundamentación de Gemini Cloud Assist, pídele a tu administrador que te otorgue el rol de Identity and Access Management (IAM) de Administrador de la configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) en tu proyecto. Este rol predefinido contiene los permisos necesarios para administrar la configuración del administrador de Gemini Cloud Assist.

    Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

    Permisos necesarios

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • Si usas solicitudes directas a la API, este permiso es necesario específicamente para TARGET_PROJECT.

    Los siguientes son permisos adicionales que se requieren si usas la consola de Google Cloud :

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

Puedes obtener estos permisos con otros roles predefinidos o roles personalizados.

Configura la fundamentación para Gemini Cloud Assist

Selecciona una de las siguientes opciones:

Console

  1. Abre la consola de Google Cloud .

    Ir a la consola de Google Cloud

  2. En cualquier página de la consola de Google Cloud , haz clic en spark Abrir o cerrar el chat de Gemini Cloud Assist.

    Se abrirá el panel de Cloud Assist.

  3. Haz clic en Más acciones () y, luego, en Configuración de Cloud Assist en el menú desplegable.

    Se abrirá el panel de configuración Administrar Gemini Cloud Assist.

  4. Selecciona la opción de fundamentación que quieras usar.

  5. Haz clic en Guardar.

API

Para configurar la fundamentación de Gemini Cloud Assist con la API, crea un recurso geminiGcpEnablementSettings que defina el tipo de fundamentación con el método geminiGcpEnablementSettings.create. Luego, aplica el parámetro de configuración con el método settingBindings.create asociado para vincular el parámetro de configuración a un proyecto.

  1. Crea el parámetro de configuración y un valor específico para ese parámetro:

    1. Obtén un token de autenticación:

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

      Para obtener más información sobre la autenticación, consulta Autentica para usar REST.

    2. Ejecuta el siguiente comando para crear el parámetro de configuración:

      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"

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT: Es el ID del proyecto que almacena los datos de configuración.
      • GROUNDING_TYPE: Es el tipo de fundamentación, que puede ser GROUNDING_WITH_GOOGLE_SEARCH o WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: Es un nombre único para identificar estos datos de configuración en particular, como gt1.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra el valor de webGroundingType establecido en tu selección:

      {
  "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 la vinculación de configuración:

      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"

    Reemplaza lo siguiente:

    • TARGET_PROJECT: Es el ID del proyecto al que se debe aplicar el parámetro de configuración. Por lo general, el proyecto de destino y el proyecto del contenedor son el mismo.
    • CONTAINER_PROJECT: Es el ID del proyecto que almacena los datos de configuración.
    • GROUNDING_SETTING_ID: Es el GROUNDING_SETTING_ID que especificaste cuando creaste el parámetro de configuración.
    • GROUNDING_BINDING_ID: Es un ID único para identificar este recurso de vinculación de configuración en particular, como b1.

    Si el comando se ejecuta correctamente, devuelve los metadatos de la operación en el siguiente 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
}

¿Qué sigue?