Feedback in der Google Cloud Console ansehen

Auf dieser Seite wird beschrieben, wie Sie in der Google Cloud Console das erhaltene Endnutzer-Feedback ansehen.

Hinweis

Damit Sie Feedbackeinträge in der Google Cloud Console ansehen können, müssen folgende Voraussetzungen erfüllt sein:

  • Für Ihre Agent Runtime-Instanz ist das Tracing aktiviert.
  • Ihr Agent ist so konfiguriert, dass er OpenTelemetry (OTel) verwendet, um Trace-Spans zu generieren und die Weitergabe von Trace-Kontext zu verarbeiten. In der Console-UI werden Feedbackeinträge mithilfe des von OpenTelemetry generierten Span-Attributs gcp.vertex.agent.event_id Traces zugeordnet.

Feedback ansehen

Der Feedback-Dienst ist in den Tab Google Cloud **Traces** in der Console eingebunden. Auf dem Tab Traces können Sie Traces mit angehängtem Feedback sowohl auf dem Tab Sitzungsansicht als auch auf dem Tab Trace-Ansicht ansehen und filtern.

So sehen Sie Feedbackeinträge für Ihren Agent:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Platform > KI-Agenten auf.
  2. Wählen Sie im linken Navigationsmenü Deployments aus.

  3. Wählen Sie den Agent aus.

    Zu Deployments

    Agent Engine-Instanzen, die Teil des ausgewählten Projekts sind, werden in der Liste angezeigt. Mit dem Feld Filter können Sie die Liste nach der von Ihnen angegebenen Spalte filtern.

  4. Klicken Sie auf den Namen Ihrer Agent Engine-Instanz.

  5. Klicken Sie auf den Tab Traces. Verwenden Sie die Sitzungsansicht oder die Trace-Ansicht , um Traces mit Feedback zu finden:

    • Sitzungsansicht:
      1. Filtern Sie die Liste der Sitzungen nach der Spalte Feedback.
      2. Klicken Sie auf die Sitzung, die Sie ansehen möchten, um die Liste der Traces aufzurufen.
      3. Wählen Sie eine Trace-ID aus, für die ein Feedback-Symbol angezeigt wird.
    • Trace-Ansicht:
      1. Klicken Sie auf den Tab Trace-Ansicht.
      2. Filtern Sie die Liste der Traces nach der Spalte Feedback.
      3. Wählen Sie eine Trace-ID aus, für die ein Feedback-Symbol angezeigt wird.

  6. Klicken Sie im Bereich mit den Trace-Details auf den Tab Feedback , um die Feedbackdetails wie Feedbacktyp, Kommentare, Labels, ID und Erstellungszeit anzusehen.

UI-Einschränkungen

  • Anforderungen an die Ereignis-ID: Die UI unterstützt nur das Tracking und die Zuordnung von Feedbackeinträgen, die die von OpenTelemetry generierte UUID (gcp.vertex.agent.event_id) verwenden, die aus den Trace-Spans abgerufen wird.
  • Doppelte Einreichungen: Wenn mehrere Feedbackeinträge mit derselben session_id und event_id Kombination eingereicht werden, wird in der Console-UI nur der zuletzt eingegangene Feedbackeintrag angezeigt.

Cloud Trace-Einbindung

Wenn ein Nutzer Feedback einreicht, exportiert der Feedback-Dienst Telemetrie-Spans nach Cloud Trace. Wenn Sie Nutzerfeedback neben Ereignissen der Reasoning Engine-Ausführung finden möchten, suchen und filtern Sie diese exportierten Spans nach ihren Attributen. Weitere Informationen zum Suchen und Ansehen dieser Traces finden Sie im Leitfaden zum Einrichten des Tracings.

Da Traces unveränderlich sind, hat das Löschen oder Aktualisieren eines Feedbackeintrags keine Auswirkungen auf zuvor exportierte Traces.

Jeder Feedback-Telemetrie-Trace enthält einen Span mit dem Namen gcp.vertex.agent.feedback mit den folgenden Ressourcen- und Span-Attributen:

Attribut Attributtyp Beschreibung
gcp.project_id Ressource Projekt-ID eines Google Cloud Console-Projekts.
cloud.resource.id Ressource ID der Reasoning Engine-Instanz.
gcp.vertex.agent.feedback.type Span Feedbacktyp (THUMBS_UP, THUMBS_DOWN, oder FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Span Sitzungs-ID, die mit der Interaktion verknüpft ist.
gcp.vertex.agent.event_id Span Ereignis-ID, die mit der jeweiligen Konversationsrunde verknüpft ist.
gcp.vertex.agent.feedback.entry.name Span Ressourcenpfad des erstellten Feedbackeintrags.
gcp.vertex.agent.feedback.labels Span Optional. Liste der Feedbacklabels.

Nächste Schritte