Atualização de UIP

Sintaxe e opções para "uip update", que atualiza ferramentas e habilidades instaladas e verifica ou aplica uma versão de CLI mais recente.

uip update atualiza cada ferramenta e habilidade instalada e verifica (e, por padrão, aplica) uma versão mais recente da CLI. É o equivalente de um comando à execução de uip tools update e uma atualização de habilidades juntas, além da própria verificação de autoatualização da CLI.

Resumo

uip update [--dry-run] [--tools-only | --skills-only] [--no-tools] [--no-skills] [--no-cli-check] [--no-self] [--channel <stable|preview>] [--name <tool-name>] [--agent <agent>] [--local | --no-local]

uip update honra as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão, com uma adição abaixo.

Opções

Bandeira	Description
--dry-run	Visualize o que mudaria sem aplicá-lo.
--tools-only	Atualizar ferramentas; pule a seção de habilidades. mutuamente exclusivo com --skills-only e com --no-tools.
--skills-only	Atualizar habilidades; pule a seção de ferramentas. mutuamente exclusivo com --tools-only e com --no-skills.
--no-tools	Não atualize ferramentas.
--no-skills	Não atualize habilidades.
--no-cli-check	Não teste uma versão mais recente da CLI.
--no-self	Investigar uma versão da CLI mais recente e relata-la, mas não a instalar — imprime um aviso com o comando de atualização manual em vez de autoatualização.
--channel <channel>	Substitua o canal de lançamento para esta execução: stable ou preview (consulte configuração do uip updateChannel). Sem esse sinalizador, o canal é resolvido a partir de core.updateChannel/a própria compilação da CLI em execução.
--name <tool-name>	Restringe a atualização das ferramentas a um nome de ferramenta com escopo.
--agent <agent>	Restrinja a atualização de habilidades a um agente de codificação.
--local	Restringa a atualização de habilidades apenas para o escopo local (projeto).
--no-local	Restringa a atualização de habilidades apenas para o escopo global.

--tools-only combinado com --no-tools (ou --skills-only combinado com --no-skills) é uma contradições e falha com ValidationError antes que qualquer coisa seja executada.

Política da versão

Não há sinalizador de versão por invocação — uip update sempre tem como alvo o destino da versão efetiva: seu pino core.version de uip config se um estiver definido, caso contrário, a versão publicada mais recente.

• Nenhum pino — tem como alvo a versão mais recente, cruzando limites MINOR e MAJOR livremente (um uip update explícito é o usuário optando por isso, ao contrário da sincronização de segundo plano diária não assistida, que se limita para evitar um salto MAJOR inesperado).
• major.minor pino (um pino de "linha", por exemplo 1.196) — rastreia o patch mais recente dentro dessa linha.
• major.minor.patch pino (um pino exato, por exemplo 1.196.3) — congela totalmente as atualizações. uip update Success igno seguiruip config set version <major.minor> mais recente uip config clear version novamente).

Exemplos

# Update everything installed, including the CLI itself
uip update

# Update tools and skills but only report on a newer CLI, don't self-update
uip update --no-self

# Preview without applying
uip update --dry-run

# Tools only, on the preview channel
uip update --tools-only --channel preview

Formato dos dados (--output json)

{
  "Code": "UpdateResult",
  "Data": {
    "DryRun": false,
    "Channel": "stable",
    "Cli": {
      "current": "1.4.2",
      "available": "1.4.3",
      "action": "updated",
      "reason": null
    },
    "Tools": [
      { "name": "orchestrator-tool", "status": "updated", "from": "1.4.2", "to": "1.4.3" }
    ],
    "Skills": { "Sections": [] },
    "Errors": [],
    "HasFailures": false
  }
}

Cli.action é um destes updated, notice (uma CLI mais recente existe, mas não foi aplicada — por causa de --no-self, ou porque a atualização automática foi recusada por outro motivo), none (já atual), ou skipped (um pino core.version exato congelava a execução — veja acima). Tools/Skills são null, não uma array vazia, quando essa seção foi ignorada totalmente (--tools-only, --skills-only, --no-tools, --no-skills, ou o curto prazo de pinos congelados).

Uma execução com Cli.action: "notice" também registra o comando de atualização manual para stderr (npm install -g @uipath/cli@<version>, ou um equivalente relatado pela ferramenta).

Códigos de saída

uip update o contrato padrão, com uma adição: uma falha parcial ainda retorna um envelope Success (o Orchestrator não para no primeiro subsistema com falha — ele executa todas as seções e relata cada resultado em Data.Errors), mas o processo ainda sai de um diferente de zero quando Data.HasFailures é true. Verifique HasFailures, não apenas Result, se um script precisar detectar uma falha de atualização parcial.

Relacionado

• uip config — version e updateChannel governam os alvos uip update .
• ferramentas uip — uip tools update é o equivalente apenas em ferramentas com seus próprios sinalizadores dedicados.
• habilidades uip — instalação de habilidades e comportamento de atualização por agente.

Veja também

• Opções globais
• Códigos de saída