管理工具和技能

使用内置命令“uip tools”和“uip skills”安装、更新和移除 UiPath CLI 工具和技能。

工具和技能是核心uip主机旁边的两个扩展程序系统。工具添加与 UiPath 服务通信的命令；技能教 AI 编码智能体如何驱动这些命令。两者都是通过 CLI 本身安装、更新和删除的。本页面涵盖日常工作流，而非概念性拆分（请参阅工具（插件）和技能），非完整命令参考（请参阅uip 工具和uip 技能）。

工具 — 日常

查看已安装的内容

uip tools list --output table

返回Name 、 Version 、 CommandPrefix的表格。使用此方法来发现开发者笔记本电脑和构建服务器之间的偏差。

要捕获快照，您可以稍后进行比较：

uip tools list --output json --output-filter "Data[*].{Name: Name, Version: Version}" > tools.json

安装工具

提供三种标识符形式 — 选择结合上下文最好读的标识符形式：

uip tools install or                                # alias (shortest)
uip tools install orchestrator-tool                 # short name
uip tools install @uipath/orchestrator-tool         # full npm name

显式版本（用于 CI 可重现性）：

uip tools install orchestrator-tool@1.0.2

预览频道 — 切换更新频道，然后正常安装（uip tools install <name>@beta 失败：@ 之后的版本必须是有效的语义版本字符串，而不是频道名称）：

uip config set updateChannel preview
uip tools install maestro-tool

# or pin an exact prerelease version directly, without changing the channel:
uip tools install maestro-tool@1.0.0-preview.1

请参阅完整频道/距离标签模型的版本控制和稳定性。

在 CI 中，始终将安装所需的工具作为专用步骤——自动安装根据先运行的命令支付一次性下载费用。设置UIPATH_CLI_DISABLE_AUTOINSTALL=true以选择硬退出，或仅预安装（详情）：

uip tools install @uipath/orchestrator-tool \
                  @uipath/solution-tool \
                  @uipath/test-manager-tool

CLI 提升后升级工具

升级@uipath/cli时，已安装的工具将保持其先前版本。运行uip tools update ，在 CLI 的新 MAJOR.MINOR 行中将其更新到最新版本：

npm install -g @uipath/cli@1.1.0
uip tools update

更新单个工具：

uip tools update --name orchestrator-tool

Data中的UpdateResult为您提供每个工具的from → to差异 — 对于审核日志非常有用。

备注：

uip tools update 仅适用于 --name <scoped-tool-name> — 没有用于通过 --version 固定确切版本的 update 标志。要固定确切的版本，请显式重新安装它： uip tools install orchestrator-tool@1.0.3 （请参阅uip 工具）。

提示：

升级后刷新 shell 补全

shell 补全脚本是uip completion上次运行时已知动词和标志的静态快照。在npm install -g @uipath/cli@<new> 、 uip tools install或uip tools update后，重新运行uip completion ，以便新添加的命令和标志在<TAB>中显示。请参阅UIP 补全 — 静态快照。

删除工具

uip tools uninstall or

卸载后，下一次uip or …调用将再次触发自动安装，除非阻止自动安装（离线运行器、固定白名单）。要在无状态运行器上保持工具消失，请仅预安装所需的工具，而不要调用已卸载的工具。

环境之间的审核偏差

在每个环境中，捕获已安装的集：

uip tools list --output json --output-filter "Data[*].{Name: Name, Version: Version}" | jq -S . > tools.$(hostname).json

区分不同环境中的文件。任何增量都是“可在我的计算机上运行”的来源 — 通过在 CI 中固定来解决。

技能 — 日常

查看已安装的内容

ls ~/.uipath/.skills         # the on-disk skill catalog cache
cat ~/.uipath/.skills/manifest.json   # manifest of installed skills per agent

对于本地安装，存储位于项目根目录下./.uipath/.skills/ 。或者，也可以要求智能体列出其已安装的技能——每个受支持的智能体都通过自己的用户界面/命令公开此技能。

将技能安装到编码智能体中

按代理划分：

