AI Task Scheduler — Benutzerhandbuch | YoBench

Was das Modul „AI Task Scheduler" leistet

Der AI Task Scheduler führt den KI-Assistenten nach Zeitplan aus. Sie definieren einen Prompt, wählen Anbieter und Kontext, hängen optional ein Toolset an und legen fest, wann der Lauf startet — minütlich, stündlich, täglich, wöchentlich oder monatlich. Der Assistent arbeitet autonom; baut er einen Plan, der als gefährlich markiert ist, hält der Lauf inne und fragt mit klarem Approve / Deny nach, statt zu scheitern.

Was Sie bekommen:

• Cron-gesteuerte KI-Läufe — fünf Schedule-Typen (Minute, Stunde, Tag, Woche, Monat).
• Manuelle Läufe auf Abruf — Run Now an jedem Task.
• Isolation pro Task — jeder Task wählt eigenen Anbieter, Kontext, System-Prompt, Temperature, Max-Iterationen und erlaubte Tools.
• Approval-Flow — gefährliche Pläne werden als pending_approval festgehalten, sodass Sie sie vor dem Weiterlauf prüfen können.
• Live-Timeline — Nachrichten und Tool-Ergebnisse in Echtzeit, während der Lauf läuft.
• Lauf-Historie mit Status, Trigger-Typ, Dauer, Tokens und Kosten.
• Scope-gebundener Abbruch — jeder Lauf hat einen eindeutigen Scope-Key; lange laufende Tools werden beim Abbruch sauber aufgeräumt.

Begriffe

Schedule-Typen

Schedules werden als schedule_type plus Hilfsfelder gespeichert und bei Bedarf in einen Cron-Ausdruck übersetzt.

Manuelle Trigger (Run Now) ignorieren den Zeitplan.

Tool-Steuerung

Jeder Task kann auf eine von drei Arten laufen:

• mit allen Tools verfügbar (Legacy / neue Tasks, bei denen tools_enabled an ist und die Tool-Liste leer/null bleibt),
• mit einer Whitelist — Sie wählen genau die Tool-IDs, die der Assistent verwenden darf (Web-Suche, Browser-Automatisierung, Terminal, Dateisystem, Dokument-Tools usw.),
• oder mit deaktivierten Tools — der Assistent hat nur seinen Prompt und seinen Kontext.

Das ist der wichtigste Hebel für einen sicheren geplanten Task: ein täglicher Report-Task braucht vermutlich keinen Terminal-Zugriff; ein Code-Review-Task möchte vielleicht nur web und browser.

Approval-Flow

Die Pipeline läuft im autonomen Modus — jeder Plan, der nicht als gefährlich markiert ist, wird ohne Rückfrage ausgeführt. Wenn der Assistent einen Plan mit requiresConfirmation = true erzeugt:

1. Der Lauf wechselt in den Status pending_approval.
2. Der Plan wird persistiert; der Lauf pausiert.
3. Die UI zeigt den Plan mit zwei Buttons: Approve und Deny.
4. Approve — die Pipeline läuft am gespeicherten Punkt weiter.
5. Deny — der Lauf endet mit Status cancelled und Begründung „Rejected by user".

Pending Approvals erscheinen sowohl in der Lauf-Ansicht als auch in einer eigenen Pending Approvals-Liste oben auf der Seite, damit nichts verlorengeht.

Lebenszyklus eines Laufs

schedule fires (oder Run Now)
        │
        ▼
   run anlegen
   status = running
        │
        ▼
  ─── Nachrichten streamen in die Timeline ───
        │
        ├─ done            → status = done
        ├─ error           → status = error  (Fehlermeldung gespeichert)
        ├─ user cancels    → status = cancelled
        └─ dangerous plan  → status = pending_approval
                                  │
                                  ├─ approve → status = running → läuft weiter
                                  └─ deny    → status = cancelled

Jeder Lauf erfasst: Trigger, Start-/Endzeit, Dauer, Token-Verbrauch, Dollar-Kosten, Fehlermeldung (falls vorhanden) und das vollständige Nachrichten-Log.

