uip eval eval-set & Evaluación

Sintaxis y opciones para gestionar los conjuntos de evaluación de Orchestrator y las evaluaciones (puntos de datos) dentro de ellos con `uip eval eval-set` y `uip eval evaluation`.

Parte del subsistema uip eval . Esta página cubre los dos recursos que definen lo que se evalúa:

• eval eval-set : una colección de puntos de datos de evaluación con nombre y ámbito de proceso, vinculada a uno o más evaluadores a través de --evaluator-refs. Un conjunto de evaluación también incluye la configuración de procesamiento por lotes/tiempo de espera utilizado cuando se ejecuta.
• eval evaluation punto de datos dentro de un conjunto de evaluación: una carga útil de entrada, una salida/comportamiento esperado opcional y anulaciones de criterios opcionales por evaluador. Las ejecuciones execute-and-evaluate y schedule funcionan a través de las evaluaciones de un conjunto de evaluación, puntuando cada una con los evaluadores vinculados del conjunto de evaluación.

Sinopsis

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 lista de conjuntos de evaluación

Enumerar conjuntos de evaluación definidos para un proceso.

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso. Usa uip or processes list para encontrar uno.
--limit <n>	Entero	No	Máximo de elementos a devolver. Predeterminado 100.
--offset <n>	Entero	No	Elementos a omitir. Predeterminado 0.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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 es "-" cuando no está configurado. UpdatedAt está presente solo una vez que el conjunto de evaluación se ha actualizado al menos una vez.

uip eval-eval-set get

Obtenga los detalles de un conjunto de evaluación.

Argumentos

Nombre	Obligatorio	Propósito
<evalSetId>	Sí	ID del conjunto de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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 eval eval-set create

Crea un conjunto de evaluación para un proceso.

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--workload-id <guid>	GUID	Sí	ID de carga de trabajo.
--folder-key <guid>	GUID	Sí	Clave de carpeta.
--name <name>	String	Sí	Nombre del conjunto de evaluación.
--description <text>	String	No	Descripción del conjunto de evaluación.
--batch-size <n>	entero ≥ 1	No	Máximo de evaluaciones simultáneas por ejecución.
--timeout-minutes <n>	entero ≥ 1	No	Tiempo de espera en minutos por evaluación.
--evaluator-refs <refs...>	ID separados por espacios	No	ID de evaluador para vincular a este conjunto de evaluación. Variádico: pasa varios ID separados por espacios, no por comas.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Se genera automáticamente un externalId interno (un UUID aleatorio) en cada creación; no es configurable por el usuario.

Ejemplo

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

Forma de datos (--json de salida)

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

actualización del conjunto de evaluaciones de uip eval

Actualizar un conjunto de evaluación existente. Se requiere al menos un campo actualizable más allá de --process-key; los campos que omites mantienen su valor actual (el comando lee primero el conjunto de evaluación existente y luego aplica tus cambios en la parte superior).

Argumentos

Nombre	Obligatorio	Propósito
<evalSetId>	Sí	ID del conjunto de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--name <name>	String	No*	Nuevo nombre del conjunto de evaluación.
--description <text>	String	No*	Nueva descripción.
--batch-size <n>	entero ≥ 1	No*	Nuevo número máximo de evaluaciones simultáneas.
--timeout-minutes <n>	entero ≥ 1	No*	Nuevo tiempo de espera en minutos.
--evaluator-refs <refs...>	ID separados por espacios	No*	Reemplaza la lista completa de referencias de evaluador (no aditiva).
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

* Se requiere al menos uno de --name, --description, --batch-size, --timeout-minutes o --evaluator-refs: el comando falla rápidamente si no se pasa ninguno.

Ejemplo

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

Forma de datos (--json de salida)

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

eliminación de conjunto de evaluación de evaluación de UIP

Eliminar un conjunto de evaluación.

Argumentos

Nombre	Obligatorio	Propósito
<evalSetId>	Sí	ID del conjunto de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

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

