- 开始使用
- 最佳实践
- 功能
- 技能
- CLI
- 示例
- 高级
- 帮助
A coding agent with UiPath skills installed brings conversational diagnostics to the UiPath platform. Describe a failure in plain English from any terminal on your machine — including the integrated terminal in UiPath Studio — and it triages the issue, ranks likely causes, tests each hypothesis against live platform data through uip, and tells you exactly what went wrong and how to fix it.
故障排除技能是 UiPath 技能目录的一部分，并通过uip skills install安装到您的编码智能体中。
工作方式
无论故障类型如何，诊断会话都遵循相同的四阶段流程：
- 分类— 根据用户描述、作业或流程标识符或错误消息对故障作用域进行分类。如果输入模糊，技能会提出一个澄清问题。
- 生成假设——利用相关领域的实践和分类流程中收集的证据，生成可能原因的排序列表。
- 测试假设— 一次确认或消除一个假设。该技能通过
uip获取日志、追踪、队列项目、修复数据、配置和审核事件，以收集证据。 - 解决方案— 提出根本原因、产生故障的事件链以及具体的解决方法。该技能在更改任何内容之前会请求明确批准。
用户可以在四个时刻参与：在分类期间阐明范围；为假设生成提供额外的上下文；在需要时提供源代码或配置文件；以及批准建议的修复程序。
今天即可诊断的内容
故障排除技能涵盖以下领域。您描述的问题；该技能会获取证据并返回根本原因。
| 域 | 您可以诊断的内容 | 询问示例 |
|---|---|---|
| RPA | 失败的作业（ SelectorNotFoundException 、 TimeoutException等）、选取器不匹配、队列项目失败、Healing Agent 数据分析 | “为什么 InvoiceBot 作业今天上午失败了？” |
| Orchestrator | 作业卡住或发生故障、权限和角色问题、部署和发布错误、队列配置问题 | “为什么我的机器人不从财务 队列中提取项目?” |
| Maestro | 发生故障的流程实例、步骤级故障、故障、涉及智能体或 RPA 的多域故障链 | “为什么审批流程实例在第 3 步出现故障？” |
| Agents (智能体) | LLM step errors, context grounding and resource errors, input schema validation failures, guardrail violations, and Integration Service tool-call failures | "Why did my agent stop with a guardrail violation?" |
| Integration Service | Connection authentication and token-refresh failures, connector activity errors, missing required inputs, and triggers that don't fire or fail to execute | "Why is my Salesforce connection returning a 401?" |
对其他 UiPath 域的支持已就位，但仍在加深。更多的域和更丰富的诊断即将推出。
该技能的操作访问权限与您相同。如果您无法以登录用户身份读取某些日志或文件夹，则技能也无法读取。
先决条件
步骤
按照每台计算机的安装和设置运行一次中所述的安装程序。之后，该技能可在每个会话中使用。
从计算机上的任何终端或 UiPath Studio 中的集成终端启动编码智能体，然后通过输入/uipath-troubleshoot以显式调用技能，或直接描述问题，来启动诊断会话 — 例如，“我的作业 abc- 123 失败，发生了什么？”
响应技能的后续提示。用简单的英语回答澄清问题，并在技能请求时共享源代码、配置文件或其他工件。
该技能将打印结构化的根本原因摘要，其中包括发生故障的组件、产生故障的事件链、日志和追踪记录中的支持证据以及建议的修复方法。在更改计算机或租户中的任何内容之前，技能会请求明确批准。
以下示例显示了从 UiPath Studio 中的集成终端运行的会话：
有关有效会话的提示
像同事一样帮助您调试；上下文来回切换可改善结果：
- 请具体化。作业 ID、流程名称、队列名称和确切的错误消息可让技能跳过澄清轮次。
- 让对话继续进行。如果第一个建议与您发现的不符，请说明。“事实并非如此”、“我已经检查过”或“更深入地挖掘”等短语可以推动调查的进行。
- 在需要时重定向。如果技能遵循了错误的线程，请更正 — 例如，“问题与权限无关；作业昨天运行良好”。
- 当系统询问时共享文件。XAML、
project.json、配置文件和类似工件可大幅提高诊断质量。 - 将访问权限与预期匹配。该技能使用您登录后的
uip会话，并继承您的权限。如果您无法查看日志，则该技能也无法查看日志。