Fehlersuche und ‑behebung

Lösungen für häufige Probleme mit Delegate, einschließlich Bildschirmkontextfehlern, Berechtigungsproblemen unter macOS und Windows und Fehlern bei der Verbindung oder Toolintegration.

Diese Seite ist Ihre einzige Referenz für die Behebung von Problemen in Delegate.

Einrichtung und Installation

Ich finde meine Anwendungen nicht

• Überprüfen, ob der Bildschirmkontext aktiviert ist (Umschalter am unteren Rand des Fensters)
• Stellen Sie sicher, dass die Berechtigungen für Bildschirmaufzeichnung/Zugänglichkeit in den Systemeinstellungen (macOS) erteilt wurden oder dass UAC (Benutzerkontensteuerung) akzeptiert wurde (Windows).
• Starten Sie Delegate nach Erteilung von Berechtigungen neu

Delegate meldet, dass er nicht auf eine Website zugreifen kann

• Überprüfen Sie Ihre Internetverbindung
• Einige Unternehmensnetzwerke blockieren bestimmte KI-Dienste – wenden Sie sich an Ihre IT-Abteilung, wenn Sie dies glauben
• Versuchen Sie es auf einer anderen Website, um das Problem zu isolieren

Die Browsererweiterung wird nicht erkannt

• Stellen Sie sicher, dass die Erweiterung in Ihrem Browser installiert und aktiviert ist
• In Chrome: chrome://extensions → Delegate muss aufgeführt und aktiviert sein
• Starten Sie Ihren Browser nach der Installation neu
• Führen Sie den Setup-Assistenten bei Bedarf erneut über die Einstellungen aus

Ich kann mich nicht anmelden

• Überprüfen Sie Ihre UiPath-Kontoanmeldeinformationen
• Wenn Ihre Organisation SSO (Single Sign-On) verwendet, stellen Sie sicher, dass Sie sich im Unternehmensnetzwerk oder VPN befinden
• Überprüfen Sie, ob Ihr Mandant korrekt ausgewählt ist

Aufgaben und Prompts

Der Delegate hat nicht verstanden, was ich wollen

• Teilen Sie die Anforderung in kleinere Schritte auf
• Seien Sie expliziter auf das Ziel und das Format
• Geben Sie ein Beispiel für die gewünschte Ausgabe an

Er begann etwas zu tun, was ich nicht erwartet hatte

• Drücken Sie Escape, um anzuhalten
• Fragen Sie: „Was versuchen Sie tun?“ um die Argumentation zu verstehen
• Mit einer klareren Anweisung umleiten

Die Aufgabe dauert zu lange

• Prüfen, ob Sie sich im Hintergrundmodus befinden (langsamer, aber nicht blockierend)
• Nach einer Statusaktualisierung fragen: „Was dauert so lange?“
• Erwägen Sie bei komplexen Aufgaben eine Aufteilung in kleinere Teile

Es wird ständig nach Bestätigung gefragt

• Sie befinden sich im geführten Modus – dies wird aus Sicherheitsgründen erwartet
• Wechseln Sie für vertrauenswürdige, sich wiederholende Workflows in den autonomen Modus
• Überprüfen Sie die Sicherheitseinstellungen, wenn Sie anpassen möchten, was die Bestätigung auslöst

Sicherheit und Berechtigungen

Delegate gibt an, dass er keine Berechtigung hat

1. Überprüfen Sie Einstellungen → Sicherheit → die entsprechende Toolkategorie ist aktiviert.
2. Überprüfen Sie die Tool-Berechtigungen für den spezifischen Tool- oder Connector-Vorgang.
3. Überprüfen Sie, ob sich die Ziel-App oder -Website in Blockierte Apps/Websites unter UI-Automatisierung befindet oder der Pfad mit einer Kategorie unter „Geschützte Dateien“ übereinstimmt.
4. Versuchen Sie, vorübergehend in den vorsichtigen Modus zu wechseln, um die spezifische Ablehnung anzuzeigen.

Ich habe eine Aktion genehmigt, sie ist aber trotzdem fehlgeschlagen

