Configura la fundamentación para Gemini Cloud Assist

En este documento, se describe cómo configurar la fundamentación para Gemini Cloud Assist con la Google Cloud consola o una API. Vertex AI proporciona la fundamentación.

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 no se admiten ciertas ofertas, como la residencia de datos, la Transparencia de acceso y las claves de encriptación administradas por el cliente (CMEK) con esta opción.

  • 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 los sectores altamente regulados que requieren un cumplimiento estricto de la residencia de datos, como el financiero, el de la salud y el 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 manejo especial de los datos para tus instrucciones y respuestas, como se describe en las Google Cloud Condiciones del Servicio.

Antes de comenzar

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

  2. Para obtener los permisos necesarios para configurar la fundamentación para Gemini Cloud Assist, pídele a tu administrador que te otorgue el rol de Administrador de la configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) Identity and Access Management (IAM) 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 Google Cloud consola de:

    • cloudaicompanion.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • 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. En la Google Cloud consola de, ve a Gemini Cloud Assist y, luego, haz clic en Configuración.

    Ir a la configuración

  2. Selecciona la opción de fundamentación que deseas usar.

  3. Haz clic en Guardar.

API

Para configurar la fundamentación para 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 la configuración con el método asociado settingBindings.create para vincular la configuración a un proyecto.

  1. Crea la configuración y un valor específico de la configuración:

    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 Autentícate para usar REST.

    2. Ejecuta el siguiente comando para crear la 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 es 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 de forma correcta, muestra un cuerpo de respuesta que muestra el 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 la configuración. Por lo general, el proyecto de destino y el proyecto de 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 la 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 de forma correcta, muestra los metadatos de la operación en el siguiente 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
}

¿Qué sigue?