Feedback zu UIP-Ablaufverfolgungen

Syntax und Optionen für „uip Traces Feedback“, das Feedback zur LLM-Beobachtung erstellt und verwaltet, das an eine Ablaufverfolgung oder einen Bereich angehängt ist.

uip traces feedback verwaltet das Feedback zur LLM-Beobachtung – eine positive/negative Bewertung, ein Kommentar und Kategorie-Tags, die an eine Ablaufverfolgung oder einen Bereich angehängt sind. Verwenden Sie sie, um die menschliche Überprüfung der Ausgabe eines Agents aufzuzeichnen oder um aufgezeichnetes Feedback für die Berichterstattung abzurufen.

Diese Seite ist Teil des uip traces -Tools – siehe diese Seite für spans get.

Zusammenfassung

uip traces feedback create --trace-id <id> (--positive | --negative) --folder-key <guid> [--span-id <id>] [--comment <text> | --comment-file <path>] [--category <tag>...] [--agent-id <guid>] [--agent-version <str>]
uip traces feedback get <id> [--folder-key <guid>]
uip traces feedback list [--agent-id <guid>] [--agent-version <str>] [--trace-id <id>] [--span-id <id>] [--status <value>...] [--positive | --negative] [--limit <n>] [--offset <n>] [--folder-key <guid>]
uip traces feedback list detailed [--agent-id <guid>] [--agent-version <str>] [--trace-id <id>] [--span-id <id>] [--status <value>...] [--positive | --negative] [--category-id <guid>...] [--after <iso> | --since <duration>] [--before <iso>] [--sort-by <field>] [--sort-order <dir>] [--limit <n>] [--offset <n>] [--folder-key <guid>]
uip traces feedback update <id> (--positive | --negative) --folder-key <guid> [--comment <text> | --comment-file <path>] [--metadata <json> | --metadata-file <path>] [--category <tag>...]
uip traces feedback delete <id> --folder-key <guid> -y

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes.

UIP-Ablaufverfolgungen Feedback erstellen

Erstellen Sie Feedback für eine Ablaufverfolgung (oder einen bestimmten Bereich innerhalb dieser).

Optionen

Markieren	Beschreibung
--trace-id <id>	Erforderlich. Ablaufverfolgungs-ID (32-char Hex oder GUID).
--positive / --negative	Erforderlich – genau eine. Stimmung des Feedbacks.
--folder-key <guid>	Erforderlich. Orchestrator-Ordnerschlüssel.
--span-id <id>	Spannen-ID. Standardmäßig wird der Stammbereich der Ablaufverfolgung verwendet, wenn er weggelassen wird.
--comment <text>	Freitext-Anmerkung (max. 1.048.576 Zeichen). Sich gegenseitig mit --comment-file ausschließen.
--comment-file <path>	Den Kommentar aus einer Datei lesen; Übergeben Sie -, um aus Standardeinstellungen zu lesen. Sich gegenseitig mit --comment ausschließen.
--category <tag>	Kategorie-Tag. Wiederholbar. Die Plattform erkennt integrierte Tags wie Output, Agent Error und Agent Plan Execution, aber jeder String wird akzeptiert.
--agent-id <guid>	Agent-Referenz-ID.
--agent-version <str>	Agent-Version (max. 100 Zeichen).

Beispiel

uip traces feedback create \
  --trace-id 4bf92f3577b34da6a3ce929d0e0e4736 \
  --positive \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "FeedbackCreate",
  "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002" }
}

Data ist eine unveränderte Übergabe von allem, was die Feedback-API zurückgibt – die CLI prognostiziert es nicht auf einen festen Feldsatz, sodass die echte Antwort mehr Felder als hier gezeigt enthalten kann.

UIP-Ablaufverfolgungen Feedback abrufen

Rufen Sie einen einzelnen Feedbackdatensatz nach ID ab.

Argumente

• <id> (erforderlich) – Feedback-Datensatz-ID (GUID). Fehler auf Clientseite mit „Ungültiges Feedback-ID-Format“ wenn es sich nicht um eine GUID handelt.

Optionen

Markieren	Beschreibung
--folder-key <guid>	Orchestrator-Ordnerschlüssel. Der Server benötigt dies im Allgemeinen, um den Lesevorgang zu autorisieren, obwohl die CLI ohne ihn auf der Clientseite nicht schwer fehlschlägt.