1. Überprüfen Sie die Berechtigungen auf Betriebssystemebene (macOS-Datenschutzeinstellungen, Windows UAC).
2. Stellen Sie sicher, dass sich die Anwendung oder Website nicht in Blockierte Apps/Websites unter UI-Automatisierung befindet.
3. Überprüfen Sie, ob der Dateipfad mit einer Kategorie unter „Geschützte Dateien“ übereinstimmt.
4. Überprüfen Sie die Fehlermeldung – sie kann auf ein anderes Problem hinweisen (Netzwerk, Authentifizierung usw.).

Ich möchte eine blockierte Site zulassen

1. Öffnen Sie Einstellungen → Sicherheit → UI-Automatisierung und aktivieren Sie Blockierte Websites – entfernen Sie die Website, wenn sie einzeln aufgeführt ist oder wenn sie als Teil einer Kategorie (Banking, Zahlungen, Krypto, Password Manager, Government, Gesundheitswesen) hinzugefügt wurde.
2. Wenn die Einstellung gesperrt ist und als von Ihrer Organisation verwaltet angezeigt wird, wenden Sie sich stattdessen an Ihren Administrator – sie wird über Automation Ops erzwungen und kann nicht lokal geändert werden.

Eine Fähigkeit fragt immer wieder nach Berechtigungen, die ich bereits erteilt habe

1. Prüfen Sie, ob die Fähigkeit eine andere Berechtigung als zuvor anfordert.
2. Stellen Sie sicher, dass das Manifest der Fähigkeit mit dem übereinstimmt, was sie tatsächlich verwendet.
3. Einige Berechtigungen sind sitzungsbezogen und erfordern eine erneute Genehmigung.
4. Gehen Sie zu Einstellungen → Berechtigungen → Zulässige Agents, um sicherzustellen, dass der entsprechende Agent aktiviert ist.

Verbindungen

Integration Service: Verbindung fehlgeschlagen oder Authentifizierungsfehler

Ursache

• OAuth-Token abgelaufen
• Kennwort im Quelldienst geändert
• Organisationsrichtlinie hat Zugriff von Drittanbietern widerrufen
• Unzureichende Berechtigungen erteilt

Solutions (Lösungen)

1. Gehen Sie zu Einstellungen → Verbindungen → Verbindung wiederherstellen.
2. Wenn dies fehlschlägt, widerrufen Sie die Verbindung und erstellen Sie sie neu.
3. Überprüfen Sie die eigenen Drittanbieter-App-Einstellungen des Diensts.
4. Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen in der Quellanwendung verfügen.

Integration Service: Keine Verbindung für [Dienst] gefunden

Ursache: Sie haben Delegate aufgefordert, einen Dienst zu verwenden, der nicht verbunden ist

Solutions (Lösungen)

1. Erstellen Sie die Verbindung in Einstellungen → Verbindungen.
2. Oder geben Sie einen anderen Ansatz an, der diesen Dienst nicht erfordert.

Integration Service: Unzureichende Berechtigungen

Ursache: Die Verbindung ist vorhanden, aber es fehlen die für die angeforderte Aktion erforderlichen Scopes

Solutions (Lösungen)

1. Trennen Sie die Verbindung und stellen Sie sie wieder her, um zusätzliche Berechtigungen zu gewähren, wenn Sie dazu aufgefordert werden.
2. Wenden Sie sich an Ihren IT-Administrator, wenn Organisationsrichtlinien Scopes einschränken.

MCP: Fehler beim Herstellen einer Verbindung mit dem MCP-Server

Ursache

• Remoteserver ist ausgefallen oder nicht erreichbar
• Der lokale Prozess konnte nicht gestartet werden
• Netzwerk/Firewall blockiert die Verbindung
• Ungültige URL oder Konfiguration

Solutions (Lösungen)

1. Stellen Sie sicher, dass der Server ausgeführt wird (für lokal) oder zugänglich (für remote) ist.
2. Prüfen Sie die URL/den Befehl auf Tippfehler.
3. Testen Sie den Endpunkt manuell (curl, Browser).
4. Überprüfen Sie die Firewalleinstellungen.
5. Überprüfen Sie lokale Prozessprotokolle auf Startfehler.

MCP: Server verbunden, aber keine Tools verfügbar

Ursache: Der Server wird ausgeführt, hat aber keine Tools registriert oder Tools konnten nicht initialisiert werden

