Configura el registro de Gemini Code Assist Standard y Enterprise

En este documento, se describe cómo configurar el registro estándar y empresarial de Gemini Code Assist para un proyecto con la consola de Google Cloud o una API.

Limitaciones

La grabación de datos de registro de Gemini Standard y Enterprise en Google Cloud se limita a las interacciones del usuario con Gemini Code Assist dentro del IDE.

Además, Gemini para Google Cloud no registra datos de Gemini Code Assist Standard y Enterprise si el usuario desactiva la telemetría de VS Code.

Antes de comenzar

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

Verifica los permisos de IAM

Para configurar el registro de Gemini Code Assist Standard y Enterprise, puedes otorgar el rol predefinido de Identity and Access Management Administrador de configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin), que incluye todos los permisos necesarios para trabajar con todos los parámetros de configuración del administrador de Gemini para Google Cloud.

Como alternativa, puedes actualizar cualquier rol de IAM personalizado. Debes tener permisos de IAM específicos, que se detallan en las siguientes secciones.

Configura el registro de Gemini Code Assist

En las siguientes secciones, se proporcionan los pasos necesarios para habilitar la recopilación y el almacenamiento de la actividad de Gemini Code Assist Standard y Enterprise en Cloud Logging, incluidos los siguientes:

  • Registros de instrucciones y respuestas de Gemini Code Assist Standard y Enterprise, como entradas del usuario, información contextual y respuestas.

  • Registros de metadatos de Gemini Code Assist Standard y Enterprise, como metadatos de telemetría y líneas de código aceptadas por el usuario.

Para obtener más detalles sobre ambos tipos de registros, consulta Cómo ver los registros de Gemini.

Habilita el registro de Gemini Code Assist

Selecciona una de las siguientes opciones:

Console

  1. Verifica que hayas habilitado la API de Cloud Logging en el proyecto.

  2. Verifica que tengas los siguientes permisos de IAM en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. En la consola de Google Cloud, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  4. Haz clic en Configuración en el menú de navegación de la izquierda.

    Se carga la página Configuración.

  5. (Opcional) Haz clic en Logging for Code Assist metadata para registrar los metadatos que generan los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  6. (Opcional) Haz clic en Registro de las instrucciones y respuestas de Code Assist para registrar las instrucciones y respuestas que generan los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  7. Haz clic en Guardar cambios.

API

Para habilitar el registro de Gemini Code Assist Standard y Enterprise, usa el recurso loggingSettings para definir la configuración de registro que desees y el recurso loggingSettings.settingBindings para vincular la configuración a un proyecto:

  1. Verifica que hayas habilitado la API de Cloud Logging en el proyecto.

  2. Verifica que tengas los siguientes permisos de IAM en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

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

    1. Obtén el token:

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

  4. Habilita los registros de Gemini Code Assist Standard y Enterprise. Los registros de usuarios y los registros de metadatos se habilitan con los campos log_prompts_and_responses y log_metadata, respectivamente. Si no quieres habilitar uno de los campos, exclúyelo de la solicitud.

    1. 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 '{
    "log_prompts_and_responses": true,
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT_NAME: Ingresa el ID del proyecto en el que se almacena el recurso de vinculación. Este es el proyecto principal de la vinculación.
      • LOGS_SETTING_ID: Ingresa un nombre de configuración único, como gcalm.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra log_prompts_and_responses y log_metadata establecidos en true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true,
  "log_metadata": true
}

    2. Ejecuta el siguiente comando para crear la vinculación de la configuración de los registros de Gemini Code Assist Standard y Enterprise:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"

    Reemplaza lo siguiente:

    • TARGET_PROJECT_NAME: Ingresa el proyecto de destino al que se debe vincular la vinculación. Por lo general, es el mismo que el proyecto del contenedor. Sin embargo, puedes vincular un parámetro de configuración a varios proyectos para que no se duplique el recurso de configuración.
    • LOGS_BINDING_ID: Usa el mismo LOGS_SETTING_ID que cuando creaste el parámetro de configuración, pero agrégale b1. Por ejemplo, usa gcalmb1.

    Si el comando se ejecuta correctamente, se muestran los metadatos de la operación en el siguiente formato:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</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_NAME</var>/locations/global/loggingSettings/<var>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Cómo inhabilitar el registro de Gemini Code Assist

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de IAM en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  2. En la consola de Google Cloud, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. Haz clic en Configuración en el menú de navegación de la izquierda.

    Se carga la página Configuración.

  4. Haz clic en Logging for Code Assist metadata para desactivar el registro de los metadatos del uso de Gemini Code Assist Standard y Enterprise en el proyecto.

  5. Haz clic en Guardar cambios.

API

Para inhabilitar el registro de Gemini Code Assist Standard y Enterprise, usa el método loggingSetting.

  1. Verifica que tengas los siguientes permisos de IAM en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable

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

    1. Obtén el token:

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

  3. Ejecuta el siguiente comando para inhabilitar la configuración de los registros de Gemini Code Assist Standard y Enterprise:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_prompts_and_responses": false,
      "log_metadata": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=LOGS_SETTING_ID"

    Reemplaza lo siguiente:

    • CONTAINER_PROJECT_NAME: Ingresa el ID del proyecto principal.

    • LOGS_SETTING_ID: Ingresa el nombre del parámetro de configuración existente, como gcalm.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra log_prompts_and_responses y log_metadata establecidos en false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false,
  "log_metadata": false
}

¿Qué sigue?