Batch-Upload für die Bewertung

Auf dieser Seite wird das Format beschrieben, das zum Hochladen von Golden Evaluations in einer CSV-Datei erforderlich ist. Weitere Informationen zu Golden Evaluations finden Sie in der Dokumentation zu Golden Evaluations.

Vorlage herunterladen

  • Rufen Sie den Tab Bewerten auf und klicken Sie auf + Testfall hinzufügen -> Golden.
  • Klicken Sie im angezeigten Menü auf Vorlage herunterladen.
  • Nachdem Sie mit der Vorlage eine CSV-Datei mit Ihren Golden Evaluations erstellt haben, können Sie sie hochladen. Klicken Sie dazu im selben Menü auf Datei hochladen.

Allgemeine Struktur

  • Eine einzelne CSV-Datei kann mehrere Bewertungen enthalten. Jede Bewertung kann sich über mehrere Zeilen erstrecken.
  • Die erste Zeile einer Bewertung ist die Bewertungszeile und definiert die allgemeinen Eigenschaften (Name und Metadaten).
  • Jede nachfolgende Zeile ist eine Unterhaltungszeile und definiert eine einzelne Unterhaltungsrunde in der Bewertung (z. B. sagt ein Endnutzer etwas, der Agent soll antworten oder ein Toolaufruf wird erwartet).
  • Sie können einen neuen Testfall starten, indem Sie in der Spalte display_name einen neuen Namen angeben. Jeder neue Wert für display_name definiert den Beginn einer neuen Bewertung.

Kopfzeile

Ihre CSV-Datei muss in der ersten Zeile eine Kopfzeile haben. Diese Kopfzeile definiert eine Datenvariable in jeder Spalte. Alle Variablen außer den erforderlichen Variablen sind optional, sofern sie nicht durch einen action_type Wert erforderlich sind. Optionale Variablenspalten können nach den erforderlichen Variablen in beliebiger Reihenfolge angeordnet sein.

  • Erforderliche Variablen: display_name, turn_index, action_type.

Unterhaltungsbewertung definieren

Jede neue Bewertung beginnt mit einer Bewertungszeile. Jede Unterhaltungszeile unter der Bewertungszeile entspricht einer Unterhaltungsrunde bis zur nächsten Bewertungszeile.

Bewertungszeile

Die erste Zeile nach der Kopfzeile muss eine Bewertungszeile sein. Jede Bewertungszeile definiert eine neue Bewertung.

  • Erforderlich:Geben Sie im Feld display_name einen eindeutigen, für Menschen lesbaren Namen für die Bewertung ein.
  • Optional: Sie können in dieser Zeile optional Daten für eine beliebige Metadatenvariable hinzufügen.

Unterhaltungszeile

Jede Zeile entspricht Daten aus einer Unterhaltungsrunde.

  • Erforderlich:Geben Sie Werte in die Felder turn_index und action_type ein. display_name muss leer bleiben.
  • Optional: Geben Sie Werte für alle anderen Kopfzeilenspalten als Metadatenvariablen oder display_name ein.

Variablen

In den folgenden Tabellen werden die verfügbaren Datenvariablen beschrieben. Alle Variablen außer den erforderlichen Variablen sind optional, sofern sie nicht durch einen action_type-Wert erforderlich sind. Alle Variablen müssen in der Kopfzeile definiert werden, eine pro Spalte. Optionale Variablenspalten können nach den erforderlichen Spalten in beliebiger Reihenfolge angeordnet sein.

Erforderliche Kopfzeilenvariablen