Eliminar un conjunto de evaluación no elimina en cascada ni advierte sobre programaciones o evaluadores que hacen referencia a él: la CLI emite un DELETE simple sin comprobación de dependencias.

lista de evaluación de uip eval

Enumera las evaluaciones (puntos de datos) dentro de un conjunto de evaluación.

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--eval-set-id <guid>	GUID	Sí	ID del conjunto de evaluación.
--limit <n>	Entero	No	Máximo de elementos a devolver. Predeterminado 100.
--offset <n>	Entero	No	Elementos a omitir. Predeterminado 0.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

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

obtención de evaluación de uip eval

Obtener los detalles de una evaluación.

Argumentos

Nombre	Obligatorio	Propósito
<evaluationId>	Sí	ID de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--eval-set-id <guid>	GUID	Sí	ID del conjunto de evaluación.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

La misma forma de objeto que una entrada en la matriz Data de evaluation list.

creación de evaluación de uip eval

Añade una evaluación (punto de datos) a un conjunto de evaluación.

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--eval-set-id <guid>	GUID	Sí	ID del conjunto de evaluación.
--folder-key <guid>	GUID	Sí	Clave de carpeta.
--name <name>	String	Sí	Nombre de la evaluación.
--inputs <json>	JSON	Sí	Valores de entrada, por ejemplo '{"input":"hello"}'.
--expected-output <json>	JSON	No	Salida esperada para los evaluadores de estilo de comparación.
--expected-behavior <text>	String	No	Descripción del comportamiento esperado del agente, para evaluadores de trayectoria.
--evaluation-criterias <json>	JSON	No	Anulaciones de criterios por evaluador.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Un JSON mal formado en --inputs, --expected-output o --evaluation-criterias falla rápidamente en el lado del cliente antes de cualquier llamada de red, con un ejemplo de la forma esperada en el error para --inputs.

Ejemplo

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

Forma de datos (--json de salida)

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

actualización de la evaluación de uip eval

Actualizar una evaluación existente. Se requiere al menos un campo actualizable más allá de --process-key/--eval-set-id; los campos omitidos mantienen su valor actual.

Argumentos

Nombre	Obligatorio	Propósito
<evaluationId>	Sí	ID de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--eval-set-id <guid>	GUID	Sí	ID del conjunto de evaluación.
--name <name>	String	No*	Nuevo nombre de evaluación.
--inputs <json>	JSON	No*	Nuevos valores de entrada.
--expected-output <json>	JSON	No*	Nueva salida esperada.
--expected-behavior <text>	String	No*	Nueva descripción del comportamiento esperado.
--evaluation-criterias <json>	JSON	No*	Nuevas anulaciones de criterios por evaluador.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

* Se requiere al menos uno de --name, --inputs, --expected-output, --expected-behavior o --evaluation-criterias.

Ejemplo

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

Forma de datos (--json de salida)

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

eliminación de evaluación de uip eval

Eliminar una evaluación de un conjunto de evaluaciones.

Argumentos

Nombre	Obligatorio	Propósito
<evaluationId>	Sí	ID de evaluación (GUID).

Opciones

Largo	Valor	Obligatorio	Descripción
--process-key <guid>	GUID	Sí	Clave de proceso.
--eval-set-id <guid>	GUID	Sí	ID del conjunto de evaluación.
--tenant <tenant>	name	No	Nombre del tenant de UiPath.

Ejemplo

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

Forma de datos (--json de salida)

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

Relacionado

• uip eval — descripción general, execute-and-evaluate y run.
• programación de evaluación de uip : ejecuciones de evaluación recurrentes en un conjunto de evaluación.
• evaluador de evaluación de uip : la lógica de puntuación a la que apunta --evaluator-refs de un conjunto de evaluación.
• uip or processes — resuelve un --process-key.

Ver también

• Descripción general de la herramienta Orchestrator
• Opciones globales
• Códigos de salida