eval eval-set uiip; Avaliação

Sintaxe e opções para gerenciar conjuntos de avaliação do Orchestrator e as avaliações (pontos de dados) dentro deles com "uip eval eval-set" e "uip eval evaluation".

Parte do subsistema uip eval . Esta página abrange os dois recursos que definem o que é avaliado:

• eval eval-set — uma coleção nomeada e com escopo de processo de pontos de dados de avaliação, vinculada a um ou mais avaliadores por meio de --evaluator-refs. Um conjunto de avaliação também carrega configurações de lote/tempo limite usadas quando ele é executado.
• eval evaluation um ponto de dados dentro de um conjunto de avaliação: uma carga de entrada, uma saída/comportamento opcional esperado e substituições de critérios por avaliador opcionais. execute-and-evaluate e schedule executa o trabalho por meio das avaliações de um conjunto de avaliação, marcando cada uma com os avaliadores vinculados do conjunto de avaliação.

Resumo

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

eval uip eval-set list

Listar conjuntos de avaliação definidos para um processo.

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo. Use uip or processes list para encontrar um.
--limit <n>	Número inteiro	não	Máximo de itens a serem retornados. 100Padrão.
--offset <n>	Número inteiro	não	Itens a ignorar. 0Padrão.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--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 é "-" quando não está definido. UpdatedAt está presente apenas quando o conjunto de avaliação foi atualizado pelo menos uma vez.

eval uip eval-set obter

Obtenha os detalhes de um conjunto de avaliação.

Argumentos

Name	Required	Finalidade
<evalSetId>	sim	ID do conjunto de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--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"
  }
}

eval eval-set criar da uip

Crie um conjunto de avaliação para um processo.

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--workload-id <guid>	GUID	sim	ID da carga de trabalho.
--folder-key <guid>	GUID	sim	Chave da pasta.
--name <name>	String	sim	Nome do conjunto de avaliação.
--description <text>	String	não	Descrição do conjunto de avaliação.
--batch-size <n>	número inteiro ≥ a 1	não	Máximo de avaliações simultâneas por execução.
--timeout-minutes <n>	número inteiro ≥ a 1	não	Tempo limite em minutos por avaliação.
--evaluator-refs <refs...>	IDs separados por espaço	não	IDs do avaliador a serem vinculados a este conjunto de avaliação. Variável — passe vários IDs separados por espaços, não por vírgulas.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Um externalId interno (um UUID aleatório) é gerado automaticamente em cada criação — ele não é configurável pelo usuário.

Exemplo

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

Formato dos dados (--output json)

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

atualização do eval-set da uip

Atualize um conjunto de avaliação existente. É necessário pelo menos um campo atualizável além de --process-key; os campos que você omite mantêm seu valor atual (o comando lê o conjunto de avaliação existente primeiro e, em seguida, aplica suas alterações na parte superior).

Argumentos

Name	Required	Finalidade
<evalSetId>	sim	ID do conjunto de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--name <name>	String	não*	Novo nome do conjunto de avaliação.
--description <text>	String	não*	Nova descrição.
--batch-size <n>	número inteiro ≥ a 1	não*	Novas avaliações simultâneas máximas.
--timeout-minutes <n>	número inteiro ≥ a 1	não*	Novo tempo limite em minutos.
--evaluator-refs <refs...>	IDs separados por espaço	não*	Substitui a lista completa de referências do avaliador (não cumulativa).
--tenant <tenant>	name	não	Nome do tenant da UiPath.

* Pelo menos um dos --name, --description, --batch-size, --timeout-minutes ou --evaluator-refs é necessário — o comando falha rapidamente se nenhum for aprovado.

Exemplo

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

Formato dos dados (--output json)

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

exclusão da avaliação-definir a avaliação do uip

Excluir um conjunto de avaliação.

Argumentos

Name	Required	Finalidade
<evalSetId>	sim	ID do conjunto de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--output json)

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

Excluir um conjunto de avaliação não exclui em cascata ou adverte sobre agendamentos ou avaliadores que fazem referência a ele — a CLI emite um DELETE simples sem verificação de dependência.

lista de avaliação uiip eval

Liste as avaliações (pontos de dados) dentro de um conjunto de avaliação.

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--eval-set-id <guid>	GUID	sim	ID do conjunto de avaliação.
--limit <n>	Número inteiro	não	Máximo de itens a serem retornados. 100Padrão.
--offset <n>	Número inteiro	não	Itens a ignorar. 0Padrão.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--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 }
}

avaliação da uip obter

Obtenha os detalhes de uma avaliação.

Argumentos

Name	Required	Finalidade
<evaluationId>	sim	ID de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--eval-set-id <guid>	GUID	sim	ID do conjunto de avaliação.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--output json)

Mesmo formato de objeto que uma entrada na matriz Data do evaluation list.

criação de avaliação de avaliação da uip

Adicione uma avaliação (ponto de dados) a um conjunto de avaliação.

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--eval-set-id <guid>	GUID	sim	ID do conjunto de avaliação.
--folder-key <guid>	GUID	sim	Chave da pasta.
--name <name>	String	sim	Nome da avaliação.
--inputs <json>	JSON	sim	Valores de entrada, por exemplo '{"input":"hello"}').
--expected-output <json>	JSON	não	Saída esperada para avaliadores com estilo de comparação.
--expected-behavior <text>	String	não	Descrição do comportamento esperado do agente para avaliadores de trajetória.
--evaluation-criterias <json>	JSON	não	Substituições de critérios por avaliador.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

JSON malformado em --inputs, --expected-output ou --evaluation-criterias falha no lado do cliente antes de qualquer chamada de rede, com um exemplo da forma esperada no erro para --inputs.

Exemplo

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

Formato dos dados (--output json)

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

atualização da avaliação uip eval

Atualizar uma avaliação existente. É necessário pelo menos um campo atualizável além de --process-key/--eval-set-id; os campos omitidos mantêm seu valor atual.

Argumentos

Name	Required	Finalidade
<evaluationId>	sim	ID de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--eval-set-id <guid>	GUID	sim	ID do conjunto de avaliação.
--name <name>	String	não*	Novo nome da avaliação.
--inputs <json>	JSON	não*	Novos valores de entrada.
--expected-output <json>	JSON	não*	Nova saída esperada.
--expected-behavior <text>	String	não*	Nova descrição do comportamento esperado.
--evaluation-criterias <json>	JSON	não*	Novas substituições de critérios por avaliador.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

* Pelo menos --name, --inputs, --expected-output, --expected-behavior ou --evaluation-criterias é necessário.

Exemplo

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

Formato dos dados (--output json)

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

exclusão da avaliação da avaliação do uip

Remova uma avaliação de um conjunto de avaliação.

Argumentos

Name	Required	Finalidade
<evaluationId>	sim	ID de avaliação (GUID).

Opções

Long	Valor	Required	Description
--process-key <guid>	GUID	sim	Chave do processo.
--eval-set-id <guid>	GUID	sim	ID do conjunto de avaliação.
--tenant <tenant>	name	não	Nome do tenant da UiPath.

Exemplo

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

Formato dos dados (--output json)

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

Relacionado

• avaliação do uiip — visão geral, execute-and-evaluate e run.
• Agendamento de avaliação uip — execuções de avaliação recorrentes em um conjunto de avaliação.
• Avaliador de avaliação uip — a lógica de pontuação para a qual um conjunto de avaliação --evaluator-refs aponta.
• uip or processes — resolva um --process-key.

Veja também

• Visão geral da ferramenta do Orchestrator
• Opções globais
• Códigos de saída