Ver feedback no console do Google Cloud

Esta página descreve como visualizar o feedback recebido do usuário final no Google Cloud console.

Antes de começar

Para visualizar as entradas de feedback no Google Cloud console, verifique o seguinte:

  • A instância do Agent Runtime tem rastreamento ativado.
  • O agente está configurado para usar o OpenTelemetry (OTel) para gerar períodos de rastreamento e processar a propagação do contexto de rastreamento. A UI do console mapeia as entradas de feedback para rastreamentos usando o atributo de período gerado pelo OpenTelemetry gcp.vertex.agent.event_id.

Mostrar feedback

O serviço de feedback está integrado à guia Rastreamentos no Google Cloud console. Na guia Rastreamentos, é possível visualizar e filtrar rastreamentos com feedback anexado nas guias Visualização de sessões e Visualização de rastreamentos.

Para visualizar as entradas de feedback do agente:

  1. No Google Cloud console, navegue até a página Agent Platform > Agentes.
  2. No menu de navegação à esquerda, selecione Implantações.

  3. Selecione seu agente.

    Acessar "Implantações"

    As instâncias do Agent Engine que fazem parte do projeto selecionado aparecem na lista. É possível usar o campo Filtro para filtrar a lista pela coluna especificada.

  4. Clique no nome da instância do Agent Engine.

  5. Clique na guia Rastreamentos. Use a Visualização de sessões ou a Visualização de rastreamentos para encontrar rastreamentos com feedback:

    • Visualização de sessões:
      1. Filtre a lista de sessões pela coluna Feedback.
      2. Clique na sessão que você quer visualizar para mostrar a lista de rastreamentos.
      3. Selecione um ID de rastreamento que mostre um selo de ícone de feedback.
    • Visualização de rastreamentos:
      1. Clique na guia Visualização de rastreamentos.
      2. Filtre a lista de rastreamentos pela coluna Feedback.
      3. Selecione um ID de rastreamento que mostre um selo de ícone de feedback.

  6. No painel de detalhes do rastreamento, clique na guia Feedback para visualizar os detalhes do feedback, como tipo, comentários, rótulos, ID e hora de criação.

Limitações da UI

  • Requisitos de ID do evento: a interface só oferece suporte ao rastreamento e ao mapeamento de entradas de feedback que usam o UUID gerado pelo OpenTelemetry (gcp.vertex.agent.event_id) buscado nos períodos de rastreamento.
  • Envios duplicados: se várias entradas de feedback forem enviadas com a mesma combinação de session_id e event_id, a UI do console vai mostrar apenas a última entrada de feedback recebida.

Integração do Cloud Trace

Quando um usuário envia feedback, o serviço de feedback exporta períodos de telemetria para o Cloud Trace. Para localizar o feedback do usuário junto com os eventos de execução do mecanismo de raciocínio, pesquise e filtre esses períodos exportados pelos atributos. Para mais detalhes sobre como encontrar e visualizar esses rastreamentos, consulte o guia Configurar o rastreamento.

Como os rastreamentos são imutáveis, excluir ou atualizar uma entrada de feedback não afeta os rastreamentos exportados anteriormente.

Cada rastreamento de telemetria de feedback contém um período chamado gcp.vertex.agent.feedback com os seguintes atributos de recurso e período:

Atributo Tipo de atributo Descrição
gcp.project_id Recurso ID do projeto de um Google Cloud projeto do console.
cloud.resource.id Recurso ID da instância do mecanismo de raciocínio.
gcp.vertex.agent.feedback.type Período Tipo de feedback (THUMBS_UP, THUMBS_DOWN, ou FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Período ID da sessão associado à interação.
gcp.vertex.agent.event_id Período ID do evento associado ao turno de conversa específico.
gcp.vertex.agent.feedback.entry.name Período Caminho do recurso da entrada de feedback criada.
gcp.vertex.agent.feedback.labels Período Opcional. Lista de rótulos de feedback.

A seguir