Mit dem Agent Platform Feedback-Dienst können Sie Nutzerfeedback aus Interaktionen mit Ihren Agenten erfassen und analysieren. Er bietet die erforderliche Infrastruktur, sodass Sie keine eigene Feedback-Datenbank verwalten müssen. Der Dienst speichert Nutzerreaktionen und verknüpft sie mit den entsprechenden Zeitachsen für Unterhaltungsereignisse.
Sie können Feedback für Ihren Agent von Ihren Endnutzern erfassen, indem Sie den Dienst direkt in die Feedback-Dienst-API einbinden oder das SDK verwenden. Mit der API und dem SDK können Sie Feedbackeinträge mit den Standard-CRUDL-Vorgängen (Erstellen, Abrufen, Aktualisieren, Löschen und Auflisten) verwalten und Feedbackeinträgen über die Ressource FeedbackContext zusätzliche Unterhaltungsdetails hinzufügen.
Weitere Informationen finden Sie unter Feedback mit dem Python SDK oder der REST API verwalten oder Feedback in der Konsole ansehen.
Wichtige Konzepte
- Feedbackeintrag: Erfasst diskrete qualitative Daten , die von einem Endnutzer bereitgestellt werden. Jeder Eintrag enthält eine binäre Sentimentanalyse, spezifische Feedbacklabels und optionalen Freitext.
- Feedbacktyp: Die binäre Sentimentanalyse des Endnutzers,
dargestellt durch
thumbs_upundthumbs_down. - Sitzungs-ID (
session_id) und Ereignis-ID (event_id): Erforderliche Felder, die Feedback mit einem bestimmten Unterhaltungsschritt oder Ereignis verknüpfen. - Feedbackkontext: Eine optionale Ressource, die an einen Feedbackeintrag angehängt wird und Transkripte oder Unterhaltungsprotokolle speichert. So bleibt der Kontext auch dann erhalten, wenn die ursprüngliche Sitzung gelöscht wird. Diese Ressource kann die gesamte Unterhaltung oder die vom Nutzer ausgewählten Nachrichten speichern, je nachdem, was Sie einbeziehen möchten.
- Feedbacklabel: Eine Klassifizierung, die die
Art eines betrieblichen Problems oder eines erfolgreichen Ergebnisses angibt.
- Positive Feedbacklabels (in der Regel mit
thumbs_upverwendet):accuratecompletehelpfulon_topicfastsafefactualtool_success
- Negative Feedbacklabels (in der Regel mit
thumbs_downverwendet):inaccurateincompleteunhelpfuloff_topictoo_slowunsafehallucinationtool_error
- Positive Feedbacklabels (in der Regel mit
Hinweis
Damit Sie den Feedback-Dienst verwenden können, benötigen Sie Folgendes:
- Eine vorhandene Agent Runtime-Instanz. Weitere Informationen finden Sie unter Agent Development Kit-Agent entwickeln.
- Optional: Wenn Sie Feedbackeinträge neben Trace-Ereignissen in der Konsole sehen möchten, muss die Trace-Funktion für Ihre Agent Runtime-Instanz aktiviert sein.
Erforderliche Rollen abrufen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung des Feedback-Dienstes benötigen:
-
Alle:
Agent Platform-Nutzer (
roles/aiplatform.user)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Wenn Sie Anfragen an den Feedback-Dienst senden Google Cloud, müssen Sie sicherstellen, dass Ihr Dienstkonto die erforderlichen Berechtigungen hat. Von Nutzern verwaltete Dienstkonten müssen die Berechtigung „Agent Platform-Nutzer“ (aiplatform.user) haben, um mit dem Feedback-Dienst interagieren zu können.
Der Reasoning Engine-Dienst-Agent hat bereits die erforderlichen Berechtigungen zum Verwalten von Feedback. Ausgehende Anfragen von Agent Runtime sollten daher bereits die Berechtigung für den Zugriff auf den Feedback-Dienst haben.
Nächste Schritte
- Feedback mit dem Python SDK oder der REST API verwalten
- Feedback in der Google Cloud Konsole ansehen