Blog · Anleitung · 28. Oktober 2026

Wie ein Orchestrator einen Freigabeschritt bekommt: ein Muster, mit AEGIS als durchgearbeitetem Beispiel

Auch auf: English, Español, Português, 日本語, Français · Alle Anleitungen auf Deutsch

Offenlegung: 100monkeys.ai entwickelt AEGIS, das durchgearbeitete Beispiel dieser Anleitung; lesen Sie die Teile über AEGIS also als Bericht des Herstellers. Das Muster selbst ist allgemein und gilt für jeden Orchestrator. Einer unserer KI-Agenten hat diese Anleitung aus der öffentlichen AEGIS-Dokumentation entworfen, das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung.

Ein Freigabeschritt ist eine Stelle in einem automatisierten Lauf, an der die Arbeit anhält, eine Person genau liest, was gleich geschehen wird, und der Lauf erst auf ihre Antwort hin weitergeht. Fast jeder Orchestrator kann pausieren. Weniger sorgen dafür, dass die Pause hält. Dies ist das Muster, das wir verwenden, Schritt für Schritt, mit AEGIS by 100monkeys.ai, in beta, als durchgearbeitetem Beispiel.

Das Muster in einem Absatz

Setzen Sie das Gate, nachdem der Agent die Handlung vorbereitet hat und bevor sie geschieht. Zeigen Sie den Prüfenden das Vorbereitete selbst, keine Zusammenfassung. Legen Sie vorab fest, was Schweigen bedeutet. Leiten Sie beide Antworten ausdrücklich weiter. Lassen Sie Prüfende von dort antworten, wo sie ohnehin sind, und bewahren Sie die Antwort in der Geschichte des Laufs auf. Begrenzen Sie die Wiederholungen, damit ein abgelehnter Entwurf nicht endlos kreist.

Schritt 1. Die Handlungen auflisten, die eine Person brauchen

Nicht jeder Schritt braucht ein Gate; ein Gate überall bringt Menschen bei, ungelesen durchzuklicken. Setzen Sie Gates vor Handlungen, die die Sandbox verlassen und sich nicht zurücknehmen lassen: eine Nachricht an jemanden draußen senden, in einen geschützten Branch mergen, Geld ausgeben, Daten löschen, veröffentlichen. Alles andere kann unter einer vorab geschriebenen Richtlinie laufen. Unser Papier Red levers (auf Englisch) nennt das die zwei Arten von Halt: Grenzen, die vor dem Lauf gesetzt und von der Laufzeit durchgesetzt werden, und eine Freigabe an der Handlung, die an genau eine Handlung gebunden ist.

Schritt 2. Die Arbeit des Agenten an der Handlung teilen

Ein Agent, der in einem Schritt entwirft und sendet, lässt sich in der Mitte nicht aufhalten. Teilen Sie ihn in einen Zustand, der vorbereitet, und einen, der handelt, damit das Gate einen Platz hat. In AEGIS ist ein Workflow eine deklarative Zustandsmaschine, und das Gate ist ein eigener Zustand, kind: Human:

spec:
  initial_state: DRAFT
  states:
    DRAFT:
      kind: Agent
      agent: draft-agent
      transitions:
        - condition: on_success
          target: APPROVE
    APPROVE:
      kind: Human
      prompt: |
        About to send:
        {{DRAFT.output}}

        Approve? (yes/no)
      timeout: 86400s
      transitions:
        - condition: input_equals_yes
          target: SEND
        - condition: input_equals_no
          target: DISCARD

Die Form folgt der Seite Building Workflows der AEGIS-Dokumentation; draft-agent, SEND und DISCARD stehen für Ihren eigenen Agenten und Ihre eigenen Zustände.

Schritt 3. Prüfenden genau das vorlegen, was passieren wird

Der Prompt ist alles, was Prüfende sehen, also rendern Sie die vorbereitete Ausgabe hinein. AEGIS-Prompts nehmen Blackboard-Vorlagen: {{DRAFT.output}} oben ist die Ausgabe des vorherigen Zustands, und die Dokumentation zeigt auch Bewertungen früherer Zustände, etwa {{QUALITY_CHECK.output.score}}. Wer „der Agent möchte eine E-Mail senden“ sieht, gibt eine Beschreibung frei; wer die E-Mail sieht, gibt die E-Mail frei.

Schritt 4. Festlegen, was Schweigen bedeutet

