Visualização pública

Data de lançamento: 7 de maio de 2026

Visualização pública do UiPath CLI como @uipath/cli no npm, substituindo a ferramenta uipcli.exe .NET legada.

Adicionado

• Host: executável uip com comandos principais login, logout, login status, login tenant list, login tenant set, tools (listar / pesquisar / instalar / atualizar / desinstalar), skills (instalar / atualizar / desinstalar), mcp, completion.
• Ferramentas (lista de permissões de instalação automática; instalada no primeiro uso ou por meio de uip tools install):
  • @uipath/orchestrator-tool — alias or. Trabalhos, pastas, processos, pacotes, máquinas, usuários, funções, licenças, feeds, anexos, sessões, calendários, armazenamentos de credenciais, logs de auditoria, configurações.
  • @uipath/solution-tool — alias solution. Estruturar, empacotar, publicar, carregar, gerenciamento de projetos, implantar ciclo de vida, pacotes.
  • @uipath/resource-tool — alias resource. Ativos, filas, buckets de armazenamento, bibliotecas, gatilhos, webhooks.
  • @uipath/agent-tool — alias agent. Criação de agente completo + implantação + execução + avaliação.
  • @uipath/codedagent-tool — alias codedagent. Faça a ponte para o CLI uipath do Python para Agentes codificados.
  • @uipath/codedapp-tool — alias codedapp. Apps Web codificados.
  • @uipath/maestro-tool — alias maestro. Processos, instâncias, incidentes BPMN do Maestro.
  • @uipath/test-manager-tool — alias tm. Projeto, caso de teste, conjunto de testes, execução, resultado, relatório, anexo, espera.
  • @uipath/integrationservice-tool — alias is. Conectores, conexões, atividades, recursos, gatilhos.
  • @uipath/vertical-solutions-tool — alias vss.
  • @uipath/api-workflow-tool — alias api-workflow.
  • @uipath/data-fabric-tool — alias df.
  • @uipath/insights-tool — alias insights.
  • @uipath/traces-tool — alias traces.
  • @uipath/docsai-tool — alias docsai.
• @uipath/rpa-tool — alias rpa. Empacotamento, analisador e restauração de projetos do Studio. Publicado no registro npm do GitHub (https://npm.pkg.github.com) em vez do registro público npm, pois ele agrupa componentes do Studio suportados por.NET; configure o escopo @uipath para resolver a partir do GitHub antes de executar uip tools install @uipath/rpa-tool — consulte Instalação do UiPath CLI — Instalação a partir do registro npm do GitHub. Pré-requisito de runtime: um runtime.NET na máquina que executa comandos uip rpa . Consulte Alterações interruptivas — Alteração de runtime.
• @uipath/flow-tool — alias flow. Publicado, mas não na lista de permissões de instalação automática na versão atual; instale explicitamente com uip tools install @uipath/flow-tool antes de usar os comandos uip flow . Planejado para inclusão na lista de permissões em uma versão posterior.
• @uipath/rpa-legacy-tool — alias rpa-legacy. wrapper somente do Windows em torno de uipcli.exe para os comandos do Studio ainda não suportados para a ferramenta rpa multiplataforma: debug, validate, find-activities, find-package, type-definition, package. Não está na lista de permissões de instalação automática; instale explicitamente com uip tools install @uipath/rpa-legacy-tool. Consulte uip rpa-legacy.
• Opções globais: --output, --output-filter (JmesPath), --log-level, --log-file.
• Formatos de saída: table, json (padrão), yaml, plain.
• Códigos de saída: contrato de cinco níveis — 0 / 1 / 2 / 3 / 4, mais 130 para cancelamento do usuário.
• Fluxos de autenticação: OAuth2 interativo, credenciais do cliente do aplicativo externo (com resolvedor env.VAR ), autenticação da variável de ambiente (JWT opaco por meio de UIPATH_CLI_ENABLE_ENV_AUTH=true).
• Configuração: variáveis de ambiente (UIPATH_URL, UIPATH_CLI_*, UIPATH_TELEMETRY_DISABLED, etc.) mais sinalizadores por comando, com uma cadeia de precedência documentada (sinalizador > env var > padrão).
• Conclusão de shell: bash, zsh (com conclusão de valor de sinalizador dinâmico quando jq está no PATH), object e pwsh.
• Habilidades: agentes de codificação compatíveis — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, OpenCode.
• Agentes de codificação para solução de problemas (pré-visualização): habilidade de Claude Code (parte do catálogo de habilidades da UiPath) que diagnosticar falhas da plataforma UiPath conversacionalmente a partir do terminal. A Fase 0 abrange problemas de runtime de RPA, Orchestrator e Maestro; outros domínios da UiPath podem ser investigar com a mesma habilidade em profundidade de diagnóstico menor e estão sendo integrados. Instale com uip skills install --agent claude. Consulte Solução de problemas com o UiPath para agentes de codificação.
• Bridge MCP: uip mcp serve expõe uma única ferramenta MCP (run_command) sobre o Studio.

Alterações interruptivas versus uipcli.exe legado

Consulte o guia de migração para obter a lista completa. Destaques:

• Nenhuma leitura de ambiente UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET implícita. Passe-os explicitamente: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET.
• Autenticação básica e autenticação de token removidas no login . Use o OAuth2 interativo ou o aplicativo externo.
• As pastas com versão do calendário desapareceram. A documentação reside em uipath-cli/standalone/latest/ com uma referência ativa; os deltas por versão estão aqui.
• Comandos do pacote de pacotes — uip rpa pack produz um .nupkg por projeto do Studio (igual ao legado uipcli package pack); uip solution pack produz um pacote .zip de toda a Solução (mesmo formato que as ferramentas da Solução sempre usaram). Qual você deseja depende de se você está empacotando um único projeto do Studio ou uma Solução completa.

Problemas conhecidos

• Código de saída de tempo limite deuip tm wait . Emite 2 no tempo limite, reutilizando o slot AuthenticationError . Os scripts que se ramificam em 2 para "reautenticar" devem incluir casos especiais tm wait. 4 (TimeoutError) dedicado está reservado no contrato do código de saída e pode ser adotado em uma versão futura do MINOR.
• uip flow processes list filtra por Tipo de fluxo; uip maestro processes list não. O Maestro retorna resumos de processos em todo o tenant variantes, incluindo outros tipos de ferramentas. Em revisão.
• uip vss add connection está registrado, mas não foi implementado (rastreado como AVRSOL-1569). Retorna um erro claro quando invocado.
• Nenhuma opção de exclusão para a instalação automática da ferramenta. CI=true é respeitada. Pré-instale ferramentas explicitamente em etapas de CI para manter os tempos de compilação determinísticos.
• rpa-tool requer a configuração do registro do GitHub. @uipath/rpa-tool está hospedado no registro npm do GitHub, não no público. Um npm install padrão em uma máquina nova não pode resolvê-lo até que o escopo @uipath seja configurado — consulte Instalação do UiPath CLI. Uma vez configuradas, uip tools install @uipath/rpa-tool e as invocações de instalação automática subsequentes funcionam normalmente.

Telemetria

A telemetria de uso anônimo é habilitada por padrão e enviada para o Application Insights da UiPath. Desativar com UIPATH_TELEMETRY_DISABLED=1 ou redirecionar com UIPATH_AI_CONNECTION_STRING. Nenhum argumento de comando, conteúdo de arquivo ou credencial é transmitido.