Beispiel

uip traces feedback get a1b2c3d4-0000-0000-0000-000000000002 \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "FeedbackGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "IsPositive": true
  }
}

Wie create ist Data ein unformatiertes Durchlaufen – die echte Antwort enthält in der Regel mehr Felder (Kommentar, Metadaten, Kategorien, Zeitstempel), als dieses minimale Beispiel zeigt.

Feedbackliste zu UIP-Ablaufverfolgungen

Listen Sie Feedbackeinträge auf, die nach Ablaufverfolgung, Spanne, Agent, Status oder Stimmung gefiltert sind.

Optionen

Markieren	Beschreibung
--agent-id <guid>	Filtern Sie nach Agent-ID.
--agent-version <str>	Filtern Sie nach Agent-Version.
--trace-id <id>	Filtern Sie nach Ablaufverfolgungs-ID.
--span-id <id>	Filtern Sie nach Spannen-ID.
--status <value>	Nach Status filtern: Pending, Approved, Dismissed. Wiederholbar.
--positive / --negative	Nur positives oder nur negatives Feedback zurückgeben. Sich gegenseitig ausschließen.
--limit <n>	Max. Ergebnisse. Standardmäßig auf 20, begrenzt auf 100.
--offset <n>	Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.
--folder-key <guid>	Orchestrator-Ordnerschlüssel.

Beispiel

uip traces feedback list --trace-id 4bf92f3577b34da6a3ce929d0e0e4736

Datenform

{
  "Code": "FeedbackList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000002",
      "IsPositive": true
    }
  ]
}

Ein leeres Ergebnis gibt Folgendes aus: „Kein Feedback gefunden. Verwenden Sie „uip Traces Feedback Create“, um Feedback hinzuzufügen.“

Feedbackliste zu UIP-Ablaufverfolgungen detailliert

Listen Sie Feedback mit erweiterten Filtern (Zeitfenster, Kategorie, Sortierung) und Spannenkontext auf. Dies ist ein Unterbefehl von list, kein Verb der obersten Ebene – der Aufruf ist uip traces feedback list detailed mit dem Leerzeichen, nicht list-detailed.

Optionen

Markieren	Beschreibung
--agent-id <guid>	Filtern Sie nach Agent-ID.
--agent-version <str>	Filtern Sie nach Agent-Version.
--trace-id <id>	Filtern Sie nach Ablaufverfolgungs-ID.
--span-id <id>	Filtern Sie nach Spannen-ID.
--status <value>	Nach Status filtern: Pending, Approved, Dismissed. Wiederholbar.
--positive / --negative	Nur positives oder nur negatives Feedback zurückgeben. Sich gegenseitig ausschließen.
--category-id <guid>	Filtern Sie nach Kategorie-ID. Wiederholbar.
--after <iso>	Erstellt nach diesem ISO 8601-Zeitstempel.
--before <iso>	Erstellt vor diesem ISO 8601-Zeitstempel.
--since <duration>	Relative Lookback-Kurzbefehl für --after – z. B. 1h, 24h, 7d. Es werden nur die Einheiten h (Stunden) und d (Tage) akzeptiert.
--sort-by <field>	Sortierfeld: createdAt oder updatedAt. Die Standardeinstellung ist createdAt.
--sort-order <dir>	Sortierrichtung: asc oder desc. Die Standardeinstellung ist desc.
--limit <n>	Max. Ergebnisse. Die Standardeinstellung ist 20, begrenzt auf 200 (höher als die Obergrenze von 100 für list).
--offset <n>	Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.
--folder-key <guid>	Orchestrator-Ordnerschlüssel.

Hinweis:

--since und --after legen beide denselben zugrunde liegenden Startzeitfilter fest – --since wird relativ zu „Jetzt“ ausgewertet; zum Zeitpunkt der Ausführung des Befehls.

Beispiel

uip traces feedback list detailed --since 24h

Datenform

{
  "Code": "FeedbackListDetailed",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000002",
      "IsPositive": true,
      "TraceId": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ]
}

Die zugrunde liegende API-Antwort ist paginiert ({ items, totalCount }), aber die CLI gibt das items -Array nur als Data aus – die Gesamtanzahl der Übereinstimmungen (totalCount) wird nicht angezeigt. Um zu wissen, ob weitere Ergebnisse über --limit hinaus vorhanden sind, vergleichen Sie die zurückgegebene Anzahl mit --limit, anstatt sich auf eine Gesamtsumme zu verlassen.

