UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

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 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​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel. Verwenden Sie uip or processes list um einen zu finden.
--limit <n>IntegerneinMaximale Anzahl der zurückzugebenden Elemente. Der Standardwert ist 100.
--offset <n>IntegerneinZu überspringende Elemente. Der Standardwert ist 0.
--tenant <tenant>nameneinName des UiPath-Mandanten.

Beispiel​

uip eval eval-set list --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09
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, "HasMore": false }
}
{
  "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, "HasMore": false }
}

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​

NameErforderlichZweck
<evalSetId>jaAuswertungssatz-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--tenant <tenant>nameneinName des UiPath-Mandanten.

Beispiel​

uip eval eval-set get f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09
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"
  }
}
{
  "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​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--workload-id <guid>GUIDjaWorkload-ID.
--folder-key <guid>GUIDjaOrdnerschlüssel.
--name <name>stringjaName des Auswertungssatzes.
--description <text>stringneinBeschreibung des Auswertungssatzes.
--batch-size <n>Integer ≥ 1neinMax. gleichzeitige Auswertungen pro Ausführung.
--timeout-minutes <n>Integer ≥ 1neinTimeout in Minuten pro Auswertung.
--evaluator-refs <refs...>durch Leerzeichen getrennte IDsneinAuswerter- IDs, die mit diesem Auswertungssatz verknüpft werden sollen. Variadic – Übergeben Sie mehrere IDs, die durch Leerzeichen getrennt sind, nicht durch Kommas.
--tenant <tenant>nameneinName 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
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" }
}
{
  "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​

NameErforderlichZweck
<evalSetId>jaAuswertungssatz-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--name <name>stringNein*Neuer Name des Auswertungssatzes.
--description <text>stringNein*Neue Beschreibung.
--batch-size <n>Integer ≥ 1Nein*Neue max. gleichzeitige Auswertungen.
--timeout-minutes <n>Integer ≥ 1Nein*Neues Timeout in Minuten.
--evaluator-refs <refs...>durch Leerzeichen getrennte IDsNein*Ersetzt die vollständige „evaluator-refs“-Liste (nicht zusätzlich).
--tenant <tenant>nameneinName 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
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"]
  }
}
{
  "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​

NameErforderlichZweck
<evalSetId>jaAuswertungssatz-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--tenant <tenant>nameneinName des UiPath-Mandanten.

Beispiel​

uip eval eval-set delete f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09
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" } }
{ "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​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--eval-set-id <guid>GUIDjaEvaluierungssatz-ID.
--limit <n>IntegerneinMaximale Anzahl der zurückzugebenden Elemente. Der Standardwert ist 100.
--offset <n>IntegerneinZu überspringende Elemente. Der Standardwert ist 0.
--tenant <tenant>nameneinName des UiPath-Mandanten.

Beispiel​

uip eval evaluation list --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04
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, "HasMore": false }
}
{
  "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, "HasMore": false }
}

Simulations appears on an evaluation only when it has simulations. Each entry carries ComponentId, ComponentType, and SimulationStrategy (Llm, Mockito, or Static), plus ComponentDescription, SimulationInstruction, OutputSchema, MockValue, Behaviors, and ChildSimulations when set. UpdatedAt appears once the evaluation has been updated.

Abrufen der UIP-Auswertung​

Rufen Sie die Details einer Auswertung ab.

Argumente​

NameErforderlichZweck
<evaluationId>jaAuswertungs-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--eval-set-id <guid>GUIDjaEvaluierungssatz-ID.
--tenant <tenant>nameneinName 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
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​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--eval-set-id <guid>GUIDjaEvaluierungssatz-ID.
--folder-key <guid>GUIDjaOrdnerschlüssel.
--name <name>stringjaName der Auswertung.
--inputs <json>JSONjaEingabewerte, z. B. '{"input":"hello"}').
--expected-output <json>JSONneinErwartete Ausgabe für Auswerter mit Vergleichsstil.
--expected-behavior <text>stringneinErwartete Beschreibung des Agent-Verhaltens für Verlaufsauswerter.
--evaluation-criterias <json>JSONneinÜberschreibungen von Kriterien pro Auswerter.
--simulations <json>JSON-ArrayneinSimulations for the components the process calls, for example '[{"componentId":"web-search","componentType":"tool"}]'. Each object needs componentId and componentType. For the LLM simulation strategy (the default), the CLI fills in a missing outputSchema from the deployed agent. Refer to uip eval simulatable-components list for the available components.
--tenant <tenant>nameneinName des UiPath-Mandanten.

Malformed JSON on --inputs, --expected-output, --evaluation-criterias, or --simulations fails fast client-side, with an example of the expected shape in the error for --inputs and --simulations. A simulation without a componentId or componentType fails with the index of the invalid entry.

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!"}'
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"
  }
}
{
  "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​

NameErforderlichZweck
<evaluationId>jaAuswertungs-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--eval-set-id <guid>GUIDjaEvaluierungssatz-ID.
--name <name>stringNein*Neuer Auswertungsname.
--inputs <json>JSONNein*Neue Eingabewerte.
--expected-output <json>JSONNein*Neue erwartete Ausgabe.
--expected-behavior <text>stringNein*Neue Beschreibung des erwarteten Verhaltens.
--evaluation-criterias <json>JSONNein*Neue Kriterien pro Auswerter überschreiben.
--simulations <json>JSON-ArrayNein*New simulations, replacing the current set. Same shape and validation as on evaluation create.
--tenant <tenant>nameneinName des UiPath-Mandanten.

* At least one of --name, --inputs, --expected-output, --expected-behavior, --evaluation-criterias, or --simulations is required.

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"}'
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"
  }
}
{
  "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​

NameErforderlichZweck
<evaluationId>jaAuswertungs-ID (GUID).

Optionen​

LongWertErforderlichBeschreibung
--process-key <guid>GUIDjaProzessschlüssel.
--eval-set-id <guid>GUIDjaEvaluierungssatz-ID.
--tenant <tenant>nameneinName 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
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" } }
{ "Code": "EvaluationDeleted", "Data": { "EvaluationId": "c1d2e3f4-0000-0000-0000-000000000001" } }
  • 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​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben