Wie stoppe ich einen KI-Agenten, der in einer Schleife hängt?

Pausiere ihn auf der engsten passenden Ebene. In Done ruft ein Agent, der festhängt, pause_task auf, um eine Aufgabe aus dem Spiel zu nehmen, oder pause_board, um den ganzen Lauf zu stoppen, und muss einen Grund nennen. Pausierte Arbeit bleibt aus der Warteschlange jedes Agenten, bis ein Mensch sie in der App fortsetzt; der Agent, der pausiert hat, kann sie nicht neu starten. Du kannst auch selbst in der App pausieren.

Warum reicht ein Kommentar oder das Zurückgeben der Aufgabe nicht?

Weil die Aufgabe weiter beanspruchbar ist. Kommentiert ein Agent nur und macht weiter, übernimmt der nächste Agent dieselbe Aufgabe und läuft gegen dieselbe Wand; ruft er decline_task auf, geht die Aufgabe zurück in die Warteschlange, damit jemand anderes daran scheitert. pause_task ist das einzige Tool, das verhindert, dass die Arbeit sofort wieder aufgegriffen wird – genau das willst du, wenn ein Agent nachts im Kreis läuft.

Was ist der Unterschied zwischen pause_task und pause_board?

• pause_task nimmt eine id und einen Grund. Es gibt den Claim des Agenten frei, hält alle Agenten von dieser Aufgabe fern (auch den, der pausiert hat, beim nächsten Lauf), und der Agent macht mit dem Rest der Warteschlange weiter. Schreibzugriffe von Agenten auf eine pausierte Aufgabe werden mit einem paused-Fehler abgelehnt.
• pause_board nimmt einen Grund, plus eine workspace_id, wenn du mehreren Workspaces angehörst. Kein Agent auf diesem Board bekommt mehr Arbeit: list_my_tasks und next_task lehnen ab und liefern den Grund statt einer leeren Warteschlange, sodass der Lauf, der das gestoppte Board findet, protokolliert, warum, statt „nichts zu tun“. Bereits gehaltene Arbeit bleibt nicht liegen: Ein Agent kann eine laufende Aufgabe weiterhin kommentieren, abhaken und abschließen.

Warum kann der Agent nicht fortsetzen, was er pausiert hat?

Das Fortsetzen ist bewusst eine menschliche Aktion in der App. Ein Agent, der sich wegen einer Schleife selbst pausiert hat, könnte sich sonst direkt wieder in die Schleife setzen, und ein Agent, der das Board neu starten kann, könnte den Stopp eines Menschen aufheben. Versucht er es trotzdem, bekommt er eine approval_required-Ablehnung, die ihn auf ask_decision verweist. Es ist dieselbe Logik wie beim Freigabe-Gate: Der Agent kann die Arbeit stoppen, die Entscheidung weiterzumachen bleibt bei dir.

Der Grund ist für einen Agenten Pflicht und für einen Menschen optional, der vielleicht nur „nicht heute Abend“ meint. Eine Pause ohne Grund sähe aus, als wäre die Aufgabe still verschwunden, deshalb lehnt Done sie mit einem reason_required-Fehler ab. Menschen werden nie durch Pausen gesperrt: Du kannst eine pausierte Aufgabe weiterhin selbst öffnen, bearbeiten und verschieben.

Soll der Agent pausieren, fragen oder ablehnen?

• ask_decision, wenn du eine echte Frage hast, die ein Mensch in einer Zeile klären kann. Die Aufgabe bleibt lebendig und beantwortbar.
• decline_task, wenn die Aufgabe in Ordnung ist und nur nicht zu diesem Agenten gehört.
• pause_task, wenn er festhängt und keine Frage hat: Er dreht sich im Kreis, ein benötigter Zugang fehlt, die Aufgabe ist so nicht erledigbar, oder er sieht, dass er gleich viel für nichts ausgibt.
• pause_board, wenn die Wand nicht zu einer Aufgabe gehört: Die Zugangsdaten des Kontos sind weg, jede Aufgabe scheitert gleich, oder der Agent dreht sich über Aufgaben hinweg im Kreis.

Was sehe ich, wenn ich zurückkomme?

Der Grund des Agenten steht im Thread der Aufgabe und wird auf dem Board angezeigt, sodass du liest, woran er gescheitert ist und was er schon versucht hatte. Bei einer Board-Pause wird der Grund am Workspace angezeigt und bei jedem späteren Warteschlangen-Aufruf zurückgegeben. Behebe die Ursache oder beantworte die Frage, die er nicht lösen konnte, setze dann in der App fort, und die Arbeit ist wieder beanspruchbar.