Vista preliminar pública

Fecha de lanzamiento: 7 de mayo de 2026

Vista previa pública de UiPath CLI como @uipath/cli en npm, reemplazando la herramienta uipcli.exe .NET heredada.

Agregado

• Host: ejecutable uip con los comandos básicos login, logout, login status, login tenant list, login tenant set, tools (listar/buscar/instalar/actualizar/desinstalar), skills (instalar/ actualizar/desinstalar), mcp, completion.
• Herramientas (lista blanca de instalación automática; instalada en el primer uso o a través de uip tools install):
  • @uipath/orchestrator-tool : alias or. Trabajos, carpetas, procesos, paquetes, máquinas, usuarios, roles, licencias, fuentes, archivos adjuntos, sesiones, calendarios, almacenes de credenciales, registros de auditoría, configuraciones.
  • @uipath/solution-tool : alias solution. Andamio, paquete, publicación, carga, gestión de proyectos, implementación del ciclo de vida, paquetes.
  • @uipath/resource-tool : alias resource. Activos, colas, depósitos de almacenamiento, bibliotecas, desencadenadores, webhooks.
  • @uipath/agent-tool : alias agent. Creación completa del agente + implementación + ejecución + evaluación.
  • @uipath/codedagent-tool : alias codedagent. Puente a la CLI uipath de Python para agentes codificados.
  • @uipath/codedapp-tool : alias codedapp. Aplicaciones web codificadas.
  • @uipath/maestro-tool : alias maestro. Procesos, instancias e incidentes de Maestro BPMN.
  • @uipath/test-manager-tool : alias tm. Proyecto, caso de prueba, conjunto de pruebas, ejecución, resultado, informe, archivo adjunto, espera.
  • @uipath/integrationservice-tool : alias is. Conectores, conexiones, actividades, recursos, desencadenadores.
  • @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. Empaquetado, analizador y restauración de proyectos de Studio. Publicado en el registro npm de GitHub (https://npm.pkg.github.com) en lugar del registro npm público porque incluye componentes de Studio respaldados por .NET; configura el ámbito @uipath para que se resuelva desde GitHub antes de ejecutar uip tools install @uipath/rpa-tool — consulta Instalar UiPath CLI — Instalar desde el registro npm de GitHub. Requisito previo de runtime: un runtime.NET en la máquina que ejecuta comandos uip rpa . Consulta Romper cambios: cambio de runtime.
• @uipath/flow-tool : alias flow. Publicado pero no en la lista blanca de instalación automática en la versión actual; instálalo explícitamente con uip tools install @uipath/flow-tool antes de usar los comandos uip flow . Planificado para su inclusión en la lista blanca en una versión posterior.
• @uipath/rpa-legacy-tool : alias rpa-legacy. Envoltura solo para Windows de uipcli.exe para los comandos de Studio que aún no se han migrado a la herramienta multiplataforma rpa : debug, validate, find-activities, find-package, type-definition, package. No está en la lista blanca de instalación automática; instalar explícitamente con uip tools install @uipath/rpa-legacy-tool. Consulta uip rpa-legacy.
• Opciones globales: --output, --output-filter (JMESPath), --log-level, --log-file.
• Formatos de salida: table, json (predeterminado), yaml, plain.
• Códigos de salida: contrato de cinco niveles: 0 / 1 / 2 / 3 / 4, más 130 para la cancelación del usuario.
• Flujos de autenticación: OAuth2 interactivo, credenciales de cliente de aplicación externa (con resolución de env.VAR ), autenticación de variable de entorno (JWT opaco a través de UIPATH_CLI_ENABLE_ENV_AUTH=true).
• Configuración: variables de entorno (UIPATH_URL, UIPATH_CLI_*, UIPATH_TELEMETRY_DISABLED, etc.) más marcadores por comando, con una cadena de precedencia documentada (bandera > var env > predeterminada).
• Finalización de shell: bash, zsh (con finalización dinámica de valor de marcador cuando jq está en PATH), pescado y pwsh.
• Habilidades: agentes de codificación compatibles: Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, OpenCode.
• Agentes de codificación para la solución de problemas (vista previa): habilidad Claude Code (parte del catálogo de habilidades de UiPath) que diagnostica los fallos de la plataforma UiPath de forma conversacional desde el terminal. la fase 0 cubre problemas de runtime de RPA, Orchestrator y Maestro; otros dominios de UiPath pueden investigarse con la misma habilidad con una profundidad de diagnóstico más baja y se están incorporando. Instalar con uip skills install --agent claude. Consulta Resolución de problemas con UiPath para agentes de codificación.
• Puente MCP: uip mcp serve expone una sola herramienta MCP (run_command) sobre stdio.

Cambios de última hora frente a uipcli.exe heredado

Consulta la guía de migración para ver la lista completa. Aspectos destacados:

• Sin lectura implícita UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET env. Pásalas explícitamente: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET.
• Se han eliminado la autenticación básica y la autenticación de token en la ruta login . Utilice OAuth2 interactivo o aplicación externa.
• Las carpetas con versión de calendario han desaparecido. La documentación reside en uipath-cli/standalone/latest/ con una referencia activa; los deltas por versión están aquí.
• Comandos de paquete — uip rpa pack produce un .nupkg por proyecto de Studio (lo mismo que el uipcli package pack heredado); uip solution pack produce un paquete .zip de toda la solución (el mismo formato que siempre ha utilizado la herramienta de la solución). Cuál quieres depende de si estás empaquetando un único proyecto de Studio o una solución completa.

Problemas conocidos

• uip tm wait código de salida de tiempo de espera. Emite 2 en el tiempo de espera, reutilizando la ranura AuthenticationError . Los scripts que se ramifican en 2 para "volver a autenticar" deben tm wait en mayúsculas y minúsculas. 4 dedicado (TimeoutError) está reservado en el contrato de código de salida y puede adoptarse en una versión MENOR futura.
• uip flow processes list filtra por tipo de flujo; uip maestro processes list no. La variante de Maestro devuelve resúmenes de procesos de todo el tenant, incluidos otros tipos de herramientas. En revisión.
• uip vss add connection está registrado pero no implementado (seguido como AGVSOL-1569). Devuelve un error claro cuando se invoca.
• Sin deshabilitación para la instalación automática de la herramienta. CI=true no se respeta. Preinstala herramientas explícitamente en pasos de CI para mantener los tiempos de construcción deterministas.
• rpa-tool requiere la configuración del registro de GitHub. @uipath/rpa-tool está alojado en el registro npm de GitHub, no en el público. Un npm install predeterminado en una máquina nueva no puede resolverlo hasta que se configure el ámbito @uipath — consulta Instalar UiPath CLI. Una vez configurado, uip tools install @uipath/rpa-tool y las posteriores invocaciones de instalación automática funcionan normalmente.

Telemetría

La telemetría de uso anónimo está habilitada de forma predeterminada y se envía a Application Insights de UiPath. Inhabilite con UIPATH_TELEMETRY_DISABLED=1 o redirija con UIPATH_AI_CONNECTION_STRING. No se transmiten argumentos de comando, contenidos de archivo o credenciales.