uip eval eval-set & Auswertung

Syntax und Optionen zum Verwalten von Orchestrator-Auswertungssätzen und den darin enthaltenen Auswertungen (Datenpunkte) mit „uip eval eval-set“ und „uip eval evaluation“.

Teil des uip eval -Subsystems. Diese Seite behandelt die beiden Ressourcen, die definieren , was ausgewertet wird:

• eval eval-set – eine benannte, prozessbezogene Sammlung von Auswertungsdatenpunkten, die über --evaluator-refs mit einem oder mehreren Auswertern verknüpft ist. Ein Auswertungssatz enthält auch Batch-/Timeout-Einstellungen, die bei der Ausführung verwendet werden.
• eval evaluation – Ein Datenpunkt innerhalb eines Auswertungssatzes: eine Eingabenutzlast, eine optionale erwartete Ausgabe/ein Verhalten und optionale Überschreibungen von Kriterien pro Auswerter. execute-and-evaluate und schedule -Ausführungen durchlaufen die Auswertungen eines Auswertungssatzes und bewerten jede mit den verknüpften Auswertern des Auswertungssatzes.

Zusammenfassung

uip eval eval-set list --process-key <guid> [--limit <n>] [--offset <n>] [--tenant <tenant>]
uip eval eval-set get <evalSetId> --process-key <guid> [--tenant <tenant>]
uip eval eval-set create --process-key <guid> --workload-id <guid> --folder-key <guid> --name <name> [options...] [--tenant <tenant>]
uip eval eval-set update <evalSetId> --process-key <guid> [options...] [--tenant <tenant>]
uip eval eval-set delete <evalSetId> --process-key <guid> [--tenant <tenant>]

uip eval evaluation list --process-key <guid> --eval-set-id <guid> [--limit <n>] [--offset <n>] [--tenant <tenant>]
uip eval evaluation get <evaluationId> --process-key <guid> --eval-set-id <guid> [--tenant <tenant>]
uip eval evaluation create --process-key <guid> --eval-set-id <guid> --folder-key <guid> --name <name> --inputs <json> [options...] [--tenant <tenant>]
uip eval evaluation update <evaluationId> --process-key <guid> --eval-set-id <guid> [options...] [--tenant <tenant>]
uip eval evaluation delete <evaluationId> --process-key <guid> --eval-set-id <guid> [--tenant <tenant>]

UIP-Auswertung eval-set-Liste

Listen Sie die für einen Prozess definierten Auswertungssätze auf.

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel. Verwenden Sie uip or processes list um einen zu finden.
--limit <n>	Integer	nein	Maximale Anzahl der zurückzugebenden Elemente. Der Standardwert ist 100.
--offset <n>	Integer	nein	Zu überspringende Elemente. Der Standardwert ist 0.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval eval-set list --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalSetList",
  "Data": [
    {
      "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
      "Name": "Smoke Tests",
      "Description": "Basic smoke tests",
      "BatchSize": 10,
      "EvaluatorRefs": ["ev-1", "ev-2"],
      "CreatedAt": "2026-08-01T10:00:00Z"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 100, "Offset": 0 }
}

BatchSize ist "-", wenn er nicht festgelegt ist. UpdatedAt ist nur vorhanden, nachdem der Auswertungssatz mindestens einmal aktualisiert wurde.

UIP-Auswertung eval-set abrufen

Rufen Sie die Details eines Auswertungssatzes ab.

Argumente

Name	Erforderlich	Zweck
<evalSetId>	ja	Auswertungssatz-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval eval-set get f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalSetDetails",
  "Data": {
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "Name": "Smoke Tests",
    "Description": "Basic smoke tests",
    "BatchSize": 10,
    "EvaluatorRefs": ["ev-1", "ev-2"],
    "CreatedAt": "2026-08-01T10:00:00Z"
  }
}

UIP-Auswertung eval-set erstellen

