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

  • A gravação de Google Cloud dados de registo do Gemini Standard e Enterprise está limitada às interações do utilizador com o Gemini Code Assist num IDE.

  • O Gemini Code Assist no GitHub não suporta o registo com o Cloud Logging.

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 do Gemini Code Assist

Selecione uma das seguintes opções:

Consola

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

  2. Confirme que tem as seguintes autorizações do IAM no projeto proprietário da 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 para 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. Confirme que tem as seguintes autorizações do IAM no projeto proprietário da 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. Confirme que tem as seguintes autorizações do IAM no projeto proprietário da 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 para o Gemini Code Assist Standard e Enterprise, use o método loggingSetting.

  1. Confirme que tem as seguintes autorizações do IAM no projeto proprietário da 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?