Solutions (Lösungen)

1. Überprüfen Sie die Dokumentation des Servers für die erforderliche Konfiguration.
2. Stellen Sie sicher, dass die Umgebungsvariablen korrekt festgelegt sind.
3. Starten Sie den MCP-Server neu.
4. Überprüfen Sie die Serverprotokolle auf Initialisierungsfehler.

MCP: Toolaufruf fehlgeschlagen oder MCP-Fehler

Ursache: Der Server hat die Anforderung erhalten, konnte sie aber nicht ausführen

Solutions (Lösungen)

1. Überprüfen Sie die spezifische Fehlermeldung auf der Toolkarte.
2. Stellen Sie sicher, dass die erforderlichen Parameter des Tools angegeben wurden.
3. Überprüfen Sie, ob die zugrunde liegende Ressource (Datei, Datenbank, API) zugänglich ist.
4. Überprüfen Sie MCP-Serverprotokolle auf detaillierte Fehlerinformationen.

Routinen

Routine nicht gefunden

Ursache: Die Routine wurde gelöscht, oder der Ordner „LocalSkills“ wurde verschoben

Solutions (Lösungen)

1. Überprüfen Sie, ob sich die Routine unter Einstellungen → Routinen befindet.
2. Wenn importiert, importieren Sie erneut aus der Originaldatei.
3. Überprüfen Sie den Pfad des Ordners „LocalSkills“ unter „Einstellungen“ → „Fähigkeiten &“ UiPath Marketplace.

Fehlende erforderliche Eingabe

Ursache: Die Routine erwartet einen Parameter, der nicht angegeben wurde

Solutions (Lösungen)

1. Füllen Sie während der Ausführung alle aufgeforderten Eingaben aus.
2. Stellen Sie bei der Planung sicher, dass feste Werte für alle erforderlichen Eingaben festgelegt sind.
3. Bearbeiten Sie die Routine, um Eingaben mit Standardeinstellungen optional zu machen.

Routine bei Schritt X fehlgeschlagen

Ursache: Eine Aktion in der Routine konnte nicht abgeschlossen werden

Solutions (Lösungen)

1. Überprüfen Sie die Fehlermeldung auf der Toolkarte.
2. Überprüfen Sie, ob die erforderlichen Verbindungen aktiv sind (Einstellungen → Verbindungen).
3. Stellen Sie sicher, dass Eingabedateien vorhanden und zugänglich sind.
4. Überprüfen Sie, ob Zielanwendungen installiert sind.
5. Führen Sie den geführten Modus aus, um genau zu sehen, wo es fehlschlägt.

Geplante Routine wurde nicht ausgeführt

Ursache: Planungsdienst wird nicht ausgeführt oder Berechtigungsproblem

Solutions (Lösungen)

1. Überprüfen Sie Einstellungen → Routinen → Geplant für den Ausführungsstatus.
2. Stellen Sie sicher, dass Delegate zur geplanten Zeit ausgeführt wurde.
3. Prüfen Sie, ob die Maschine im Ruhezustand war (Zeitpläne werden möglicherweise nicht im Ruhezustand ausgeführt).
4. Überprüfen Sie den Ausführungsverlauf auf Fehlermeldungen.
5. Stellen Sie sicher, dass Verbindungen noch gültig (nicht abgelaufen) sind.

Speichern und Fähigkeiten

Element wird nicht installiert

Ursache

• Problem mit der Netzwerkkonnektivität
• Nicht genügend Speicherplatz
• Fehlerhafter Download
• Inkompatible Delegate-Version

Solutions (Lösungen)

1. Überprüfen Sie die Internetverbindung.
2. Geben Sie Speicherplatz frei (siehe LocalSkills-Verzeichnis).
3. Versuchen Sie die Installation erneut.
4. Überprüfen Sie, ob Ihr Delegate auf dem neuesten Stand ist.
5. Wenden Sie sich an den Herausgeber, wenn das Problem weiterhin besteht.

Installierte Fähigkeit wird nicht angezeigt

Ursache

• Fähigkeit ist deaktiviert
• Nicht zur Liste „EnabledSkills“ hinzugefügt
• Delegate muss neu gestartet werden

Solutions (Lösungen)