Einstellungen

Ein Task wird über Scheduler → Create angelegt; das Formular gleitet als Drawer ein. Felder:

• Title — Anzeigename.
• Prompt — die Hauptanweisung, die der Assistent bei jedem Tick ausführt.
• System Prompt — optionale dauerhafte Rolle / Verhaltensvorgabe. Standard: leer.
• Provider — der für den Lauf verwendete KI-Anbieter.
• Context — optionaler RAG-Kontext, der in den Lauf eingespeist wird.
• Temperature — 0,0 – 1,0, Standard 0,3.
• Max auto-iterations — Obergrenze für Tool-Use-Runden in einem Lauf, Standard 5.
• Schedule type + die passenden Felder für Uhrzeit / Wochentag / Tag.
• Is active — schaltet den Schedule auf Pause, ohne den Task zu löschen.
• Tools enabled — globaler An/Aus-Schalter für das Toolset.
• Allowed tools — Mehrfachauswahl, wirkt, wenn Tools aktiviert sind.

Das Formular kann den Task auch als Entwurf speichern, ohne ihn zu aktivieren.

Ablauf

1. Geplanten Task anlegen

1. Scheduler in der Seitenleiste öffnen.
2. Create klicken → der Task-Drawer öffnet sich.
3. Title und Prompt eintragen, einen Provider wählen.
4. (Optional) Kontext anhängen, System-Prompt schärfen, Temperature absenken.
5. Schedule-Typ und Uhrzeit wählen.
6. Tool-Policy festlegen: aktiviert + Whitelist, aktiviert + offen, oder deaktiviert.
7. Is active einschalten und speichern.

2. Auf Abruf ausführen

• Task öffnen → Run Now → der Lauf erscheint sofort in der Timeline.
• Nachrichten und Tool-Ergebnisse live verfolgen, während sie eintreffen.
• Jederzeit mit Stop abbrechen — der Scope wird aufgehoben, lange laufende Tools sauber beendet.

3. Pending Approval bearbeiten

1. Entweder wird das Run-Badge gelb (pending), oder die Liste Pending Approvals zeigt einen neuen Eintrag.
2. Den Lauf öffnen → den vorgeschlagenen Plan prüfen.
3. Approve — der Lauf nimmt seine Arbeit wieder auf. Deny — der Lauf wird abgebrochen.

4. Historie ansehen

• Die Task-Ansicht listet jeden Lauf mit Status, Trigger, Dauer, Token-Verbrauch und Kosten.
• Klick auf einen Lauf öffnet das vollständige Nachrichten-Log und alle Tool-Outputs.
• Fehler enthalten die vollständige Fehlermeldung; bei Abbrüchen ist vermerkt, wer / was abgebrochen hat.

Hinweise und Einschränkungen

• Nutzen Sie manuelle Läufe, um einen Prompt zu testen, bevor Sie den Schedule scharfschalten.
• Halten Sie den System-Prompt task-spezifisch — die globale Persona gehört in die AI-Chat-Einstellungen.
• Die Werte für Tokens / Kosten stammen aus der Anbieter-Antwort; bei lokal gehosteten Modellen werden Kosten mit null ausgewiesen.
• Der Scheduler läuft innerhalb der Desktop-App — wenn YoBench geschlossen ist, feuert der Cron nicht. Planen Sie das ein oder lassen Sie die App im Tray laufen.
• Setzen Sie Max auto-iterations anfangs konservativ; erhöhen Sie den Wert, wenn Sie dem Prompt vertrauen.

Nächste Schritte

• Verbinden Sie einen KI-Anbieter und mindestens einen Kontext.
• Kombinieren Sie einen geplanten Task mit dem DB Manager — etwa einen nächtlichen Lauf, der Slow-Query-Logs zusammenfasst.
• Für periodische nicht-KI-Arbeit (reines Cron + Skripte) nutzen Sie die eingebetteten DB-Tasks oder das Modul Szenarien.

Hilfe und Feedback

Bug gefunden oder einen neuen Schedule-Typ vorzuschlagen? Schreiben Sie uns über das Feedback-Formular.