故障排除

常见 Delegate 问题的解决方案，包括屏幕上下文错误、macOS 和 Windows 上的权限问题以及连接或工具集成失败。

此页面是您解决 Delegate 问题的唯一参考。

设置和安装

我看不到我的应用程序

• 检查是否已启用“屏幕上下文”（窗口底部的切换开关）
• 验证是否已在“系统设置”(macOS) 中授予屏幕录制/辅助功能权限，或者是否接受 UAC（用户帐户控制）(Windows)
• 授予权限后重新启动 Delegate

Delegate 表示无法访问网站

• 请检查您的互联网连接
• 某些公司网络会阻止某些 AI 服务—如对此有疑问，请联系您的 IT 部门
• 尝试其他网站以隔离问题

未检测到浏览器扩展程序

• 请确保已在浏览器中安装并启用该扩展程序
• 在 Chrome 上：chrome://extensions → 应列出并启用 Delegate
• 安装后重新启动浏览器
• 如有需要，从“设置”中重新运行设置向导

我无法登录

• 验证您的 UiPath 帐户凭据
• 如果您的组织使用 SSO（单点登录），请确保您访问的是公司网络或 VPN
• 检查是否正确选择了租户

任务和提示

Delegate 未理解我的需求

• 将请求分解为更小的步骤
• 让目标和格式更明确
• 请提供所需输出的示例

它开始执行我意外的操作

• 按 Escape 键停止
• 询问“您想要执行什么操作？”理解其推理过程
• 使用更清晰的指令进行重定向

任务耗时过长

• 检查是否处于后台模式（速度较慢，但非阻止）
• 请求状态更新：“为什么花费那么长时间？”
• 对于复杂的任务，请考虑分解为更小的块

不断要求您确认

• 您正处于引导模式—这是出于安全考虑
• 切换到自主模式，以处理受信任的重复性工作流
• 如果要调整触发确认的内容，请查看“安全设置”

安全性和权限

Delegate 表示没有权限

1. 检查“设置”→“安全性”→是否启用了相关工具类别。
2. 检查特定工具或连接器操作的工具权限。
3. 检查目标应用程序或网站是否位于“用户界面自动化”下的“阻止的应用程序/网站”中，或者检查路径是否与“受保护的文件”下的类别匹配。
4. 请尝试暂时切换到“谨慎”模式，以查看特定的拒绝操作。

我批准了一个操作，但操作仍然失败

1. 检查操作系统级权限（macOS 隐私设置、Windows UAC）。
2. 请验证应用程序或网站是否位于用户界面自动化下的“阻止的应用程序/网站”中。
3. 检查文件路径是否与“受保护的文件”下的类别匹配。
4. 查看错误消息 — 它可能表示存在其他问题（网络、身份验证等）

我想允许使用被阻止的网站

1. 打开设置→安全性→用户界面自动化，然后选中阻止的网站— 如果网站是单独列出的，或者是作为类别的一部分添加（银行业务、付款、加密货币、密码管理器、政府、医疗保健），则将其删除。
2. 如果设置已锁定并显示为由您的组织管理，请联系您的管理员 — 此设置是通过 Automation Ops 强制执行的，无法在本地更改。

一项技能不断询问我是否已授予权限

1. 检查技能请求的权限是否与以前不同。
2. 验证技能清单是否与其实际使用的相符。
3. 部分权限在会话范围内有效，需要重新获得批准。
4. 选中“设置”→“权限”→“允许的智能体”，以确保相关智能体已启用。

连接

Integration Service：连接失败或身份验证错误

原因

• OAuth 令牌已过期
• 已在源服务中更改密码
• 已撤销组织策略的第三方访问权限
• 授予的权限不足

Solutions (解决方案)

1. 转到“设置”→“连接”→“重新连接”。
2. 如果失败，请撤销并重新创建连接。
3. 请检查服务自身的第三方应用程序设置。
4. 请验证您在源应用程序中拥有必要的权限。

Integration Service：未找到 [服务] 的连接

原因：您要求Delegate使用未连接的服务

Solutions (解决方案)

1. 在“设置”→“连接”中创建连接。
2. 或指定不需要该服务的其他方法。

Integration Service：权限不足

原因：连接存在，但缺少请求操作所需的作用域

Solutions (解决方案)

1. 断开连接并重新连接，在系统提示时授予其他权限。
2. 请咨询 IT 管理员是否是组织策略限制了作用域。

MCP：无法连接到 MCP 服务器

原因

• 远程服务器关闭或无法访问
• 本地流程启动失败
• 网络/防火墙阻止连接
• URL 或配置无效

Solutions (解决方案)

1. 请验证服务器正在运行（适用于本地）或可访问（适用于远程）。
2. 检查 URL/命令是否存在输入错误。
3. 手动测试端点（curl、浏览器）。
4. 检查防火墙设置。
5. 查看本地流程日志以获取启动错误。

MCP：服务器已连接，但没有可用的工具

原因：服务器正在运行，但未注册任何工具，或者工具初始化失败

