故障排除和常见问题解答

有关 uip CLI 和 UiPath 技能的常见设置和 runtime 问题的解决方案，包括安装失败、登录问题和无法识别的技能。

此页面列出了人们在设置和使用 UiPath for Coding Agents 时最常遇到的问题，并按您看到的症状整理。

安装程序中止失败

如果单行代码因错误而停止，请阅读屏幕上的消息 — 安装程序会将其状态和错误写入终端。

• 如果单个 Runtime 发生故障，请重新运行安装程序。每个步骤都是幂等的，并且会跳过已成功的步骤。
• 如果您尚不需要 .NET SDK 或 Python，请使用--skip-runtimes重新运行，以先获取 CLI 和技能。

npm 返回 403、404 或超时错误

如果在检索 @uipath 包时安装或更新失败，请确认您的 npm 客户端或内部存储库可以访问公共 UiPath 包作用域。仅允许 @uipath/cli 是不够的，因为 CLI 会根据需要检索特定于技能和功能的支持包。

有关所需的作用域、注册表端点、配置和验证命令，请参阅受限网络和内部 npm 注册表。

安装后显示“uip：未找到命令”

如果无法识别uip ，则您的PATH无法选取新安装的内容。

1. 打开新终端，以便更新的PATH生效。
2. 再次运行uip --help进行确认。

UIP 登录未完成

如果浏览器未打开或登录未完成：

• 确认您可以在浏览器中访问 UiPath 环境。
• 如果您使用cloud.uipath.com以外的环境，请显式传递： uip login --authority "https://your-environment" 。
• 如果选错了租户，请运行uip login -it并选择正确的租户。

您的智能体似乎未使用这些技能

如果您的编码智能体表现得就像不知道 UiPath 一样：

1. 再次运行uip skills install ，确认安装的技能。
2. 确认您的智能体是受支持的智能体之一（请参阅选择智能体）。
3. 重新启动编码智能体，以便它重新加载已安装的技能。

构建时缺少 Runtime

如果构建由于缺少 Node.js、.NET SDK 或 Python 而失败，请重新运行安装程序（不设置任何跳过标志），以便安装之前跳过的运行时。

获取更多帮助

为了进行更深入的调查，您的编码智能体可以使用uipath-troubleshoot技能来诊断特定故障。要使用uipath-feedback要求其报告错误或建议，或直接运行反馈命令。