Panoramica del servizio di feedback

Il servizio Feedback di Agent Platform consente di raccogliere e analizzare il feedback degli utenti dalle interazioni con gli agent. Fornisce l'infrastruttura necessaria, eliminando la necessità di gestire un database di feedback. Il servizio archivia le reazioni degli utenti e le collega alle sequenze temporali degli eventi di conversazione corrispondenti.

Puoi iniziare a raccogliere feedback per il tuo agent dagli utenti finali integrando direttamente l'API del servizio Feedback o utilizzando l'SDK. L'API e l'SDK consentono di gestire le voci di feedback utilizzando le operazioni CRUDL standard (crea, recupera, aggiorna, elimina ed elenca) e di allegare dettagli aggiuntivi della conversazione alle voci di feedback tramite la risorsa FeedbackContext.

Per saperne di più, consulta Gestire il feedback con l'SDK Python o l'API REST o Visualizzare il feedback nella console.

Concetti principali

  • Voce di feedback: tiene traccia di dati qualitativi discreti forniti da un utente finale. Ogni voce acquisisce il sentiment binario, le etichette di feedback specifiche e il testo in formato libero facoltativo.
  • Tipo di feedback: il sentiment binario dell'utente finale, rappresentato da thumbs_up e thumbs_down.
  • ID sessione (session_id) e ID evento (event_id): campi obbligatori che collegano il feedback a un evento o a un turno di conversazione specifico.
  • Contesto del feedback: una risorsa facoltativa allegata a una voce di feedback che memorizza le trascrizioni o i log delle conversazioni, mantenendo il contesto anche se la sessione originale viene eliminata. Questa risorsa può memorizzare l' intera conversazione o i messaggi selezionati dall'utente, a seconda di ciò che scegli di includere.
  • Etichetta di feedback: una classificazione che specifica la natura di un problema operativo o di un risultato positivo.
    • Le etichette di feedback positive (in genere utilizzate con thumbs_up) includono:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Le etichette di feedback negative (in genere utilizzate con thumbs_down) includono:
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

Prima di iniziare

Per utilizzare il servizio Feedback, assicurati di avere:

  • Un'istanza di Agent Runtime esistente. Per saperne di più, consulta Sviluppare un agent di Agent Development Kit.
  • (Facoltativo) Per visualizzare le voci di feedback accanto agli eventi di traccia nella console, assicurati che l'istanza di Agent Runtime abbia la traccia abilitata.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per utilizzare il servizio Feedback, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Se stai effettuando richieste al servizio Feedback da Google Cloud, assicurati che il tuo account di servizio disponga delle autorizzazioni necessarie. I service account gestiti dall'utente devono disporre dell'autorizzazione Utente della piattaforma agent (aiplatform.user) per interagire con il servizio Feedback.

Il service agent Reasoning Engine dispone già delle autorizzazioni necessarie per gestire il feedback, pertanto le richieste in uscita da Agent Runtime dovrebbero già avere la permissione per accedere al servizio Feedback.

Passaggi successivi