Aktualisierung des Feedbacks zu UIP-Ablaufverfolgungen

Aktualisieren Sie die Stimmung, den Kommentar, die Metadaten oder die Kategorien eines vorhandenen Feedbackdatensatzes.

Wichtig:

Die API ersetzt den gesamten Datensatz, anstatt ihn zupatch, also liest die CLI zuerst den vorhandenen Datensatz und übernimmt jedes Feld, das Sie nicht übergeben haben – mit Ausnahme von --category: Wenn Sie es weglassen, bleiben vorhandene Kategorien unberührt, aber dieses Lesen-Then-Schreiben ist möglich nicht atomare. Eine gleichzeitige Bearbeitung zwischen dem Lesen und Schreiben geht im Hintergrund verloren.

Argumente

• <id> (erforderlich) – Feedback-Datensatz-ID (GUID).

Optionen

Markieren	Beschreibung
--positive / --negative	Erforderlich – genau eine. Neue Stimmung.
--folder-key <guid>	Erforderlich. Orchestrator-Ordnerschlüssel.
--comment <text>	Aktualisierter Kommentar (max. 1.048.576 Zeichen). Sich gegenseitig mit --comment-file ausschließen. Lassen Sie den vorhandenen Kommentar weg, um den vorhandenen Kommentar beizubehalten.
--comment-file <path>	Lesen des aktualisierten Kommentars aus einer Datei; Übergeben Sie - für Stdin. Sich gegenseitig mit --comment ausschließen.
--metadata <json>	Aktualisierte Metadaten; muss ein gültiges JSON-Format haben (max. 1.048.576 Zeichen). Sich gegenseitig mit --metadata-file ausschließen. Lassen Sie die Metadaten weg, um die vorhandenen Metadaten beizubehalten.
--metadata-file <path>	Aktualisierte Metadaten aus einer Datei lesen; Übergeben Sie - für Stdin. Sich gegenseitig mit --metadata ausschließen.
--category <tag>	Ersatzkategorie-Tags. Wiederholbar. Vollständig weglassen, um vorhandene Kategorien unverändert zu lassen – sie übergeben den vollständigen Satz und werden nicht zusammengeführt.

Beispiele

# change sentiment and add a comment
uip traces feedback update a1b2c3d4-0000-0000-0000-000000000002 \
  --negative \
  --comment "Wrong output" \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

# attach metadata read from a file
uip traces feedback update a1b2c3d4-0000-0000-0000-000000000002 \
  --positive \
  --metadata-file review.json \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "FeedbackUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "IsPositive": false
  }
}

UIP-Ablaufverfolgungen von Feedback löschen

Löschen Sie einen Feedbackdatensatz nach ID. Dies ist ein unwiderruflicher Vorgang – er erfordert -y, --yes; die CLI fordert nie auf.

Argumente

• <id> (erforderlich) – Feedback-Datensatz-ID (GUID).

Optionen

Markieren	Beschreibung
--folder-key <guid>	Erforderlich. Orchestrator-Ordnerschlüssel.
-y, --yes	Bestätigen Sie diesen nicht rückgängig zu machenden Vorgang. Erforderlich – die CLI fordert nie auf.

Beispiel

uip traces feedback delete a1b2c3d4-0000-0000-0000-000000000002 \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001 \
  --yes

Datenform

{
  "Code": "FeedbackDelete",
  "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002" }
}

Fehlerverhalten

• 401 aus der Feedback-API: Failure: "Not authenticated. Run 'uip auth login' first.".
• 403: Failure: "Insufficient permissions. Ensure you have Logs.View / Logs.Create / Logs.Delete on this folder.".
• 404: Failure benennen die fehlende Feedback-ID.
• Eine ID, die keine GUID ist (get, update, delete): Failure: "Invalid feedback ID format: <id>", wurde vor einem Netzwerkaufruf auf Clientseite überprüft.

Zugehörig

• uip traces spans get – Quelle der oben verwendeten Werte --trace-id/--span-id .
• Tools (Plugins) – Installieren, Aktualisieren und Deinstallieren des Pakets traces-tool .
• uip login – Sitzung, die zur Authentifizierung jedes Verbs auf dieser Seite verwendet wird.

Siehe auch

• uip traces