- 概述
- 开始使用
- 概念
- 使用 UiPath CLI
- UiPath for Coding Agents
- 将 UiPath CLI 与 Coding Agent 结合使用
- 使用 UiPath for Coding Agents 运行
- 使用 UiPath for Coding Agents 进行故障排除
- 操作指南
- CI/CD 方法
- 命令参考
- 迁移
- 参考与支持
UiPath CLI 用户指南
AI 编码智能体（Claude Code、Cursor、GitHub Copilot、Gemini CLI、Codex、OpenCode）可以使用uip以与开发者相同的方式构建和运营 UiPath 自动化。您可以通过安装“技能：由 UiPath 发布的面向任务的指令捆绑包”来教他们。安装技能后，智能体就会知道何时打包解决方案、如何将publish与deploy run链接、何时等待作业、如何检查 Orchestrator 文件夹（整个表面，而不仅仅是命令名称）。
此页面将介绍每个智能体的设置：安装智能体自己的 CLI，登录到 UiPath，安装技能并验证安装。
先决条件
所有受支持的智能体都有相同的先决条件：
- 您的计算机上已安装
@uipath/cli。请参阅安装 UiPath CLI 。 - 已登录的会话。运行
uip login一次；技能使用与 CLI 的其余部分相同的会话。请参阅身份验证。 - 已安装的编码智能体。以下每个部分都链接到智能体的安装程序。
您无需在安装技能之前安装 UiPath 工具 ( uip tools install … ) — 智能体可以在首次使用时自动安装它们。
选择智能体
| 代理 | --agent 值 | 作用域支持 | 注意 |
|---|---|---|---|
| Claude 代码（插件） | claude | 仅限全球 | 技能作为 Claude 代码插件安装；插件系统是用户作用域，没有项目选项。 |
| 光标 | cursor | 全局或本地 | 技能已安装至.cursor/skills/<skill>/ ；通过光标，您可以在每个工作区中加载它们。 |
| GitHub Copilot | copilot | 全局或本地 | 技能已安装至.github/skills/<skill>/ ； Copilot 将其作为自定义指令加载。 |
| Gemini CLI | gemini | 全局或本地 | 技能已安装到.gemini/skills/<skill>/ 。 |
| 抄送 | codex | 全局或本地 | 技能将安装至.agents/skills/<skill>/ — 开放式智能体技能标准目录。 |
| 打开代码 | opencode | 全局或本地 | 将技能安装到.opencode/skills/<skill>/ （本地）或~/.config/opencode/skills/<skill>/ （全局）。 |
Claude 代码
安装智能体
请参阅claude.com/claude-code用于安装。在 macOS/Linux 上，常见路径为curl -fsSL https://claude.ai/install.sh | bash 。
安装技能
uip skills install --agent claude
uip skills install --agent claude
Claude Code仅适用于全局技能。使用--local传递ValidationError错误。
验证
打开 Claude 代码。询问：“打包此解决方案并将其部署到共享文件夹中。”智能体应提出uip solution pack → uip solution publish → uip solution deploy run提议——规范流。
如果智能体无法识别 UiPath 专属任务，请重新启动 Claude Code，以便其重新加载插件，然后重试。
光标
安装智能体
请访问光标.com ，了解安装信息。
安装技能
全局（在每个工作区中可用）：
uip skills install --agent cursor
uip skills install --agent cursor
每个项目（与存储库一起跟踪）：
cd /path/to/project
uip skills install --agent cursor --local
cd /path/to/project
uip skills install --agent cursor --local
本地安装会自动将技能存储目录添加到.gitignore — 缓存的技能捆绑包不会提交。
验证
在存储库中打开 Cursor。在Composer中，询问：“创建一个新的 UiPath Agent 项目并将其打包。”智能体应提出uip agent init → uip agent validate → uip agent pack提议。
GitHub Copilot
安装智能体
GitHub Copilot 是一个 VS Code/jetBrains/Visual Studio 插件。请参阅github.com/Features/copilot 。
安装技能
uip skills install --agent copilot
uip skills install --agent copilot
（为每个存储库的规则添加--local 。）
验证
在 VS Code（或受支持的编辑器）中打开项目，然后打开“Copilot 聊天”面板。询问 UiPath 专属任务。Copilot 在撰写回复时应引用已安装的技能规则。
Gemini CLI
安装智能体
安装技能
uip skills install --agent gemini
uip skills install --agent gemini
（为项目范围的技能添加--local 。）
验证
在存储库中运行gemini 。请求 UiPath 任务，并检查它是否从已安装的技能中建议uip命令。
抄送
安装智能体
请参阅 OpenAI 的 Codex 安装说明。
安装技能
uip skills install --agent codex
uip skills install --agent codex
验证
启动 Codex。请求执行 UiPath 任务；技能应将其引导到正确的uip命令链。
打开代码
安装智能体
请参阅opencode.ai 。
安装技能
uip skills install --agent opencode
uip skills install --agent opencode
验证
在项目目录中启动 OpenCode。检查已安装的技能文件的~/.config/opencode/skills/ （全局）或./.opencode/skills/ （本地）。
在实践中使用智能体
让智能体驾驶 — 请勿指定每个命令
技能对要使用的命令序列进行编码。询问结果（“将此解决方案部署到生产环境中”），而不是特定命令。智能体将链接pack → publish → deploy run （或要求您确认每个步骤，具体取决于智能体的模式）。
共享您的会话
智能体使用设置的uip login会话在您的计算机上运行uip 。如果您以个人帐户登录，则智能体将充当您的角色。如果您希望将智能体绑定到服务身份，请使用外部应用程序会话（身份验证中的流 2）。
保持技能和工具保持一致
CLI 升级后，还要运行uip skills update --agent <name>以选取任何新发布的技能，并uip tools update将工具添加到匹配的“MAJOR.MINOR”行。请参阅管理工具和技能。
当智能体卡住时
让智能体运行uip <command> --help并将输出反馈到对话中。内置帮助具有权威性，并且涵盖了技能可能尚未描述的标志。在给出帮助输出后，智能体通常会自行恢复。
MCP（替代路径）
对于不在支持的智能体列表中的 MCP 感知客户端，UiPath CLI 通过uip mcp附带 MCP 服务器。它公开了一个工具run_command ，可让客户端执行任何uip命令。这不是UiPath 的主要 AI 路径（技能才是），但可用于已经使用 MCP 的集成。请参阅UIP MCP 参考。
另请参阅
- 技能— 什么是技能、支持的智能体以及粒度模型。
- uip 技能参考— 标记参考。
- 管理工具和技能— 日常维护。
- 安装 UiPath CLI — 一次性设置。
- 身份验证— 智能体继承的会话流。
免责声明
Coding Agent 不会验证其生成的任何代码、其执行的操作命令或其建议的故障排除操作的合规性——您负责审核所有生成的代码、操作更改和诊断输出，然后再将其应用于生产。要以负责任的方式使用令牌：使用最小权限（而非您的完全访问权限）的专用令牌进行身份验证，以更清晰地审核追踪；在有人值守模式下运行，随时了解情况；确保配置第三方智能体防护机制，以限制范围并防止编码、运营和故障排除工作流中的意外行为；验证任何个人数据处理是否符合您组织的政策和数据保护要求；在每个内部控制或审批点保持人工监督，尤其是在执行可能影响实时环境的运营变更或根据故障排除建议采取行动之前。