Erstellen Sie einen Auswertungssatz für einen Prozess.

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--workload-id <guid>	GUID	ja	Workload-ID.
--folder-key <guid>	GUID	ja	Ordnerschlüssel.
--name <name>	string	ja	Name des Auswertungssatzes.
--description <text>	string	nein	Beschreibung des Auswertungssatzes.
--batch-size <n>	Integer ≥ 1	nein	Max. gleichzeitige Auswertungen pro Ausführung.
--timeout-minutes <n>	Integer ≥ 1	nein	Timeout in Minuten pro Auswertung.
--evaluator-refs <refs...>	durch Leerzeichen getrennte IDs	nein	Auswerter- IDs, die mit diesem Auswertungssatz verknüpft werden sollen. Variadic – Übergeben Sie mehrere IDs, die durch Leerzeichen getrennt sind, nicht durch Kommas.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Bei jeder Erstellung wird automatisch eine interne externalId (eine zufällige UUID) generiert – sie ist nicht vom Benutzer konfigurierbar.

Beispiel

uip eval eval-set create --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 \
  --workload-id a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-key f1f2f3f4-0000-0000-0000-000000000001 \
  --name "Smoke Tests" --evaluator-refs ev-1 ev-2

Datenform (--output json)

{
  "Code": "EvalSetCreated",
  "Data": { "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04", "Name": "Smoke Tests" }
}

Aktualisierung der UIP-Auswertung eval-set

Aktualisieren Sie einen vorhandenen Auswertungssatz. Über --process-key hinaus ist mindestens ein aktualisiertes Feld erforderlich; Felder, die Sie weglassen, behalten ihren aktuellen Wert bei (der Befehl liest zuerst den vorhandenen Auswertungssatz und wendet dann Ihre Änderungen oben an).

Argumente

Name	Erforderlich	Zweck
<evalSetId>	ja	Auswertungssatz-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--name <name>	string	Nein*	Neuer Name des Auswertungssatzes.
--description <text>	string	Nein*	Neue Beschreibung.
--batch-size <n>	Integer ≥ 1	Nein*	Neue max. gleichzeitige Auswertungen.
--timeout-minutes <n>	Integer ≥ 1	Nein*	Neues Timeout in Minuten.
--evaluator-refs <refs...>	durch Leerzeichen getrennte IDs	Nein*	Ersetzt die vollständige „evaluator-refs“-Liste (nicht zusätzlich).
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

* Mindestens eine von --name, --description, --batch-size, --timeout-minutes oder --evaluator-refs ist erforderlich – der Befehl schlägt schnell fehl, wenn keine übergeben werden.

Beispiel

uip eval eval-set update f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 \
  --name "Updated Name" --evaluator-refs ev-1 ev-2

Datenform (--output json)

{
  "Code": "EvalSetUpdated",
  "Data": {
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "Name": "Updated Name",
    "EvaluatorRefs": ["ev-1", "ev-2"]
  }
}

UIP-Auswertung eval-set löschen

Löschen Sie einen Auswertungssatz.

Argumente

Name	Erforderlich	Zweck
<evalSetId>	ja	Auswertungssatz-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval eval-set delete f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{ "Code": "EvalSetDeleted", "Data": { "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04" } }

Das Löschen eines Auswertungssatzes führt nicht zu einem Kaskadenlöschen oder einer anderen Warnung vor Zeitplänen oder Auswertern, die darauf verweisen – die CLI gibt ein einfaches DELETE ohne Abhängigkeitsprüfung aus.

UIP-Auswertungsliste

Listen Sie die Auswertungen (Datenpunkte) innerhalb eines Auswertungssatzes auf.

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--eval-set-id <guid>	GUID	ja	Evaluierungssatz-ID.
--limit <n>	Integer	nein	Maximale Anzahl der zurückzugebenden Elemente. Der Standardwert ist 100.
--offset <n>	Integer	nein	Zu überspringende Elemente. Der Standardwert ist 0.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval evaluation list --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04

Datenform (--output json)