Spaltenname Beschreibung
display_name Der für Menschen lesbare Name Ihrer Bewertung. Dieser Wert wird nur für die erste Zeile einer neuen Bewertung angegeben. Jeder neue Wert für display_name definiert eine neue Bewertung.
turn_index Eine Zahl (1, 2, 3 usw.), die die Reihenfolge der Unterhaltungsrunde angibt. Alle Zeilen in einer Runde haben denselben Indexwert. Die Werte müssen für jede Bewertung bei 1 beginnen. Jede nachfolgende Zeile muss einen Wert haben, der gleich oder größer als der Wert der vorherigen Zeile ist.
action_type Gibt an, was die Daten in dieser Zeile darstellen. Jeder Wert hat optionale Variablenwerte, die ebenfalls ausgefüllt werden müssen (wie angegeben), damit die Unterhaltungsrunde korrekt eingegeben wird. Der Eingabewert muss einer der folgenden sein:

INPUT_TEXT: Eine Texteingabe des Endnutzers.
- (Erforderlich) text_content.

INPUT_IMAGE: Eine Bildeingabe des Endnutzers.
- (Erforderlich) image_mime_type, image_content.

INPUT_TOOL_RESPONSE: Eine Toolantwort.
- (Erforderlich) tool_name.
- (Optional) tool_response_json.

INPUT_UPDATED_VARIABLES: Variablen aus einer Eingabe aktualisieren.
- (Erforderlich) updated_variables_json

EXPECTATION_TEXT: Erwartete Ausgabe einer Agent-Textantwort.
- (Erforderlich) response_agent, text_content.
- (Optional) expectation_note.

EXPECTATION_TOOL_CALL: Erwarteter Toolaufruf.
- (Erforderlich) tool_name.
- (Optional) tool_call_args_json, expectation_note.

EXPECTATION_TOOL_RESPONSE: Erwartete Toolantwort.
- (Erforderlich) tool_name.
- (Optional) expectation_note.

EXPECTATION_AGENT_TRANSFER: Erwartete Agent-Weiterleitung.
- (Erforderlich) agent_transfer_target.
- (Optional) expectation_note.

Metadatenvariablen

Spaltenname Beschreibung
evaluation_id Eine eindeutige ID für die Bewertung. Jeder Wert für evaluation_id muss für Ihren Customer Experience Agent Studio-Agent eindeutig sein. Wenn in dieser Spalte kein Wert manuell eingegeben wird, wird automatisch eine eindeutige ID generiert.
description Freitextnotizen oder eine Beschreibung des Zwecks der Bewertung.
tags Durch Semikolons getrennte Tags zum Organisieren von Bewertungen (z. B. „Tag1;Tag2“).
evaluation_groups Durch Semikolons getrennte Namen aller Bewertungsgruppen, zu denen die Bewertung gehört (z. B. „Gruppenname 1;Gruppenname 2“). Alle Werte für evaluation_groups, die in dieser Spalte eingegeben, aber nicht in der Kopfzeile definiert sind, werden ignoriert.

Variablen für Unterhaltungsrunden

Spaltenname Beschreibung
response_agent Name des Agent, der die Antwort gegeben hat. Wird nur für EXPECTATION_TEXT erwartet.
text_content Der Text für INPUT_TEXT oder EXPECTATION_TEXT.
image_mime_type Der IANA-Standard-MIME-Typ des Quellbilds. Unterstützte Werte: image/png, image/jpeg, image/webp, image/heic, image/heif.
image_content Byte-String von INPUT_IMAGE.
tool_name Der display_name für das Tool, das aufgerufen wird oder antwortet. Wird für INPUT_TOOL_RESPONSE,EXPECTATION_TOOL_CALL oder EXPECTATION_TOOL_RESPONSE erwartet.
tool_call_args_json Die JSON-Argumente für einen EXPECTATION_TOOL_CALL.
tool_response_json Der JSON-Inhalt einer INPUT_TOOL_RESPONSE.
updated_variables_json Der JSON-Inhalt für INPUT_UPDATED_VARIABLES.
agent_transfer_target Anzeigename des Zielagent für eine EXPECTATION_AGENT_TRANSFER.
expectation_note Hinweis oder Beschreibung der Erwartung.