Configure o registo do Gemini Code Assist Standard e Enterprise

Este documento descreve como configurar o registo padrão e empresarial do Gemini Code Assist para um projeto através da Google Cloud consola ou de uma API.

Limitações

O Gemini Standard e o Gemini Enterprise na Google Cloud gravação de dados de registo estão limitados às interações do utilizador com o Gemini Code Assist no IDE.

Além disso, o Gemini para Google Cloud não regista dados para o Gemini Code Assist Standard e Enterprise se a telemetria do VS Code estiver desativada pelo utilizador.

Antes de começar

Confirme se o seu Google Cloud projeto está associado a uma conta de faturação.

Valide as autorizações de IAM

Para configurar o registo do Gemini Code Assist Standard e Enterprise, pode conceder a função predefinida de gestão de identidades e acessos (IAM) Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin), que inclui todas as autorizações necessárias para trabalhar com todas as definições de administrador do Gemini for Google Cloud.

Em alternativa, pode atualizar quaisquer funções de IAM personalizadas. Tem de ter autorizações de IAM específicas, que são detalhadas nas secções seguintes.

Configure o registo do Gemini Code Assist

As secções seguintes fornecem os passos necessários para ativar a recolha e o armazenamento da atividade do Gemini Code Assist Standard e Enterprise no Cloud Logging, incluindo:

  • Comandos e registos de respostas do Gemini Code Assist Standard e Enterprise, como a introdução do utilizador, informações contextuais e respostas.

  • Registos de metadados do Gemini Code Assist Standard e Enterprise, como metadados de telemetria e linhas de código aceites pelo utilizador.

Para mais detalhes sobre ambos os tipos de registos, consulte o artigo Ver registos do Gemini.

Ative o registo para o Gemini Code Assist

Selecione uma das seguintes opções:

Consola

  1. Verifique se ativou a API Cloud Logging no projeto.

  2. Valide que tem as seguintes autorizações do IAM no projeto que detém a subscrição:

    • 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. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

    A página Gemini para o Google Cloud é carregada.

  4. Clique em Definições no menu de navegação do lado esquerdo.

    A página Definições é carregada.

  5. (Opcional) Clique em Registo de metadados do Code Assist para registar os metadados gerados pelos utilizadores do Gemini Code Assist Standard e Enterprise no projeto.

  6. (Opcional) Clique em Registo de comandos e respostas do Code Assist para registar os comandos e as respostas gerados pelos utilizadores do Gemini Code Assist Standard e Enterprise no projeto.

  7. Clique em Guardar alterações.

API

Para ativar o registo para o Gemini Code Assist Standard e Enterprise, use o recurso loggingSettings para definir as definições de registo pretendidas e use o recurso loggingSettings.settingBindings para associar as definições a um projeto:

  1. Confirme se ativou a API Cloud Logging no projeto.

  2. Valide que tem as seguintes autorizações do IAM no projeto que detém a subscrição:

    • 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. Crie a definição e um valor específico da definição:

    1. Obtenha o token:

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

  4. Ative os registos do Gemini Code Assist Standard e Enterprise. Os registos de utilizadores e os registos de metadados são ativados com os campos log_prompts_and_responses e log_metadata, respetivamente. Se não quiser ativar um dos campos, exclua-o do pedido.

    1. Execute o seguinte comando para criar a definição:

      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"

      Substitua o seguinte:

      • CONTAINER_PROJECT_NAME: introduza o ID do projeto do projeto onde o recurso de associação está armazenado. Este é o projeto principal da associação.
      • LOGS_SETTING_ID: introduza um nome de definição exclusivo, como gcalm.

      Se o comando for bem-sucedido, devolve um corpo da resposta que mostra o log_prompts_and_responses e o log_metadata definidos como 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. Execute o seguinte comando para criar a associação da definição dos registos do Gemini Code Assist Standard e 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"

    Substitua o seguinte:

    • TARGET_PROJECT_NAME: introduza o projeto de destino ao qual a associação deve ser associada. Normalmente, é igual ao projeto do contentor. No entanto, pode associar uma definição a vários projetos para que o recurso de definição não tenha de ser duplicado.
    • LOGS_BINDING_ID: use o mesmo LOGS_SETTING_ID quando criou a definição, mas acrescente-lhe b1. Por exemplo, use gcalmb1.

    Se o comando for bem-sucedido, devolve os metadados da operação no seguinte 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
}

Desative o registo para o Gemini Code Assist

Selecione uma das seguintes opções:

Consola

  1. Valide que tem as seguintes autorizações do IAM no projeto que detém a subscrição:

    • 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. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

    A página Gemini para o Google Cloud é carregada.

  3. Clique em Definições no menu de navegação do lado esquerdo.

    A página Definições é carregada.

  4. Clique em Registo de metadados do Code Assist para desativar a gravação dos metadados da utilização do Gemini Code Assist Standard e Enterprise no projeto.

  5. Clique em Guardar alterações.

API

Para desativar o registo do Gemini Code Assist Standard e Enterprise, use o método loggingSetting.

  1. Valide que tem as seguintes autorizações do IAM no projeto que detém a subscrição:

    • 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. Crie a definição e um valor específico da definição:

    1. Obtenha o token:

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

  3. Execute o seguinte comando para desativar as definições de registos do Gemini Code Assist Standard e 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"

    Substitua o seguinte:

    • CONTAINER_PROJECT_NAME: introduza o ID do projeto principal.

    • LOGS_SETTING_ID: introduza o nome da definição existente, como gcalm.

      Se o comando for bem-sucedido, devolve um corpo da resposta que mostra o log_prompts_and_responses e o log_metadata definidos como 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
}

O que se segue?