{
  "Code": "EvaluationList",
  "Data": [
    {
      "EvaluationId": "c1d2e3f4-0000-0000-0000-000000000001",
      "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
      "Name": "Greeting test",
      "Inputs": { "input": "hello" },
      "ExpectedOutput": { "content": "Hi there!" },
      "ExpectedBehavior": "",
      "CreatedAt": "2026-08-01T10:00:00Z"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 100, "Offset": 0 }
}

Abrufen der UIP-Auswertung

Rufen Sie die Details einer Auswertung ab.

Argumente

Name	Erforderlich	Zweck
<evaluationId>	ja	Auswertungs-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--eval-set-id <guid>	GUID	ja	Evaluierungssatz-ID.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval evaluation get c1d2e3f4-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04

Datenform (--output json)

Die gleiche Objektform wie ein Eintrag im Data -Array von evaluation list.

UIP-Auswertung erstellen

Fügen Sie eine Auswertung (Datenpunkt) zu einem Auswertungssatz hinzu.

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--eval-set-id <guid>	GUID	ja	Evaluierungssatz-ID.
--folder-key <guid>	GUID	ja	Ordnerschlüssel.
--name <name>	string	ja	Name der Auswertung.
--inputs <json>	JSON	ja	Eingabewerte, z. B. '{"input":"hello"}').
--expected-output <json>	JSON	nein	Erwartete Ausgabe für Auswerter mit Vergleichsstil.
--expected-behavior <text>	string	nein	Erwartete Beschreibung des Agent-Verhaltens für Verlaufsauswerter.
--evaluation-criterias <json>	JSON	nein	Überschreibungen von Kriterien pro Auswerter.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Falsch formatierte JSON auf --inputs, --expected-output oder --evaluation-criterias schlägt auf Clientseite vor jedem Netzwerkaufruf schnell fehl, mit einem Beispiel für die erwartete Form im Fehler für --inputs.

Beispiel

uip eval evaluation create --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 \
  --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 \
  --folder-key f1f2f3f4-0000-0000-0000-000000000001 \
  --name "Greeting test" --inputs '{"input":"hello"}' --expected-output '{"content":"Hi there!"}'

Datenform (--output json)

{
  "Code": "EvaluationCreated",
  "Data": {
    "EvaluationId": "c1d2e3f4-0000-0000-0000-000000000001",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "Name": "Greeting test"
  }
}

Aktualisierung der UIP-Auswertung

Aktualisieren Sie eine vorhandene Auswertung. Über --process-key/--eval-set-id hinaus ist mindestens ein aktualisiertes Feld erforderlich; ausgelassene Felder behalten ihren aktuellen Wert bei.

Argumente

Name	Erforderlich	Zweck
<evaluationId>	ja	Auswertungs-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--eval-set-id <guid>	GUID	ja	Evaluierungssatz-ID.
--name <name>	string	Nein*	Neuer Auswertungsname.
--inputs <json>	JSON	Nein*	Neue Eingabewerte.
--expected-output <json>	JSON	Nein*	Neue erwartete Ausgabe.
--expected-behavior <text>	string	Nein*	Neue Beschreibung des erwarteten Verhaltens.
--evaluation-criterias <json>	JSON	Nein*	Neue Kriterien pro Auswerter überschreiben.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

* Mindestens eine von --name, --inputs, --expected-output, --expected-behavior oder --evaluation-criterias ist erforderlich.

Beispiel

uip eval evaluation update c1d2e3f4-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 \
  --inputs '{"input":"updated"}' --expected-output '{"content":"new response"}'

Datenform (--output json)

{
  "Code": "EvaluationUpdated",
  "Data": {
    "EvaluationId": "c1d2e3f4-0000-0000-0000-000000000001",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "Name": "Greeting test"
  }
}

Löschen der UIP-Auswertung

Eine Auswertung aus einem Auswertungssatz entfernen.

Argumente

Name	Erforderlich	Zweck
<evaluationId>	ja	Auswertungs-ID (GUID).

Optionen

Long	Wert	Erforderlich	Beschreibung
--process-key <guid>	GUID	ja	Prozessschlüssel.
--eval-set-id <guid>	GUID	ja	Evaluierungssatz-ID.
--tenant <tenant>	name	nein	Name des UiPath-Mandanten.

Beispiel

uip eval evaluation delete c1d2e3f4-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04

Datenform (--output json)

{ "Code": "EvaluationDeleted", "Data": { "EvaluationId": "c1d2e3f4-0000-0000-0000-000000000001" } }

Zugehörig

• uip eval – Overview, execute-and-evaluate und run.
• uip eval-Zeitplan – wiederkehrende Bewertungsausführungen für einen Bewertungssatz.
• uip eval evaluator – Die Bewertungslogik, auf die der --evaluator-refs -Punkt eines Evaluierungssatzes verweist.
• uip or processes – löst ein --process-key aus.

Siehe auch

• Übersicht über das Orchestrator-Tool
• Globale Optionen
• Exitcodes