Solutions (解决方案)

1. 查看服务器文档以获取所需配置。
2. 验证环境变量是否设置正确。
3. 重新启动 MCP 服务器。
4. 检查服务器日志中的初始化错误。

MCP：工具调用失败或 MCP 出现错误

原因：服务器收到请求，但无法执行

Solutions (解决方案)

1. 查看工具卡中的特定错误消息。
2. 验证是否已提供工具所需的参数。
3. 检查基础资源（文件、数据库、API）是否可访问。
4. 请查看 MCP 服务器日志以获取详细错误信息。

例程

未找到例程

原因： 例程已删除，或本地技能文件夹已移动

Solutions (解决方案)

1. 检查例程是否在“设置”→“例程”中。
2. 如果已导入，则从原始文件重新导入。
3. 在“设置”→“技能和技能”中检查“本地技能”文件夹路径Marketplace。

缺少必要的输入

原因：例程需要一个未提供的参数

Solutions (解决方案)

1. 运行时，请填写所有收到提示的输入。
2. 如果进行计划，请确保为所有必需的输入设置固定值。
3. 编辑例程，使输入设为可选输入并设置默认值。

例程在第 X 步失败

原因：例程中的操作无法完成

Solutions (解决方案)

1. 查看工具卡中的错误消息。
2. 验证所需的连接是否处于活动状态（设置 → 连接）。
3. 请确保输入文件存在且可访问。
4. 检查是否已安装目标应用程序。
5. 在引导模式下运行，以查看失败的确切位置。

未运行计划例程

原因：计划服务未运行，或权限问题

Solutions (解决方案)

1. 检查“设置”→“例程”→“已计划”，了解运行状态。
2. 验证 Delegate 是否在计划的时间运行。
3. 检查计算机是否处于睡眠状态（睡眠时可能不会运行计划）。
4. 查看运行历史记录以获取错误消息。
5. 确保连接仍然有效（未过期）。

存储和技能

将不会安装项目

原因

• 网络连接问题
• 磁盘空间不足
• 下载内容已损坏
• Delegate 版本不兼容

Solutions (解决方案)

1. 请检查互联网连接。
2. 释放磁盘空间（查看“本地技能”目录）。
3. 尝试重新安装。
4. 检查您的 Delegate 是否为最新状态。
5. 如果问题持续存在，请联系发布者。

已安装的技能未显示

原因

• 技能已禁用
• 未添加到“启用的技能”列表
• Delegate 需要重新启动

Solutions (解决方案)

1. 检查设置 → 技能和字段Marketplace → 已列出并启用技能。
2. 重新启动 Delegate。
3. 检查 LocalSkills 文件夹中的技能文件。

我尝试使用技能失败

原因

• 缺少所需连接
• 缺少所需权限
• 技能版本已过时
• 应用程序版本不匹配

Solutions (解决方案)

1. 查看技能文档以了解先决条件。
2. 在“设置”→“连接”中创建所需的连接。
3. 在“设置”→“安全”中启用所需的工具类别。
4. 将技能更新到最新版本。
5. 检查目标应用程序版本是否受支持。

无法加载自定义订阅源

原因

• 订阅源 URL 无效
• 订阅源服务器关闭
• 订阅源格式不正确
• 网络/防火墙阻止

Solutions (解决方案)

1. 验证 URL 是否正确且能否在浏览器中访问。
2. 是否根据 UiPath 规范检查订阅源格式。
3. 请联系订阅源管理员。
4. 检查公司防火墙设置。

设置

设置更改未生效

原因：某些设置需要重新启动应用程序；只能通过“设置”用户界面更改“安全和权限”选项卡设置，不能直接编辑文件。

Solutions (解决方案)

1. 重新启动 Delegate 并检查设置是否生效。
2. 如果设置位于“安全性”或“权限”选项卡上，请使用“设置”用户界面，而不是直接编辑文件。
3. 如果手动编辑settings.json，请验证您正在编辑的文件路径是否正确。

设置文件已损坏

原因：settings.json 包含无效的 JSON 语法，这通常源自手动编辑错误。Delegate 会自动回退为默认设置。

Solutions (解决方案)

1. 关闭 Delegate。
2. 删除或重命名 settings.json。
3. Restart Delegate — 创建新的默认值。
4. 重新配置您的首选项。

找不到设置

原因：该设置可能位于与预期不同的选项卡上，或者只能通过“设置”用户界面访问。

Solutions (解决方案)

1. 检查设置是否位于“安全性”选项卡上（仅用户界面）。
2. 验证您的 Delegate 版本——某些设置因版本而异。

系统将不会保存安全设置

原因：操作系统级别的安全性正在阻止访问加密的设置存储：macOS 密钥链或 Windows 数据保护 API (DPAPI)。

Solutions (解决方案)

1. 检查操作系统级安全权限。
2. macOS：确保密钥链已解锁。
3. Windows：确保已正确加载您的用户配置文件。
4. 重新启动 Delegate。
5. 如果持续存在，请联系 UiPath 支持团队。