UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

uip eval eval-set & Évaluation

Syntaxe et options de gestion des ensembles d'évaluation Orchestrator et des évaluations (points de données) qu'ils contiennent avec « uip eval eval-set » et « uip eval evaluation ».

Une partie du sous-système uip eval . Cette page couvre les deux ressources qui définissent ce qui sera évalué:

  • eval eval-set — une collection nommée et à l'échelle du processus de points de données d'évaluation, liée à un ou plusieurs évaluateurs via --evaluator-refs. Un ensemble d’évaluation comporte également les paramètres de traitement par lots/d’expiration utilisés lors de son exécution.
  • eval evaluation — un point de données à l'intérieur d'un ensemble d'évaluation: une charge utile d'entrée, une sortie/un comportement attendu facultatif et des remplacements facultatifs des critères par évaluateur. execute-and-evaluate et schedule exécutent les évaluations d'un ensemble d'évaluation, notant chacune avec les évaluateurs liés de l'ensemble d'évaluation.

Synthèse​

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

liste ensembles d’évaluations uip eval​

Répertorie les ensembles d'évaluation définis pour un processus.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus. Utilisez uip or processes list pour en trouver un.
--limit <n>IntegernonNombre maximal d'éléments à renvoyer. Par défaut 100.
--offset <n>IntegernonÉléments à ignorer. Par défaut 0.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie 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 est "-" lorsqu'il n'est pas défini. UpdatedAt est présent uniquement une fois que l'ensemble d'évaluation a été mis à jour au moins une fois.

uip eval eval-set​

Obtenir les détails d'un ensemble d'évaluation.

Arguments​

NomRequisObjectif
<evalSetId>ouiID d’ensemble d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie 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"
  }
}

création d'un ensemble d'évaluation uip eval​

Créez un ensemble d'évaluation pour un processus.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--workload-id <guid>GUIDouiID de charge de travail.
--folder-key <guid>GUIDouiClé de dossier.
--name <name>stringouiNom de l’ensemble d’évaluation.
--description <text>stringnonDescription de l’ensemble d’évaluation.
--batch-size <n>entier ≥ 1nonNombre maximal d’évaluations simultanées par exécution.
--timeout-minutes <n>entier ≥ 1nonDélai d’expiration en minutes par évaluation.
--evaluator-refs <refs...>ID séparés par des espacesnonID d'évaluateur à lier à cet ensemble d’évaluation. Variables: saisissez plusieurs ID séparés par des espaces, sans virgules.
--tenant <tenant>namenonNom du locataire UiPath.

Un externalId interne (un UUID aléatoire) est généré automatiquement à chaque création — il n'est pas défini par l'utilisateur.

Exemple​

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

Format des données (--sortie 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" }
}

mise à jour de l’ensemble d’évaluation uip eval​

Mettez à jour un ensemble d’évaluation existant. Au moins un champ modifiable est requis au-delà de --process-key; les champs que vous omettez conservent leur valeur actuelle (la commande lit d’abord l’ensemble d’évaluation existant, puis applique vos modifications par-dessus).

Arguments​

NomRequisObjectif
<evalSetId>ouiID d’ensemble d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--name <name>stringnon*Nouveau nom d’ensemble d’évaluation.
--description <text>stringnon*Nouvelle description.
--batch-size <n>entier ≥ 1non*Nouvelles évaluations simultanées maximales.
--timeout-minutes <n>entier ≥ 1non*Nouveau délai d’attente en minutes.
--evaluator-refs <refs...>ID séparés par des espacesnon*Remplace la liste complète des références d’évaluateurs (non ajoutées).
--tenant <tenant>namenonNom du locataire UiPath.

* Au moins un de --name, --description, --batch-size, --timeout-minutes, ou --evaluator-refs est requis - la commande échoue rapidement si aucun n'est réussi.

Exemple​

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

Format des données (--sortie 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 eval eval-set - supprimer​

Supprimez un ensemble d'évaluation.

Arguments​

NomRequisObjectif
<evalSetId>ouiID d’ensemble d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie json)​

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

La suppression d'un ensemble d'évaluation ne constitue pas une suppression en cascade et ne prévient pas les planifications ou les évaluateurs qui le référencent — la CLI envoie une requête DELETE simple sans vérification des dépendances.