Jedes Gate braucht ein Timeout und eine Regel für den Fall, dass es abläuft. Auf der Seite Human Approvals ist timeout_seconds standardmäßig 3600. Mit reject_on_timeout: false, dem Standard, lässt ein unbeantwortetes Gate den Lauf mit human_input_timeout scheitern. Mit reject_on_timeout: true gilt Schweigen als Nein, und der Lauf nimmt den Ablehnungsweg. Wählen Sie Letzteres, wenn eine fehlende Antwort ein sauberes Nein und kein Fehler sein soll. Machen Sie Schweigen nie zu einem Ja.

Ein Hinweis zu den Feldern: Die Seite Human Approvals verwendet timeout_seconds und die Bedingungen approved und rejected; die Seite Building Workflows verwendet timeout sowie input_equals_yes und input_equals_no. Nutzen Sie durchgängig eine Form und prüfen Sie die Workflow Manifest Reference der Version, die Sie betreiben.

Schritt 5. Beide Antworten leiten und die Schleife begrenzen

Ein Nein ist eine Antwort, kein Fehler, den man später behandelt. Geben Sie ihm einen Zielzustand: verwerfen oder den Entwurf mit dem Feedback der prüfenden Person an den Agenten zurückgeben. Leiten Sie eine Ablehnung zurück zum Entwurfszustand, hat der Lauf jetzt eine Schleife. AEGIS begrenzt sie: max_state_visits je Zustand (Standard 5, Obergrenze 20) und max_total_transitions je Lauf (Standard 50, Obergrenze 100). Stellen Sie sie auf die Zahl der Versuche ein, die Prüfende hinnehmen.

Schritt 6. Prüfende dort antworten lassen, wo sie sind

Ein Gate, das niemand sieht, ist ein Timeout. In AEGIS lässt sich dasselbe Gate auf drei Wegen beantworten:

• Auf der Kommandozeile: aegis workflow signal <execution-id> --response yes.
• Aus Ihrem eigenen Client: wartende Gates mit GET /v1/workflow-gates?status=pending auflisten und eines mit POST /v1/workflows/executions/{id}/signal beantworten, mit einem Body wie { "response": "yes", "feedback": "Keep the flag name short." }.
• In Zaru Web: Ein Gate eines Laufs, den Sie gestartet haben, erscheint unter Ihren ausstehenden Freigaben, mit einer Schaltfläche je erlaubtem Wort. Die Dokumentation ergänzt, dass Zarus Begleiter in keinem Modus ein Werkzeug angeboten bekommt, das ein Gate beantwortet; das Modell, das die Handlung vorbereitet hat, kann sie also nicht freigeben.

Diese letzte Eigenschaft ist die, nach der man bei jedem Orchestrator suchen sollte: Der Agent darf nicht den Schlüssel zu seinem eigenen Gate halten.

Schritt 7. Die Antwort aufbewahren

Eine Freigabe ist ein Beleg. Nachdem ein Gate beantwortet wurde oder abgelaufen ist, führt AEGIS es weiter: ?status=answered liefert jedes Gate mit dem gewählten Wort, dem Feedback, dem Zeitpunkt des Abschlusses und dem, was der Lauf dann tat. Halten Sie auch fest, wer geantwortet hat; der Freigabe-Endpunkt auf der Seite Human Approvals nimmt ein Feld approved_by, und eine Ablehnung verlangt einen reason.

Schritt 8. Das Gate testen, bevor man ihm vertraut

Führen Sie den Workflow dreimal aus: mit Ja antworten, mit Nein antworten und ablaufen lassen. Prüfen Sie, dass jeder Weg dort ankommt, wo Sie wollten, und dass nichts nach dem Gate vor der Antwort lief. Ändern Sie dann den Entwurf, nachdem das Gate gestellt wurde, und prüfen Sie, dass Prüfende sehen, was wirklich ausgeführt wird. Bindet Ihr Orchestrator die Freigabe an eine Beschreibung statt an den Inhalt, merken Sie es hier.

Wie es weitergeht

Um das Muster auf einem eigenen Server von Anfang bis Ende auszuprobieren, folgen Sie AEGIS auf einem frischen Ubuntu-VPS installieren und die erste freigegebene Aufgabe ausführen. Was Sie rund um jedes Gate protokollieren und signieren sollten, steht in der Checkliste zur Nachvollziehbarkeit von KI-Agenten in Produktion. Dieselbe Freigabe-Idee in einem persönlichen Assistenten zeigt Einen Zaru-Assistenten einrichten, der E-Mail und Kalender mit Freigaben erledigt.

AEGIS von 100monkeys.ai installieren