Skip to content

MCP-Tools: Geplante Aufgaben ​

Zeitgesteuerte Erinnerungen und autonome KI-Läufe. Fachlich dasselbe wie der Bereich Zeitplan im Client (siehe Handbuch).

schedule_task ​

Plant eine Aufgabe – einmalig oder wiederkehrend. write · user

Der einzige Scheduler für Liza: nur er ist mit Kalender, Items, Benachrichtigungen und autonomen KI-Läufen verdrahtet.

ParameterTypBeschreibung
titlestring (erforderlich)Kurzer Titel
action_typeenum reminder | ai_task (erforderlich)Was feuert: Benachrichtigung oder autonomer KI-Lauf
atstring (ISO)Einmalig: Feuerzeitpunkt. Wiederkehrend: der Anker — Startdatum und Tageszeit jeder Wiederholung. Ohne at beginnt eine Wiederholung ab jetzt
rrulestringiCal-RRULE, z. B. FREQ=WEEKLY;BYDAY=MO,WE,FR — erlaubte Teile unter Wiederholungen. Fehlt sie → einmalig
timezonestringIANA-Zeitzone, z. B. Europe/Berlin. Wiederholungen ab täglich behalten Datum und Uhrzeit des Ankers in dieser Zone (Wanduhr): 09:00 bleibt über die Zeitumstellung 09:00. Fehlt sie oder ist sie ungültig, rechnet der Server in UTC
max_runsinteger > 0Nach so vielen Läufen stoppen (nur wiederkehrend). Der Weg, eine Serie nach Anzahl zu begrenzen — COUNT in der RRULE wird nicht ausgewertet

Mindestens at oder rrule angeben. Mit beiden ist at der Anker der Wiederholung.

Nur reminder:

ParameterTypBeschreibung
messagestring (erforderlich)Text der Benachrichtigung
recipientsstring[]User-IDs (Default: du selbst)
list / list_itemstringBezug für den Deep-Link
post_to_item_chatbooleanZusätzlich dauerhaft in den Chat des Items posten (nur mit list_item)
create_eventobjectZusätzlich einen Liza-Kalendertermin anlegen: title, start, end, duration_minutes (Default 30), all_day, location, description, calendar

Erinnerung an eine erledigte Aufgabe fällt weg

Hängt eine Erinnerung über list_item an einer Aufgabe, prüft der Server die Aufgabe vor dem Feuern. Ist sie erledigt (done, completed, closed), archiviert, im Papierkorb oder gelöscht, wird die Erinnerung abgesagt statt verschickt: Status canceled, und auch eine wiederkehrende Erinnerung endet damit. Lässt sich die Aufgabe gerade nicht lesen, wird wie gewohnt erinnert.

Nur ai_task:

ParameterTypBeschreibung
promptstring (erforderlich)Was die KI tun soll
providerstringKI-Anbieter (Default: x-liza-provider bzw. der letzte für diesen Scope)
modelstringModell-Override
scope / scope_idstringScope-Typ (z. B. item) und UUID
scope_keystringIdentifiziert die KI-Konversation. Fehlt er, wird die aktuelle Konversation genutzt (Header x-liza-conversation)
json
{"name":"schedule_task",
 "arguments":{"title":"Wochenbericht","action_type":"reminder",
              "rrule":"FREQ=WEEKLY;BYDAY=MO","at":"2026-09-01T07:00:00Z",
              "message":"Wochenbericht schreiben",
              "create_event":{"duration_minutes":30}}}

Wiederholungen ​

rrule versteht einen Ausschnitt von iCal (RFC 5545). Der Server prüft streng: ein Teil, den er nicht kennt, wird abgewiesen statt still ignoriert.

TeilWerteHinweis
FREQMINUTELY, HOURLY, DAILY, WEEKLY, MONTHLY, YEARLYPflicht
INTERVALpositive GanzzahlDefault 1
BYDAYMO … SU, kommagetrenntnur mit FREQ=WEEKLY; ohne Ordinalzahlen (1MO, -1FR werden abgewiesen)
UNTIL20261231T235959Z, 20261231T235959, 20261231 oder ISO 8601Serienende, inklusiv. Ohne Z bzw. Offset gilt die Zeitzone der Aufgabe; ein reines Datum schließt den ganzen Tag ein
WKSTMO … SUWochenbeginn für INTERVAL mit BYDAY (Default MO)
COUNTpositive Ganzzahlwird angenommen, aber nicht ausgewertet — die Serie läuft weiter. Zum Begrenzen max_runs setzen

Alles andere (BYHOUR, BYMINUTE, BYMONTHDAY, …) wird abgewiesen; die Tageszeit kommt aus at. Ein ai_task läuft höchstens alle 15 Minuten.

So rechnet der Server:

  • Wanduhr: DAILY und gröber rechnen in der Zeitzone aus timezone. Gibt es die Uhrzeit an einem Tag nicht (Frühjahr, 02:30), wird sie um die Lücke nach vorn geschoben (03:30); gibt es sie doppelt (Herbst), gilt das erste Auftreten. Ein Termin fällt dadurch nie aus. MINUTELY und HOURLY laufen in festen Abständen echter Zeit.
  • Monate und Jahre zählen immer vom Anker: 31.01. → 28./29.02. → 31.03. → 30.04.; der 29.02. jährlich wird in Nicht-Schaltjahren zum 28.02.
  • Wochen mit INTERVAL und BYDAY zählen ab WKST, nicht ab dem Anker: die Woche des Ankers ist Woche 0. Alle 2 Wochen Mo/Mi mit Anker Mi 04.11.2026 ergibt Mi 04.11., Mo 16.11., Mi 18.11. — nicht Mo 09.11.

list_scheduled_tasks ​

Deine geplanten Aufgaben, nächster Lauf zuerst. read · follower

ParameterTypDefaultBeschreibung
statusenum active | paused | done | error | canceled | allactiveFilter
limitnumber50Anzahl

Pro Aufgabe: id, sid, title, action_type, schedule_kind (once/rrule), run_at, rrule, timezone, next_run, last_run, status, run_count, max_runs, payload, last_error.

update_scheduled_task ​

Umbenennen, umplanen oder Effekt-Felder ändern. write · user

ParameterTypBeschreibung
taskIdstring (erforderlich)UUID oder SID
titlestringNeuer Titel
atstring (ISO)Neuer Zeitpunkt / Anker
rrulestringNeue RRULE — leerer String macht die Aufgabe einmalig
timezonestringNeue Zeitzone (Wanduhr wie bei schedule_task)
max_runsinteger | nullLimit setzen/entfernen
message / recipientsstring / string[]nur reminder
prompt / provider / modelstringnur ai_task

Angegebene Felder werden in die bestehende Aufgabe gemergt.

pause_scheduled_task ​

Pausieren oder fortsetzen. write · user

ParameterTypDefaultBeschreibung
taskIdstring (erforderlich)–UUID oder SID
resumebooleanfalsetrue = pausierte Aufgabe wieder aktivieren

cancel_scheduled_task ​

Endgültig absagen — die Aufgabe feuert nie wieder. destructive · user

ParameterTypBeschreibung
taskIdstring (erforderlich)UUID oder SID