新增功能

UiPath CLI 是从头开始重写的命令行工具，用于替换 通过2025.10使用的uipcli.exe .NET 工具。如果您要从 2025.10 管道迁移，请阅读迁移指南— 本页面是更改内容及其原因的标题摘要。

其他工具

UiPath CLI 是在npm上分发的TypeScript CLI ，名称为@uipath/cli ，并作为uip进行调用。它可在 Windows、macOS 和 Linux 上运行 Node.js 18+。主机和大多数工具没有.NET 依赖项； rpa-tool是一个例外，它包含 Studio 打包程序和工作流编译器，而两者仍然需要.NET Runtime。在每个环境中以相同的方式安装主机：

npm install -g @uipath/cli

CLI 是一个插件主机。每个 UiPath 界面（Orchestrator、解决方案、智能体、流、Maestro、Test Manager 等）的命令作为单独的 npm 包提供，这些包uip会在您首次使用时自动安装。请参阅工具（插件） 。

语义版本控制

基于日历的版本控制（ 2023.10 、 2024.10 、 2025.10 ）已不复存在。1.0.0 是语义化版本合同的起点：

• 主要— 首先是具有完整弃用周期的重大更改。
• Minor — 新命令、新标志，仅限叠加。Data形状可以演变。
• PATCH — 仅修复错误。

主机和工具版本坐标：每个工具默认跟踪 CLI 的 MAJOR.MINOR 行。请参阅版本控制和稳定性。

不仅仅是 CI/CD

旧版 CLI 是一个 CI/CD 工具：打包、分析、部署、运行测试。UiPath CLI 1.x 涵盖完整平台（构建、管理、运营、部署），专为开发者以交互方式使用以及管道以编程方式使用而设计。您现在可以：

• 构建并验证项目（ uip solution new 、 uip agent init 、 uip flow init和uip maestro init ）。
• 管理 Orchestrator 资源（文件夹、流程、包、计算机、用户、角色、许可证、队列、资产、存储桶、Webhook）。
• 启动和监控作业（ uip or jobs start 、 uip or jobs get ），使用可选的--wait-for-completion 。
• 推动包括评估在内的整个智能体生命周期 ( uip agent eval )。
• 检查流和 Maestro 实例和事件。
• 管理 Data Fabric 实体和 Integration Service 连接。

每个命令都返回相同的结构化 JSON 信封，因此您可以手动执行的任何操作都可以编写脚本。

默认为 JSON

默认情况下，标准输出上为 JSON 输出，并具有稳定的信封（ Result 、 Code 、 Data 、 Message 、 Instructions ）。人类通过--output table选择加入表格视图；管道和 AI 智能体无需额外标记即可获取干净的结构化数据。请参阅输出格式。

人性化交互式登录

uip login将打开浏览器，为您登录 UiPath，并将刷新的会话保留在~/.uipath/中。不再需要将客户端凭据嵌入到开发者工作站上。CI 管道仍使用外部应用程序客户端凭据（现在通过--client-id env.UIPATH_CLIENT_ID传递），并且容器可以通过不透明的访问令牌使用环境变量身份验证。请参阅身份验证。

专为 AI 编码智能体构建

uip skills系统会训练 Claude Code、Cursor、GitHub Copilot、Gemini CLI、Codex 和 OpenCode 如何使用uip 。技能由 UiPath 发布，并根据智能体安装。安装后，智能体可以驱动完整的“打包-发布-部署”流程，而无需您键入每个命令。请参阅将 UiPath CLI 与 Coding Agents 一起使用。

Shell 补全

uip completion为 bash、zsh、false 和 PowerShell 安装 Tab 键补全。当jq位于路径中时，动态标志值补全（例如uip or packages upload --package-name <TAB> ）可在 zsh 上使用；静态子命令和选项名称补全适用于所有四种 shell。

其他有意义的转变

• 不会读取隐式 env-var 身份验证操作。系统不再自动读取UIPATH_CLIENT_ID和UIPATH_CLIENT_SECRET 。通过--client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET传递（ env.前缀在运行时查找变量，而不在命令行中公开）。
• 退出代码已收紧为五个值（0/1/2/3/4，加上 130 用于用户取消）。合同在主要版本中稳定——脚本针对他们。请参阅退出代码。
• 在解析时，对每个命令进行JMESPath 筛选( --output-filter )，出现语法错误时退出代码3这样即使输入错误也不会浪费 API 调用。
• 跨平台。支持 ARM64 Windows、macOS 和 Linux — 反映了 Node.js 运行时。
• 遥测选择退出变量从UIPATH_EXTENSIONS_CLI_TELEMETRY_ENABLED=False重命名为UIPATH_TELEMETRY_DISABLED=1 。默认情况下，两代都是选择退出的——更新依赖旧名称的 CI 运行器。

从哪里开始

• 新用户?快速入门。
• 是否要从 2025.10 版本迁移？迁移指南。
• 正在设置 CI？您的第一个管道→ 选择CI/CD 模式。
• 使用 AI 智能体？结合使用 UiPath CLI 和 Coding Agents 。

有关完整更改列表以及之后发布的任何内容，请参阅发行说明。