liste d’évaluations uip eval​

Répertoriez les évaluations (points de données) au sein d'un ensemble d'évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--eval-set-id <guid>GUIDouiID de l’ensemble d’évaluation.
--limit <n>IntegernonNombre maximal d'éléments à renvoyer. Par défaut 100.
--offset <n>IntegernonÉléments à ignorer. Par défaut 0.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie 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 apparaît sur une évaluation uniquement lorsqu'il contient des simulations. Chaque entrée comporte ComponentId, ComponentType et SimulationStrategy (Llm, Mockito ou Static), plus ComponentDescription, SimulationInstruction, OutputSchema, MockValue, Behaviors et ChildSimulations lorsque défini. UpdatedAt apparaît une fois l'évaluation mise à jour.

obtention de l’évaluation uip eval​

Obtenir les détails d'une évaluation.

Arguments​

NomRequisObjectif
<evaluationId>ouiID d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--eval-set-id <guid>GUIDouiID de l’ensemble d’évaluation.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie json)​

Même forme d'objet qu'une entrée dans le tableau Data de evaluation list.

création d’évaluation d’évaluation uip​

Ajoutez une évaluation (point de données) à un ensemble d'évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--eval-set-id <guid>GUIDouiID de l’ensemble d’évaluation.
--folder-key <guid>GUIDouiClé de dossier.
--name <name>stringouiNom de l’évaluation.
--inputs <json>JSONouiValeurs d'entrée, par ex. '{"input":"hello"}'.
--expected-output <json>JSONnonSortie attendue pour les évaluateurs de style comparaison.
--expected-behavior <text>stringnonDescription du comportement attendu de l’agent pour les évaluateurs de trajectoire.
--evaluation-criterias <json>JSONnonRemplacements des critères par évaluateur.
--simulations <json>Tableau JSONnonDes simulations pour les composants appelés par le processus, par exemple '[{"componentId":"web-search","componentType":"tool"}]'. Chaque objet a besoin de componentId et componentType. Pour la stratégie de simulation LLM (par défaut), la CLI renseigne un outputSchema manquant à partir de l'agent déployé. Reportez-vous à uip eval simulatable-components list pour connaître les composants disponibles.
--tenant <tenant>namenonNom du locataire UiPath.

Le fichier JSON malformé sur --inputs, --expected-output, --evaluation-criterias, ou --simulations échoue rapidement côté client, avec un exemple de la forme attendue dans l'erreur pour --inputs et --simulations. Une simulation sans componentId ou componentType échoue avec l’index de l’entrée non valide.

Exemple​

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

Format des données (--sortie 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"
  }
}

mise à jour de l’évaluation uip eval​

Mettez à jour une évaluation existante. Au moins un champ modifiable est requis au-delà de --process-key/--eval-set-id; les champs omis conservent leur valeur actuelle.

Arguments​

NomRequisObjectif
<evaluationId>ouiID d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--eval-set-id <guid>GUIDouiID de l’ensemble d’évaluation.
--name <name>stringnon*Nouveau nom de l’évaluation.
--inputs <json>JSONnon*Nouvelles valeurs d'entrée.
--expected-output <json>JSONnon*Nouvelle sortie attendue.
--expected-behavior <text>stringnon*Nouvelle description du comportement attendu.
--evaluation-criterias <json>JSONnon*Nouveaux remplacements de critères par évaluateur.
--simulations <json>Tableau JSONnon*Nouvelles simulations remplaçant l’ensemble actuel. Mêmes forme et validation que sur evaluation create.
--tenant <tenant>namenonNom du locataire UiPath.

* Au moins un de --name, --inputs, --expected-output, --expected-behavior, --evaluation-criterias, ou --simulations est requis.

Exemple​

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

Format des données (--sortie 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"
  }
}

suppression d’évaluation d’évaluation d’IU​

Supprimez une évaluation d'un ensemble d'évaluation.

Arguments​

NomRequisObjectif
<evaluationId>ouiID d’évaluation.

Options​

LongValeur (Value)RequisDescription
--process-key <guid>GUIDouiClé du processus.
--eval-set-id <guid>GUIDouiID de l’ensemble d’évaluation.
--tenant <tenant>namenonNom du locataire UiPath.

Exemple​

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

Format des données (--sortie json)​

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

Voir également​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour