Conferir os registros do Gemini

Este documento descreve como ativar a coleta e o armazenamento de informações de entrada, contextuais e respostas do usuário ao usar o Gemini para Google Cloud. O Gemini para Google Cloud não coleta nem envia para o Cloud Logging nenhuma outra interação do usuário com o Gemini para Google Cloud, incluindo feedback por escrito. Os dados coletados são enviados para o Cloud Logging para armazenamento. Para analisar esses dados, pesquise entradas de registro com o tipo de recurso cloudaicompanion.googleapis.com/Instance.

Esse recurso não registra comandos ou respostas no Gemini na Vertex AI. Para ativar os registros do Gemini na Vertex AI, consulte Ativar registros de auditoria de acesso a dados.

Os papéis do Identity and Access Management (IAM) controlam a capacidade de um principal de acessar registros. É possível conceder papéis predefinidos aos principais ou criar papéis personalizados. Para mais informações sobre as permissões necessárias, consulte Controle de acesso.

Por padrão, o Cloud Logging criptografa o conteúdo do cliente armazenado em repouso. Os dados armazenados em buckets de registro pelo Logging são criptografados usando chaves de criptografia de chaves, um processo conhecido como criptografia de envelope. Para acessar os dados de registro, é preciso ter acesso a essas chaves de criptografia de chaves. Elas são gerenciadas pelo Google sem que você precise realizar nenhuma ação.

Sua organização pode ter requisitos de criptografia regulamentares, relacionados à conformidade ou avançados que nossa criptografia em repouso padrão não oferece. Para atender aos requisitos da sua organização, em vez de deixar que o Google gerencie as chaves de criptografia que protegem seus dados, você pode gerenciar suas chaves.

Para informações específicas sobre o uso de chaves de criptografia gerenciadas pelo cliente (CMEK), incluindo vantagens e limitações, consulte Chaves de criptografia gerenciadas pelo cliente.

Limitações

Os dados de registro registrados pelo Gemini em Google Cloud não incluem interações do usuário com os seguintes produtos:
  • Gemini no BigQuery
  • Gemini no Looker
  • Gemini no Google Security Operations
  • Painel do Gemini no console do Google Cloud para o Database Center

Antes de começar

Ativar o Gemini para Google Cloud registros

Entre em contato Google Cloud com o suporte ou com seu representante Google Cloud com o ID do projeto para o qual você quer ativar o Gemini para Google Cloud registros.

Acessar os registros do Gemini para Google Cloud

Para acessar os registros do Gemini para Google Cloud , faça o seguinte:

Console do Google Cloud

  1. No console do Google Cloud, acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Na barra de ferramentas, selecione um projeto do console do Google Cloud.
  3. Na barra de ferramentas, abra o menu All resources e selecione o recurso Cloud AI Companion Instance.

Google Cloud CLI

Execute este comando:

gcloud logging read "resource.type=cloudaicompanion.googleapis.com/Instance" --project PROJECT_ID  --limit 3

Exemplos de entradas de registro

Um LogEntry é a unidade básica de dados no Cloud Logging. As seções a seguir fornecem listas de campos encontrados no LogEntry para um evento da plataforma Gemini para Google Cloud , como solicitações do usuário e Gemini para Google Cloud respostas.

Solicitações de usuários

A tabela a seguir mostra uma lista de campos encontrados em uma entrada de registro de solicitação do usuário.

Campo Valores e observações
LogEntry.resource.type Tipo de recurso do Gemini para Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID exclusivo do contêiner de recursos em que o Gemini for Google Cloud foi usado.
LogEntry.resource.labels.location Local onde o Gemini for Google Cloud foi usado.
LogEntry.resource.labels.instance_id ID exclusivo do recurso em que o Gemini for Google Cloud foi usado.
LogEntry.labels.method Pode ser uma das seguintes, dependendo do que invocou logEntry:

CompleteTask: por exemplo, uma solicitação de chat do Gemini Code Assist ou outro serviço do Gemini para Google Cloud .