uip skills install --agent claude        # Claude Code (global only)
uip skills install --agent cursor        # Cursor
uip skills install --agent copilot       # GitHub Copilot
uip skills install --agent codex         # Codex
uip skills install --agent opencode      # OpenCode
uip skills install --agent autopilot     # UiPath Autopilot
uip skills install --agent kiro          # Kiro (Amazon Q)
uip skills install --agent windsurf      # Windsurf
uip skills install --agent antigravity   # Antigravity CLI
uip skills install --agent devin         # Devin

交互式（通过复选框多选）：

uip skills install

范围：

• 默认为全局— 安装到智能体的用户配置文件中。在智能体运行的所有位置可用。
• --local会安装到当前目录中。适合项目固定技能或您不想打乱用户配置文件的情况。Claude Code仅适用于全局— 传递--local时会出现--agent claude错误。

随时更新技能

uip skills update将重新获取 UiPath 技能目录并重新安装：

uip skills update --agent claude

更新还会删除自上次安装后从远程目录中消失的技能——智能体与 UiPath 已发布的技能集保持一致。

删除技能

uip skills uninstall --agent claude

不会移除智能体本身，也不影响其他智能体的技能。每个要删除技能的智能体运行一次。

在项目中结合使用工具和技能

将 AI 编码智能体用于 UiPath 工作的存储库的常见模式：

1. 在项目文档中固定@uipath/cli （而非package.json — CLI 是运算符计算机上的开发依赖项，而不是项目 Runtime 依赖项）。
2. 在自述文件中记录项目针对的外部应用程序和租户。每位参与者在其计算机上设置相应的环境变量，并使用uip login登录。
3. 在每个参与者的计算机上安装项目相关工具：

   uip tools install or solution tm
   

4. 为项目使用的编码智能体在本地安装技能：

   uip skills install --agent cursor --local
   

5. 将本地技能存储目录添加到.gitignore （安装命令在首次运行时打印路径）。

在存储库中运行的智能体通过贡献者会话进行身份验证，技能会教它们如何使用uip ，而固定的工具可以保持构建的可重现性。

出现错误时

工具的命令未显示在 uip --help 中

该工具未安装或加载失败。检查：

uip tools list                  # is it installed?
uip --log-level debug or folders list   # what does the host say during tool load?

完成树和命令调度程序会静默跳过加载时存在错误的工具。

工具已安装，但命令失败，并显示“未知选项”

可能是版本不匹配 — 该工具是针对不同的 CLI 次要行构建的。使用uip tools update --name <tool>修复。

技能未显示在我的编码智能体中

每个智能体都通过自己的插件/规则系统处理技能文件。在uip skills install --agent <name>之后:

• Claude Code — 重新启动 Claude Code；技能将显示在插件选取器下。
• 光标— 技能在下一次对话时自动加载；选中~/.cursor/skills/ （全局）或./.cursor/skills/ （本地）。
• GitHub Copilot — 打开 Copilot 面板；技能位于~/.copilot/skills/ （全局）或./.github/skills/ （本地）下。
• Codex — 技能写入~/.agents/skills/或./.agents/skills/ （开放式智能体技能标准目录）。
• OpenCode — 技能写入~/.config/opencode/skills/ （全局）或./.opencode/skills/ （本地）。
• UiPath Autopilot — 技能写入~/.autopilot/skills/ （全局）或./.autopilot/skills/ （本地）。
• Kiro (Amazon Q) — 技能写入~/.kiro/skills/ （全局）或./.kiro/skills/ （本地）。
• Windsurface — 技能写入~/.windsurf/skills/ （全局）或./.windsurf/skills/ （本地）。
• 反人类 CLI — 技能写入~/.gemini/antigravity-cli/skills/ （全局）或./.agents/skills/ （本地）。
• Devin — 技能写入~/.agents/skills/或./.agents/skills/ （开放式智能体技能标准目录）。

运行uip skills install --agent <name> --print （或交互模式下的等效复选框）以查看确切的目标位置。

另请参阅

• 工具（插件） — “主机加插件”模式。
• 技能— AI 智能体扩展系统。
• UIP 工具参考— 完整标志列表。
• UIP 技能参考— 完整的标志列表。
• 安装 UiPath CLI — 控制工具自动安装— 自动安装在 CI 中的行为方式。
• 将 UiPath CLI 与 Coding Agents 结合使用— 每个智能体的设置演练。