公开预览

发布日期：2026 年 5 月 7 日

UiPath CLI 的公开预览版，在 npm 上作为@uipath/cli ，替换旧版uipcli.exe .NET 工具。

已添加

• 主机： uip使用核心命令的可执行文件login 、 logout 、 login status 、 login tenant list 、 login tenant set 、 tools （列表/搜索/安装/更新/卸载）、 skills （安装/卸载）更新/卸载）、 mcp 、 completion 。
• 工具（自动安装白名单；在首次使用时或通过uip tools install安装）：
  • @uipath/orchestrator-tool — 别名or 。作业、文件夹、流程、包、计算机、用户、角色、许可证、订阅源、附件、会话、日历、凭据存储、审核日志、设置。
  • @uipath/solution-tool — 别名solution 。框架，打包，发布，上传，项目管理，部署生命周期，包。
  • @uipath/resource-tool — 别名resource 。资产、队列、存储桶、库、触发器、Webhook。
  • @uipath/agent-tool — 别名agent 。完整的智能体创作 + 部署 + 运行 + 评估。
  • @uipath/codedagent-tool — 别名codedagent 。连接到用于编码智能体的 Python uipath CLI。
  • @uipath/codedapp-tool — 别名codedapp 。编码网页应用程序。
  • @uipath/maestro-tool — 别名maestro 。Maestro BPMN 流程、实例、故障。
  • @uipath/test-manager-tool — 别名tm 。项目、测试用例、测试集、执行、结果、报告、附件等。
  • @uipath/integrationservice-tool — 别名is 。连接器、连接、活动、资源、触发器。
  • @uipath/vertical-solutions-tool — 别名vss 。
  • @uipath/api-workflow-tool — 别名api-workflow 。
  • @uipath/data-fabric-tool — 别名df 。
  • @uipath/insights-tool — 别名insights 。
  • @uipath/traces-tool — 别名traces 。
  • @uipath/docsai-tool — 别名docsai 。
• @uipath/rpa-tool — 别名rpa 。Studio 项目打包、分析器和还原。发布在GitHub npm 注册表( https://npm.pkg.github.com ) 上，而不是公共 npm 注册表上，因为它捆绑了.NET 支持的 Studio 组件；将@uipath作用域配置为在运行uip tools install @uipath/rpa-tool之前从 GitHub 解析 — 请参阅安装 UiPath CLI — 从 GitHub npm 注册表安装。Runtime 前提条件：计算机上有.NET Runtime 且运行uip rpa命令的计算机。请参阅重大变更 — Runtime 变更。
• @uipath/flow-tool — 别名flow 。已发布，但不在当前版本的自动安装白名单中；在使用uip flow命令之前，先通过uip tools install @uipath/flow-tool显式安装。计划在更高版本中包含白名单。
• @uipath/rpa-legacy-tool — 别名rpa-legacy 。用于尚未移植到跨平台rpa的 Studio 命令的uipcli.exe的仅限 Windows 包装器： debug 、 validate 、 find-activities 、 find-package 、 type-definition 、 package 。不在自动安装白名单中；使用uip tools install @uipath/rpa-legacy-tool显式安装。请参阅uip rpa 旧版。
• 全局选项： --output 、 --output-filter (JMESPath)、 --log-level和--log-file 。
• 输出格式： table 、 json （默认）、 yaml 、 plain 。
• 退出代码：五级合同 — 0 / 1 / 2 / 3 / 4 ，外加130 （表示用户取消）。
• 身份验证流程：交互式 OAuth2、外部应用程序客户端凭据（使用env.VAR解析程序）、环境变量身份验证（通过UIPATH_CLI_ENABLE_ENV_AUTH=true进行不透明 JWT）。
• 配置：环境变量（ UIPATH_URL 、 UIPATH_CLI_* 、 UIPATH_TELEMETRY_DISABLED等）加上每个命令的标志，并记录优先级链（标志 > env var > 默认值）。
• Shell 补全： bash、zsh（当jq位于路径中时，具有动态标志值补全）、fry 和 pwsh。
• 技能：支持的编码智能体 — Claude Code、Cursor、GitHub Copilot、Gemini CLI、Codex、OpenCode。
• 用于故障排除的编码智能体（预览版）： Claude Code 技能（属于 UiPath 技能目录），可从终端以对话方式诊断 UiPath 平台故障。阶段 0 涵盖 RPA、Orchestrator 和 Maestro runtime 问题；其他 UiPath 域可以使用相同的技能在较低的诊断深度上进行调查，并且正在上线。使用uip skills install --agent claude安装。请参阅使用 UiPath for Coding Agents 进行故障排除。
• MCP 网桥： uip mcp serve通过 Studio 公开单个 MCP 工具 ( run_command )。

重大变更与旧版 uiipcli.exe

有关完整列表，请参阅迁移指南。亮点：

• 无法隐式读取UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET环境变量。显式传递： uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET 。
• 已在login路径上删除基本身份验证和令牌身份验证。使用交互式 OAuth2 或外部应用程序。
• 日历版本控制的文件夹已不复存在。文档生命周期位于uipath-cli/standalone/latest/ ，具有实时引用；有关每个版本的增量，请参阅此处。
• 包包命令— uip rpa pack会为每个 Studio 项目生成一个.nupkg （与旧版uipcli package pack相同）； uip solution pack会生成整个解决方案的.zip捆绑包（与解决方案工具始终使用的格式相同）。想要打包哪个取决于您是要打包单个 Studio 项目还是完整的解决方案。

已知问题

• uip tm wait超时退出代码。超时时发出2 ，重用AuthenticationError插槽。在2上分支以进行“重新身份验证”的脚本应当为特殊大小写的tm wait 。专用4 (TimeoutError) 在退出代码合同中保留，可能会在未来的 MINOR 版本中采用。
• uip flow processes list按 工作流类型 进行筛选； uip maestro processes list不会。Maestro 变体返回租户范围内的流程摘要，包括其他工具类型。正在审核。
• uip vss add connection已注册，但未实施（追踪为 AGVSOL-1569）。调用时返回明确的错误。
• 无法选择退出工具自动安装。CI=true不受约束。在 CI 步骤中显式预安装工具，以保持构建时间的确定。
• rpa-tool需要设置 GitHub 注册表。@uipath/rpa-tool托管在 GitHub npm 注册表上，而不是公共注册表上。在配置@uipath作用域之前，新计算机上的默认npm install无法解析 — 请参阅安装 UiPath CLI 。配置后， uip tools install @uipath/rpa-tool和后续自动安装调用即可正常工作。

遥测

匿名使用情况遥测默认处于启用状态，并发送到 UiPath 的 Application Insights。使用UIPATH_TELEMETRY_DISABLED=1选择退出，或使用UIPATH_AI_CONNECTION_STRING进行重定向。不会传输任何命令参数、文件内容或凭据。