Fehlerbehebung

Die meisten Probleme zeigen sich als Hinweis: eine Meldung, die nennt, was angehalten hat und warum. Diese Seite behandelt die am häufigsten auftretenden.

Installieren und Starten

Windows sagt, der Installer stammt von einem unbekannten Herausgeber. Die Builds sind noch nicht code-signiert. Wähle Weitere Informationen und dann Trotzdem ausführen.

Die macOS-App aktualisiert sich nicht. Unsignierte macOS-Apps können das nicht. Lade die neue Version von der Releases-Seite herunter und installiere sie über die alte.

Die App sagt, ihr Port ist belegt. Etwas anderes lauscht dort, wo der lokale Prozess der App (das gateway) starten möchte, oft eine alte Kopie, die sich nicht beendet hat. Das Panel nennt den Prozess und bietet an, ihn zu beenden (Dieses gateway beenden für ein altes Perfica, ansonsten Beenden gefolgt von seinem Namen oder seiner PID), oder für diese Sitzung Diesmal einen anderen Port verwenden.

Die App sagt Das gateway konnte nicht gestartet werden. Ihr lokaler Prozess ist abgestürzt oder hat innerhalb einer Minute nicht geantwortet. Das Panel zeigt die letzten ausgegebenen Zeilen. Drücke Erneut versuchen; wenn es wieder fehlschlägt, melde den Fehler mit diesen Zeilen.

Ich habe das Fenster geschlossen und die App läuft noch. Das ist Absicht, damit Loops weiterlaufen. Beende sie mit Perfica beenden im Menü der Taskleiste.

Ein Loop hat angehalten

Ein Loop, der anhält, sagt warum, in einem Hinweis und in seinem Panel auf dem Canvas. Die üblichen Gründe:

Was die App sagt	Was zu tun ist
Der Loop hat seine maximalen Ausführungen oder seine Fehlergrenzen erreicht	Lies im Protokoll-Tab des Managers nach, welche Bubble immer wieder fehlgeschlagen ist. Behebe die Ursache oder erhöhe die Grenze in den Einstellungen des Loops und drücke dann auf Play.
Es ist keine Arbeit mehr übrig: Karten warten im Draft	Gib die Karten frei, an denen gearbeitet werden soll, und drücke dann auf Play.
Karten warten aufeinander	Zwei oder mehr Karten hängen voneinander ab. Öffne das Task Book und drücke bei einer von ihnen auf Warten stoppen.
Das Kontingent des Modells ist erschöpft, mit der Uhrzeit, zu der es einen neuen Versuch startet	Nichts: Der Loop startet zu dieser Zeit von selbst neu und versucht es so lange weiter, wie das Board in Ruhe gelassen wird. Drücke auf Play, um es jetzt zu versuchen, Einen kostenpflichtigen Schlüssel hinzufügen, um ohne zu warten fortzufahren, oder nutze einen Pool.
Der Modellanbieter hat nicht mehr geantwortet	Der Anbieter hat selbst nach drei erneuten Nachfragen von Perfica über einen Zeitraum von etwa sieben Sekunden nicht geantwortet. Es wurde kein Fehler gezählt. Prüfe, ob er läuft, und drücke dann auf Play.
Das Durchgangs-Budget des Boards ist aufbraucht	Die maximalen Ausführungen aller Loops zusammen ergeben das Budget des Boards. Erhöhe das Maximum bei dem Loop, der weiterkommen soll.

Nachdem du einen Stopp behoben hast, setzt Play die Fehlerzähler des Loops zurück und startet ihn erneut.

Ein Durchgang endete mit ERROR

ERROR bedeutet, dass der Agent nie wirklich lief. Häufige Ursachen:

• Der Schlüssel gehört zu einem anderen Anbieter. Eine Bubble verweist auf einen Schlüssel, der für einen anderen Anbieter gespeichert ist.
• Wähle den richtigen Schlüssel im Inspektor der Bubble.
• Das Modell kann die Aufgabe nicht erledigen. Einige kleine Modelle können keine Tools aufrufen oder das Format der Antwort einhalten.
• Wähle ein größeres Modell für diese Bubble.
• Ein Bild und niemand, der es sieht. Das Modell der Bubble kann keine Bilder sehen und es ist kein Vision-Modell eingestellt.
• Stelle eines auf der Seite “Modelle” unter Helfer-Modelle ein.

Befehle und Tools

“Ein Befehl wurde verweigert, weil er nicht in einer Sandbox ausgeführt werden konnte”. Die Sandbox ist eingeschaltet, aber ihr Backend ist nicht bereit. Einstellungen › Autonomie › Befehls-Sandbox zeigt den einen Schritt zu ihrer Behebung und den genau zu kopierenden Befehl. Befehle bleiben bis dahin verweigert; sie laufen niemals außerhalb einer Sandbox.

“Agenten benötigen Git für Windows, um Befehlszeilen auszuführen”. Agenten benötigen Git für Windows, um Befehlsketten und Umleitungen auszuführen. Installiere es. Nichts muss neu gestartet werden: Der nächste Befehl sucht wieder danach.

Ein Befehl wartet auf eine Antwort, die nie kommt. Freigaben erscheinen im Fenster der App. Wenn kein Fenster geöffnet ist, wird der Befehl anstatt zu warten verweigert.

“Agenten benötigen einen Browser, um die laufende App anzusehen”. Die visuelle Überprüfung und die Browser-Tools benötigen Chrome, Edge oder ein heruntergeladenes Chromium. Einstellungen › Autonomie › Agenten-Browser bietet den Download an. Nichts muss neu gestartet werden.

Die Websuche meldet, dass sie nicht erreichbar ist. Die eingebaute Suche hat nicht geantwortet, daher kamen die Ergebnisse nur von npm, GitHub, Stack Overflow, MDN und Wikipedia. Sie startet bei der nächsten Suche neu. Ein Schlüssel von Brave oder Tavily sendet jede Suche an diesen Dienst anstelle des eingebauten.

Die Vorschau

Die Vorschau startet nicht. Vorschauen benötigen ein dev- oder start-Skript in der package.json des Projekts (oder in einem Ordner der ersten Ebene). Ein Board, das Befehle in einer Sandbox ausführt, kann keines ausführen. Wenn es abgestürzt ist, zeigt der Bericht-Tab den Exit-Code und die letzten Zeilen seines Protokolls an.

Kein Abschlussbericht nach einem Lauf. Nur Läufe, denen von selbst die Arbeit ausgegangen ist, übergeben einen Bericht. Ein Lauf, den du pausiert oder gestoppt hast, oder einer, der ein Limit erreicht hat, schreibt keinen Bericht. Um trotzdem einen zu erhalten, öffne den Bericht-Tab des Managers und drücke auf Bericht schreiben.