Visualizza il feedback nella console Google Cloud

Questa pagina descrive come visualizzare i feedback degli utenti finali ricevuti nella Google Cloud console.

Prima di iniziare

Per visualizzare le voci di feedback nella Google Cloud console, assicurati di quanto segue:

  • L'istanza di Agent Runtime ha la funzionalità di tracciamento abilitata.
  • L'agente è configurato per utilizzare OpenTelemetry (OTel) per generare intervalli di traccia e gestire la propagazione del contesto di traccia. L'interfaccia utente della console mappa le voci di feedback alle tracce utilizzando l'attributo dell'intervallo generato da OpenTelemetry gcp.vertex.agent.event_id.

Visualizza feedback

Il servizio Feedback è integrato con la scheda Tracce nella Google Cloud console. Nella scheda Tracce, puoi visualizzare e filtrare le tracce a cui è allegato un feedback nelle schede Visualizzazione sessioni e Visualizzazione tracce.

Per visualizzare le voci di feedback per l'agente:

  1. Nella Google Cloud console, vai alla pagina Agent Platform > Agenti.
  2. Nel menu di navigazione a sinistra, seleziona Deployment.

  3. Seleziona l'agente.

    Vai a Deployment

    Le istanze di Agent Engine che fanno parte del progetto selezionato vengono visualizzate in nell'elenco. Puoi utilizzare il campo Filtra per filtrare l'elenco in base alla colonna specificata.

  4. Fai clic sul nome dell'istanza di Agent Engine.

  5. Fai clic sulla scheda Tracce. Utilizza la Visualizzazione sessioni o la Visualizzazione tracce per trovare le tracce con feedback:

    • Visualizzazione sessioni:
      1. Filtra l'elenco delle sessioni in base alla colonna Feedback.
      2. Fai clic sulla sessione che vuoi visualizzare per mostrare l'elenco delle tracce.
      3. Seleziona un ID traccia che visualizza un badge con l'icona di feedback.
    • Visualizzazione tracces:
      1. Fai clic sulla scheda Visualizzazione tracce.
      2. Filtra l'elenco delle tracce in base alla colonna Feedback.
      3. Seleziona un ID traccia che visualizza un badge con l'icona di feedback.

  6. Nel riquadro dei dettagli della traccia, fai clic sulla scheda Feedback per visualizzare i dettagli del feedback, come il tipo di feedback, i commenti, le etichette, l'ID e l'ora di creazione.

Limitazioni dell'interfaccia utente

  • Requisiti per l'ID evento: l'interfaccia utente supporta solo il monitoraggio e la mappatura delle voci di feedback che utilizzano l'UUID generato da OpenTelemetry (gcp.vertex.agent.event_id) recuperato dagli intervalli di traccia.
  • Invii duplicati: se vengono inviate più voci di feedback con la stessa combinazione di session_id e event_id, l'interfaccia utente della console visualizza solo l'ultima voce di feedback ricevuta.

Integrazione di Cloud Trace

Quando un utente invia un feedback, il servizio Feedback esporta gli intervalli di telemetria in Cloud Trace. Per individuare i feedback degli utenti insieme agli eventi di esecuzione del motore di ragionamento, cerca e filtra questi intervalli esportati in base ai relativi attributi. Per informazioni dettagliate su come trovare e visualizzare queste tracce, consulta la guida Configurare il tracciamento.

Poiché le tracce sono immutabili, l'eliminazione o l'aggiornamento di una voce di feedback non influisce sulle tracce esportate in precedenza.

Ogni traccia di telemetria di feedback contiene un intervallo denominato gcp.vertex.agent.feedback con i seguenti attributi di risorsa e intervallo:

Attributo Tipo di attributo Descrizione
gcp.project_id Risorsa ID progetto di un Google Cloud progetto della console.
cloud.resource.id Risorsa ID dell'istanza del motore di ragionamento.
gcp.vertex.agent.feedback.type Intervallo Tipo di feedback (THUMBS_UP, THUMBS_DOWN, o FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Intervallo ID sessione associato all'interazione.
gcp.vertex.agent.event_id Intervallo ID evento associato al turno di conversazione specifico.
gcp.vertex.agent.feedback.entry.name Intervallo Percorso della risorsa della voce di feedback creata.
gcp.vertex.agent.feedback.labels Intervallo Facoltativo. Elenco delle etichette di feedback.

Passaggi successivi