Fehlerbehebung mit UiPath für Codierung von Agents

Das Codieren von Agents für die Fehlerbehebung bringt Konversationsdiagnose auf die UiPath-Plattform. Beschreiben Sie einen Fehler in einfachem Englisch von einem beliebigen Terminal auf Ihrer Maschine – einschließlich des integrierten Terminals in UiPath Studio – und die Fähigkeit validiert das Problem, ordnet wahrscheinliche Ursachen ein, testet jede Annahme anhand von Live-Plattformdaten über uip und teilt Ihnen genau mit, was gelaufen ist falsch läuft und wie man es behebt.

Die Fähigkeit zur Fehlerbehebung ist Teil des UiPath-Fähigkeitenkatalogs und wird über uip skills install in Ihrem Codierungs-Agent installiert.

Wie es funktioniert

Eine Diagnosesitzung folgt unabhängig vom Fehlertyp demselben vierstufigen Ablauf:

1. Triage – Klassifizieren Sie den Fehler-Scope anhand der Beschreibung des Benutzers, des Auftrags- oder Prozessbezeichners oder der Fehlermeldung. Wenn die Eingabe mehrdeutig ist, stellt die Fähigkeit eine klärende Frage.
2. Annahmen generieren – Erstellen Sie eine sortierte Liste möglicher Ursachen, indem Sie sich auf das relevante Domain-Playbook und alle während der Triage gesammelten Nachweise stützen.
3. Annahmen testen – Eine Annahme auf einmal bestätigen oder eliminieren. Die Fähigkeit ruft Protokolle, Ablaufverfolgungen, Warteschlangenelemente, Reparaturdaten, Konfigurations- und Prüfungsereignisse über uip ab, um Nachweise zu erfassen.
4. Lösung – Zeigen Sie die Ursache, die Kette von Ereignissen, die zu dem Fehler geführt haben, und eine konkrete Lösung an. Die Fähigkeit fragt nach der expliziten Genehmigung, bevor sie etwas ändert.

Der Benutzer kann in vier Momenten beteiligt sein: Klärung des Scopes während der Triage, Bereitstellung von zusätzlichem Kontext für die Annahmengenerierung, Bereitstellung von Quellcode oder Konfigurationsdateien bei Bedarf und Genehmigung empfohlener Korrekturen.

Was Sie heute diagnostizieren können

Die Fähigkeit zur Fehlerbehebung deckt die folgenden Domänen ab. Sie beschreiben das Problem; Die Fähigkeit ruft den Nachweis ab und gibt eine Grundursache zurück.

Domäne	Was Sie diagnostizieren können	Beispiel:
RPA	Fehlgeschlagene Aufträge (SelectorNotFoundException, TimeoutException und ähnliche), Selektorkonflikte, Fehler bei Warteschlangenelementen, Datenanalyse von Healing Agent	„Warum ist der InvoiceBot-Auftrag heute Morgen fehlgeschlagen?“
Orchestrator	Festgefahrene oder fehlerhafte Aufträge, Berechtigungs- und Rollenprobleme, Bereitstellungs- und Veröffentlichungsfehler, Probleme mit der Warteschlangenkonfiguration	„Warum nimmt mein Roboter keine Elemente aus der Finanzwarteschlange auf?“
Maestro	Fehlerhafte Prozessinstanzen, Ausfälle auf Schrittebene, Vorfälle, Fehlerketten mit mehreren Domains, die Agents oder RPA betreffen	„Warum ist die Genehmigungsprozessinstanz bei Schritt 3 fehlgeschlagen?“

Die Unterstützung für andere UiPath-Domänen ist bereits vorhanden, wird aber noch vertieft. Weitere Domänen und umfassendere Diagnosen sind in Vorbereitung.

Die Fähigkeit funktioniert mit dem gleichen Zugriff, den Sie haben. Wenn Sie bestimmte Protokolle oder Ordner als angemeldeter Benutzer nicht lesen können, kann die Fähigkeit sie auch nicht lesen.

Voraussetzungen

1. UiPath-Fähigkeiten für Ihren Agent installiert. Weitere Informationen zum Installationsbefehl pro Agent finden Sie unter Verwenden von UiPath CLI mit Codierungs-Agents .
2. Eine angemeldete Sitzung (uip login). Siehe Authentifizierung.

Schritte

Führen Sie das hier beschriebene Setup mithilfe der UiPath CLI mit Codierungs-Agents einmal pro Maschine aus. Danach ist die Fähigkeit in jeder Sitzung verfügbar.

Starten Sie Ihren Codierungs-Agent über ein beliebiges Terminal auf Ihrer Maschine oder über das integrierte Terminal in UiPath Studio und starten Sie dann eine Diagnosesitzung, indem Sie /uipath-troubleshoot eingeben, um die Fähigkeit explizit aufzurufen, oder das Problem direkt beschreiben – z. B. „Mein Auftrag abc- 123 fehlgeschlagen, was ist passiert?“

Reagieren Sie auf die Folge-Prompts der Fähigkeit. Beantworten Sie klärende Fragen in einfachem Englisch und teilen Sie Quellcode, Konfigurationsdateien oder andere Artefakte mit, wenn die Fähigkeit dies anfordert.

Die Fähigkeit gibt eine strukturierte Ursachenzusammenfassung aus – die fehlgeschlagene Komponente, die Kette von Ereignissen, die zu dem Fehler geführt haben, unterstützende Nachweise aus Protokollen und Ablaufverfolgungen und eine empfohlene Fehlerbehebung. Bevor etwas auf Ihrer Maschine oder in Ihrem Mandanten geändert wird, fragt die Fähigkeit nach expliziter Genehmigung.

Das folgende Beispiel zeigt eine Sitzung, die über das integrierte Terminal in UiPath Studio ausgeführt wird:

Tipps für effektive Sitzungen

Behandeln Sie die Fähigkeit wie einen Kollegen, der Ihnen beim Debuggen hilft; Kontext und Hin-und Her verbessern das Ergebnis:

• Seien Sie spezifisch. Auftrags-IDs, Prozessnamen, Warteschlangennamen und genaue Fehlermeldungen lassen die Fähigkeit Klärungsrunden überspringen.
• Setzen Sie die Konversation fort. Wenn die erste Empfehlung nicht mit dem übereinstimmt, was Sie beobachten, sollten Sie dies angeben. Sätze wie „das ist es nicht“, „Das habe ich bereits überprüft“ oder „tiefer tiefen“ halten die Untersuchung fort.
• Weiterleitung bei Bedarf. Wenn die Fähigkeit dem falschen Thread folgt, korrigieren Sie dies – zum Beispiel „Das Problem betrifft nicht die Berechtigungen; der Auftrag ist gestern gelaufen.“
• Geben Sie Dateien frei, wenn Sie dazu aufgefordert werden. XAML, project.json, Konfigurationsdateien und ähnliche Artefakte verbessern die Diagnosequalität erheblich.
• Zugriff auf Erwartungen abgleichen. Die Fähigkeit verwendet Ihre angemeldete uip -Sitzung und erbt Ihre Berechtigungen. Wenn Sie ein Protokoll nicht anzeigen können, kann es auch die Fähigkeit nicht anzeigen.

Siehe auch

• Fähigkeiten – der umfassendere Fähigkeitsmechanismus
• Verwenden von UiPath CLI mit Codierungs-Agents – Installieren des UiPath-Fähigkeitenkatalogs in Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex und OpenCode
• Verwalten von Tools und Fähigkeiten – tägliche Wartung