GenerateCode: por exemplo, uma solicitação para gerar código, como com uma solicitação de transformação de código no Gemini Code Assist.

CompleteCode: por exemplo, uma solicitação para preencher o código ao trabalhar no ambiente de desenvolvimento integrado, como com sugestões inline no Gemini Code Assist.
LogEntry.labels.product Gemini para o nome do serviço Google Cloud . Se o produto Gemini for Google Cloud Gemini Code Assist, esse valor será code_assist. Se o produto Gemini para Google Cloud for o Gemini Cloud Assist, esse valor será cloud_assist. Caso contrário, o valor será unknown.
LogEntry.labels.request_id Um identificador exclusivo para correlacionar uma solicitação a uma entrada de registro de resposta.
LogEntry.labels.user_id O identificador do usuário que iniciou essa solicitação.
LogEntry.jsonPayload O payload da entrada de registro.
LogEntry.logName Identifica o registro.

O exemplo a seguir mostra uma entrada de registro de exemplo para um evento de comando de chat.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "taskCompletionRequest":
      input: {
        messages: [{
          author: "USER"
          content: "What are some best practices to save cost on my Google Cloud bill?"
        }]
        preamble: ""
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

O exemplo a seguir mostra uma entrada RequestLog de exemplo para solicitações automáticas de sugestão de código inline e solicitações do Gemini para Google Cloud em um arquivo de código.

Os dados de solicitação para sugestões de código inline usam o objeto codeCompletionRequest (conforme mostrado no exemplo abaixo), enquanto a geração acionada manualmente usa codeGenerationRequest.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "codeCompletionRequest": {
      "input_data_context": {
        "additional_context": {
          "files": [
            {
              "language": "go",
              "path": "{/path/to/../current-file.go",
              "segments": [
                {
                  "content": "...Prefix Text..."
                },
                {
                  "content": "...Suffix Text..."
                }
              ],
              "state": ["EDITED"]
            },
            {
              "language": "go",
              "path": "/path/to/../recent-file.go",
              "segments": [
                {
                  "content": "...File Text..."
                }
              ],
              "state": ["RECENTLY_OPENED"]
            }
          ]
        }
      }
    }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Gemini para respostas Google Cloud

A tabela a seguir mostra os campos de resposta e as descrições do Gemini para Google Cloud .

Campo Valores e observações
LogEntry.resource.type Tipo de recurso do Gemini para Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID exclusivo do contêiner de recursos em que o Gemini for Google Cloud foi usado.
LogEntry.resource.labels.location Local onde o Gemini for Google Cloud foi usado.
LogEntry.resource.labels.instance_id ID exclusivo do recurso em que o Gemini for Google Cloud foi usado.
LogEntry.labels.method Pode ser uma das seguintes, dependendo do que invocou logEntry:

CompleteTask: por exemplo, uma solicitação de chat do Gemini Code Assist ou outro serviço do Gemini para Google Cloud .

GenerateCode: por exemplo, uma solicitação para gerar código, como com uma solicitação de transformação de código no Gemini Code Assist.

CompleteCode: por exemplo, uma solicitação para preencher o código ao trabalhar no ambiente de desenvolvimento integrado, como com sugestões inline no Gemini Code Assist.
LogEntry.labels.product Gemini para o nome do serviço Google Cloud . Se o produto Gemini for Google Cloud Gemini Code Assist, esse valor será code_assist. Se o produto Gemini para Google Cloud for o Gemini Cloud Assist, esse valor será cloud_assist. Caso contrário, o valor será unknown.
LogEntry.labels.request_id Um identificador exclusivo para correlacionar uma solicitação a uma entrada de registro de resposta.
LogEntry.labels.user_id O identificador do usuário que iniciou essa solicitação.
LogEntry.jsonPayload O payload da entrada de registro. Todas as citações de origem usadas para gerar a resposta são incluídas neste objeto como attribution_context.
LogEntry.logName Identifica o registro.

A seguir