Configurar el registro de Gemini Code Assist Standard y Enterprise

Este documento describe cómo configurar el registro de Gemini Code Assist Standard y Enterprise para un proyecto mediante el uso de Google Cloud consola o una API.

Limitaciones

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

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

Antes de empezar

Asegúrese de que su Google Cloud El proyecto está asociado a una cuenta de facturación.

(Opcional) Otorgar permisos de IAM

Para configurar el registro de Gemini Code Assist Standard y Enterprise, debe tener permisos específicos de Administración de Identidad y Acceso (IAM), que se detallan en las siguientes secciones. Asegúrese de que estos permisos se agreguen a los roles de IAM personalizados .

Como alternativa, puede otorgar al administrador de configuración de Gemini para Google Cloud ( roles/cloudaicompanion.settingsAdmin ) el rol predefinido de IAM, que incluye todos los permisos necesarios para trabajar con todos los Gemini para Google Cloudconfiguración del administrador.

(Opcional) Vincular permisos a configuraciones y objetivos

Si está configurando los ajustes de administrador de Gemini Code Assist Standard y Enterprise en el Google Cloud consola, entonces puedes omitir esta sección.

Para configurar las opciones de administrador de Gemini Code Assist Standard y Enterprise con la API de Gemini para Google Cloud , primero debe crear configuraciones y luego crear enlaces para "vincular" esas configuraciones y destinos (como instancia, tema o proyectos) para productos específicos (como Gemini Cloud Assist o Gemini Code Assist).

Todos los permisos para crear y actualizar configuraciones están a nivel de proyecto.

Configurar el registro de Gemini Code Assist

Las siguientes secciones 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:

  • Indicaciones y registros de respuestas de Gemini Code Assist Standard y Enterprise, como entrada 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, consulte Ver registros de Gemini .

Habilitar el registro para Gemini Code Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de haber habilitado la API de registro en la nube en el proyecto.

  2. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

    • 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 el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

    Se carga la página de Gemini para Google Cloud .

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

    Se carga la página de Configuración .

  5. (Opcional) Haga clic en Registro de metadatos de Code Assist para registrar los metadatos generados por los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  6. (Opcional) Haga clic en Registro de indicaciones y respuestas de Code Assist para registrar las indicaciones y respuestas generadas por los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  7. Haga clic en Guardar cambios .

API

Para habilitar el registro para Gemini Code Assist Standard y Enterprise, utilice el método loggingSetting .

  1. Asegúrese de haber habilitado la API de registro en la nube en el proyecto.

  2. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

    • 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. Cree la configuración y un valor específico de la configuración:

    1. Obtener el token:

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

  4. Habilitar los registros de metadatos de Gemini Code Assist Standard y Enterprise.

    1. Ejecute el siguiente comando para crear la configuración:

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

      Reemplace lo siguiente:

      • CONTAINER_PROJECT_NAME : Introduzca el ID del proyecto donde se almacena el recurso de enlace. Este es el proyecto principal del enlace.
      • META_LOG_SETTING_ID : ingrese un nombre de configuración único, como gcalm1 para Gemini Code Assist log metadata .

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra el log_metadata establecido en true :

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

    2. Ejecute el siguiente comando para crear el enlace de configuración de registros de metadatos 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/META_LOG_SETTING_ID/settingBindings?setting_binding_id=META_LOG_BINDING_ID"

    Reemplace lo siguiente:

    • TARGET_PROJECT_NAME : Introduzca el proyecto de destino al que se vinculará el enlace. Suele ser el mismo que el proyecto contenedor. Sin embargo, puede vincular una configuración a varios proyectos para evitar la duplicación del recurso de configuración.
    • META_LOG_BINDING_ID : Use el mismo META_LOG_SETTING_ID que creó la configuración, pero añádale b1 . Por ejemplo, use gcalmb1 para Gemini Code Assist log metadata .

    Si el comando tiene éxito, devuelve 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>META_LOG_SETTING_ID</var>/settingBindings/<var>META_LOG_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

  5. Habilitar los registros de usuarios estándar y empresariales de Gemini Code Assist.

    1. Ejecute el siguiente comando para crear la configuración:

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

      Reemplace lo siguiente:

      • CONTAINER_PROJECT_NAME : Introduzca el ID del proyecto donde se almacena el recurso de enlace. Este es el proyecto principal del enlace.
      • USER_LOG_SETTING_ID : Ingrese un nombre de configuración único, como gcapar1 para Gemini Code Assist prompts and responses .

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra log_prompts_and_responses establecido en true :

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

    2. Ejecute el siguiente comando para crear el enlace de configuración de registros de usuarios de Gemini Code Assist Standard y Enterprise:

      curl \
  -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/USER_LOG_SETTING_ID/settingBindings?setting_binding_id=USER_LOG_BINDING_ID"

    Reemplace lo siguiente:

    • TARGET_PROJECT_NAME : Introduzca el proyecto de destino al que se vinculará el enlace. Suele ser el mismo que el proyecto contenedor. Sin embargo, puede vincular una configuración a varios proyectos para evitar la duplicación del recurso de configuración.
    • USER_LOG_BINDING_ID : Use el mismo USER_LOG_SETTING_ID que creó la configuración, pero añádale b1 . Por ejemplo, use gcaparb1 para Gemini Code Assist prompts and responses .

    Si el comando tiene éxito, devuelve 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>USER_LOG_SETTING_ID</var>/settingBindings/<var>USER_LOG_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Deshabilitar el registro para Gemini Code Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

    • 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 el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

    Se carga la página de Gemini para Google Cloud .

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

    Se carga la página de Configuración .

  4. Haga clic en Registro de metadatos de Code Assist para desactivar el registro de metadatos del uso de Gemini Code Assist Standard y Enterprise en el proyecto.

  5. Haga clic en Guardar cambios .

API

Para habilitar el registro para Gemini Code Assist Standard y Enterprise, utilice el método loggingSetting .

  1. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

    • 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. Cree la configuración y un valor específico de la configuración:

    1. Obtener el token: 

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

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

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

    Reemplace lo siguiente:

    • CONTAINER_PROJECT_NAME : Ingrese el ID del proyecto principal.

    • META_LOG_SETTING_ID : ingrese el nombre de la configuración existente, como gcalm1 para Gemini Code Assist log metadata .

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra el log_metadata establecido en false : 

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

  4. Ejecute el siguiente comando para deshabilitar la configuración de registros de usuarios 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,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=USER_LOG_SETTING_ID"

    Reemplace lo siguiente:

    • CONTAINER_PROJECT_NAME : Ingrese el ID del proyecto principal.

    • USER_LOG_SETTING_ID : Ingrese el nombre de configuración existente, como gcapar1 para Gemini Code Assist prompts and responses .

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra log_prompts_and_responses establecido en false : 

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

¿Qué sigue?