故障排除（预览版）

用于故障排除的 Coding Agents 为 UiPath 平台提供了对话诊断功能。从计算机上的任何终端（包括 UiPath Studio 中的集成终端）用简单的英语描述故障，然后技能会对问题进行分类，对可能的原因进行排序，通过uip根据实时平台数据测试每个假设，并确切地告诉您发生了什么错误以及如何修复。

故障排除技能是 UiPath 技能目录的一部分，并通过uip skills install安装到您的编码智能体中。

工作方式

无论故障类型如何，诊断会话都遵循相同的四阶段流程：

1. 分类— 根据用户描述、作业或流程标识符或错误消息对故障作用域进行分类。如果输入模糊，技能会提出一个澄清问题。
2. 生成假设——利用相关领域的实践和分类流程中收集的证据，生成可能原因的排序列表。
3. 测试假设— 一次确认或消除一个假设。该技能通过uip获取日志、追踪、队列项目、修复数据、配置和审核事件，以收集证据。
4. 解决方案— 提出根本原因、产生故障的事件链以及具体的解决方法。该技能在更改任何内容之前会请求明确批准。

用户可以在四个时刻参与：在分类期间阐明范围；为假设生成提供额外的上下文；在需要时提供源代码或配置文件；以及批准建议的修复程序。

今天即可诊断的内容

故障排除技能涵盖以下领域。您描述的问题；该技能会获取证据并返回根本原因。

域	您可以诊断的内容	询问示例
RPA	失败的作业（ SelectorNotFoundException 、 TimeoutException等）、选取器不匹配、队列项目失败、Healing Agent 数据分析	“为什么 InvoiceBot 作业今天上午失败了？”
Orchestrator	作业卡住或发生故障、权限和角色问题、部署和发布错误、队列配置问题	“为什么我的机器人不从财务 队列中提取项目?”
Maestro	发生故障的流程实例、步骤级故障、故障、涉及智能体或 RPA 的多域故障链	“为什么审批流程实例在第 3 步出现故障？”

对其他 UiPath 域的支持已就位，但仍在加深。更多的域和更丰富的诊断即将推出。

该技能的操作访问权限与您相同。如果您无法以登录用户身份读取某些日志或文件夹，则技能也无法读取。

先决条件

1. 已为您的智能体安装 UiPath 技能。有关安装步骤，请参阅安装和设置。
2. 会话已登录 ( uip login )。请参阅安装和设置。

步骤

按照每台计算机的安装和设置运行一次中所述的安装程序。之后，该技能可在每个会话中使用。

从计算机上的任何终端或 UiPath Studio 中的集成终端启动编码智能体，然后通过输入/uipath-troubleshoot以显式调用技能，或直接描述问题，来启动诊断会话 — 例如，“我的作业 abc- 123 失败，发生了什么？”

响应技能的后续提示。用简单的英语回答澄清问题，并在技能请求时共享源代码、配置文件或其他工件。

该技能将打印结构化的根本原因摘要，其中包括发生故障的组件、产生故障的事件链、日志和追踪记录中的支持证据以及建议的修复方法。在更改计算机或租户中的任何内容之前，技能会请求明确批准。

以下示例显示了从 UiPath Studio 中的集成终端运行的会话：

有关有效会话的提示

像同事一样帮助您调试；上下文来回切换可改善结果：

• 请具体化。作业 ID、流程名称、队列名称和确切的错误消息可让技能跳过澄清轮次。
• 让对话继续进行。如果第一个建议与您发现的不符，请说明。“事实并非如此”、“我已经检查过”或“更深入地挖掘”等短语可以推动调查的进行。
• 在需要时重定向。如果技能遵循了错误的线程，请更正 — 例如，“问题与权限无关；作业昨天运行良好”。
• 当系统询问时共享文件。XAML、 project.json 、配置文件和类似工件可大幅提高诊断质量。
• 将访问权限与预期匹配。该技能使用您登录后的uip会话，并继承您的权限。如果您无法查看日志，则该技能也无法查看日志。

另请参阅

• 技能概述— 更广泛的技能机制
• 安装和设置— 将 CLI 和 UiPath 技能安装到 Claude Code、Cursor、Codex CLI 和 GoogleAnti Graity 中
• 保持最新状态— 日常维护