1. Einstellungen prüfen → Fähigkeiten & Marketplace → Die Fähigkeit wird aufgelistet und aktiviert.
2. Starten Sie Delegate neu.
3. Überprüfen Sie den Ordner „LocalSkills“ auf die Fähigkeitsdateien.

Die Fähigkeit schlägt fehl, wenn ich versucht, sie zu verwenden

Ursache

• Erforderliche Verbindungen fehlen
• Fehlende erforderliche Berechtigungen
• Veraltete Fähigkeitsversion
• Anwendungsversion stimmt nicht überein

Solutions (Lösungen)

1. Informationen zu den Voraussetzungen finden Sie in der Dokumentation der Fähigkeit.
2. Erstellen Sie erforderliche Verbindungen unter Einstellungen → Verbindungen.
3. Aktivieren Sie erforderliche Toolkategorien unter Einstellungen → Sicherheit.
4. Aktualisieren Sie die Fähigkeit auf die neueste Version.
5. Prüfen Sie, ob die Version der Zielanwendung unterstützt wird.

Benutzerdefinierter Feed wird nicht geladen

Ursache

• Ungültige Feed-URL
• Feedserver ausgefallen
• Feedformat falsch
• Netzwerk-/Firewall-Blockierung

Solutions (Lösungen)

1. Stellen Sie sicher, dass die URL korrekt und in einem Browser zugänglich ist.
2. Überprüfen Sie das Feed-Format anhand der UiPath-Spezifikation.
3. Wenden Sie sich an den Feed-Administrator.
4. Überprüfen Sie die Firewall-Einstellungen des Unternehmens.

Einstellungen

Einstellungsänderungen werden nicht wirksam

Ursache: Einige Einstellungen erfordern einen Neustart der App; Die Registerkarteneinstellungen für Sicherheit und Berechtigungen können nur über die Benutzeroberfläche der Einstellungen geändert werden, nicht durch direktes Bearbeiten der Datei.

Solutions (Lösungen)

1. Starten Sie Delegate neu und überprüfen Sie, ob die Einstellung wirksam wurde.
2. Wenn sich die Einstellung auf der Registerkarte Sicherheit oder Berechtigungen befindet, verwenden Sie die Benutzeroberfläche für Einstellungen, anstatt die Datei direkt zu bearbeiten.
3. Wenn Siesettings.json manuell bearbeiten, stellen Sie sicher, dass Sie den richtigen Dateipfad bearbeiten.

Einstellungsdatei ist beschädigt

Ursache:settings.json hat eine ungültige JSON-Syntax, was häufig auf einen Fehler bei der manuellen Bearbeitung zurückzuführen ist. Delegate greift automatisch auf die Standardeinstellungen zurück.

Solutions (Lösungen)

1. Delegate schließen.
2. Löschen oder benennen Sie settings.json um.
3. Restart Delegate – neue Standardeinstellungen werden erstellt.
4. Konfigurieren Sie Ihre Einstellungen neu.

Eine Einstellung kann nicht gefunden werden

Ursache: Die Einstellung befindet sich möglicherweise auf einer anderen Registerkarte als erwartet oder ist nur über die Benutzeroberfläche für Einstellungen verfügbar.

Solutions (Lösungen)

1. Überprüfen Sie, ob sich die Einstellung auf der Registerkarte Sicherheit (nur UI) befindet.
2. Überprüfen Sie Ihre Delegate-Version – einige Einstellungen sind versionsspezifisch.

Sichere Einstellungen werden nicht gespeichert

Ursache: Die Sicherheit auf Betriebssystemebene verhindert den Zugriff auf den verschlüsselten Einstellungsspeicher: macOS-Schlüsselschlüssel oder Windows-Datenschutz-API (DPAPI).

Solutions (Lösungen)

1. Überprüfen Sie die Sicherheitsberechtigungen auf Betriebssystemebene.
2. macOS: Stellen Sie sicher, dass der Schlüsselschlüssel entsperrt ist.
3. Windows: Stellen Sie sicher, dass Ihr Benutzerprofil ordnungsgemäß geladen ist.
4. Starten Sie Delegate neu.
5. Wenn sie weiterhin besteht, wenden Sie sich an den UiPath-Support.