Hermes Agent Sitzungslebenszyklus und geplante Aufgaben

Richtlinie zum Zurücksetzen der Sitzung

Die Reset-Richtlinie steuert, wann eine Sitzung automatisch "das Gedächtnis verliert" — sie erhält eine neue session_id und der alte Kontext wird archiviert.

Eine sinnvolle Konfiguration der Reset-Richtlinie verhindert, dass der Agent-Kontext unbegrenzt wächst, während sichergestellt wird, dass die Benutzererfahrung nicht beeinträchtigt wird.

Vier Reset-Modi

ModeVerhaltenAnwendbare Szenarien
noneKein automatischer Reset; der Kontext wird ausschließlich durch den Komprimierungsmechanismus verwaltet.Szenarien, die einen lang andauernden kontinuierlichen Kontext erfordern
idleAutomatisch zurücksetzen nach mehr als N Minuten InaktivitätGelegentlich genutzte Agenten
täglichTäglich zu einer festgelegten Zeit automatisch zurücksetzenFür tägliche Routineaufgaben verwendete Agenten
bothInaktivitäts-Timeout oder täglicher Reset – je nachdem, was zuerst ausgelöst wird, greift.Die meisten Szenarien (Standard empfohlen)

Reset-Richtlinie konfigurieren

Beispiel

# config.yaml - globale Reset-Richtlinie
session_reset
:
  mode
: both              # none | idle | daily | both
  at_hour
: 4              # Tägliche Reset-Zeit (4 Uhr, lokale Zeit)
  idle_minutes
: 1440      # Inaktivitäts-Timeout (1440 Minuten = 24 Stunden)
  notify
: true            # Benutzer bei Reset benachrichtigen

# Reset-Richtlinie pro Plattform anpassen
platforms
:
  telegram
:
    session_reset
:
      mode
: idle
      idle_minutes
: 720   # Telegram-Sitzung wird nach 12 Stunden Inaktivität zurückgesetzt
  slack
:
    session_reset
:
      mode
: none          # Slack-Unterhaltungen werden nie automatisch zurückgesetzt

Auswirkung eines Resets

Wenn eine Sitzung einen Reset auslöst, geschieht Folgendes:

  • Alte Sitzungen werden in SQLite als beendet markiert (Grund: "session_reset")
  • Eine neue session_id wird generiert (Format: YYYYMMDD_HHMMSS_8-stelliger zufälliger Hex-Wert)
  • Das was_auto_reset der neuen SessionEntry wird auf true gesetzt
  • Zwischengespeicherte Agent-Instanzen werden bereinigt
  • Der Benutzer sieht in der nächsten Nachricht den Hinweis "Sitzung wurde zurückgesetzt"

Sitzungen mit aktiven Hintergrundprozessen werden niemals zurückgesetzt. Hermes prüft den has_active_processes-Callback, um sicherzustellen, dass laufende Aufgaben nie unterbrochen werden.


Wiederherstellungsmechanismus nach Neustart

Der Wiederherstellungsmechanismus nach Neustart des Hermes Gateway stellt sicher, dass laufende Sitzungen nach einem unerwarteten Absturz oder einem geplanten Neustart nicht verloren gehen.

Zwei Wiederherstellungsmarker

BezeichnungAuslöseszenarioVerhaltenSchweregradstufe
resume_pendingAbsturzwiederherstellung, Drain-Timeoutsession_id beibehalten und das Gespräch beim nächsten Besuch fortsetzen.sanfte Wiederherstellung
suspended/stop-Befehl oder 3 aufeinanderfolgende Neustartfehler.Erzwungenes Zurücksetzen, neue session_id generieren.harter Reset

Wiederherstellungsprozess beim Start

Wenn das Gateway startet, läuft der Wiederherstellungsprozess wie folgt ab:

Schritt 1: Den .clean_shutdown-Marker prüfen.

Wenn er vorhanden ist, war das vorherige Herunterfahren sauber, sodass der Wiederherstellungsprozess übersprungen wird.

Schritt 2: Wenn der Marker .clean_shutdown nicht existiert, war die vorherige Beendigung abnormal.

Gateway ruft suspend_recently_active() auf und markiert Sitzungen, die innerhalb der letzten 120 Sekunden aktiv waren, als resume_pending.

Schritt 3: Festgefahrene Schleife (Endlosschleife) erkennen.

Wenn eine Sitzung nach 3 aufeinanderfolgenden Neustarts noch aktiv ist, hängt sie möglicherweise in einer Endlosschleife fest; das Gateway markiert sie als suspended.

Schritt 4: Ausstehende Sitzungen wieder aufnehmen.

Gateway erzeugt ein MessageEvent für jede resume_pending-Sitzung und veranlasst den Agenten, automatisch fortzufahren.

Drain-Timeout-Marker

Während eines sauberen Herunterfahrens/Neustarts markiert das Gateway eine Sitzung, die gerade verarbeitet wird, aber die Drain-Wartezeit überschreitet, als resume_pending.

Gründe für die Markierung in verschiedenen Szenarien:

MarkierungsgrundBedeutung
restart_timeoutDrain-Timeout beim Neustart
shutdown_timeoutDrain-Timeout beim Herunterfahren
restart_interruptedCrash-Wiederherstellung (ausgelöst von suspend_recently_active)

Der resume_pending-Marker wird bei get_or_create_session() nicht gelöscht – erst nach der nächsten erfolgreichen Agent-Antwort. Wenn die wiederhergestellte Sitzung erneut unterbrochen wird, bleibt der Marker erhalten, was einen erneuten Versuch beim nächsten Neustart ermöglicht. Nach 3 aufeinanderfolgenden Fehlern wird sie in den Zustand suspended versetzt.


Nachrichtenwarteschlangen-Mechanismus

Wenn ein Benutzer mehrere Nachrichten hintereinander sendet, während eine Nachricht verarbeitet wird, stellt der Nachrichtenwarteschlangen-Mechanismus des Gateways sicher, dass Nachrichten nicht verloren gehen.

Warteschlangenstruktur

Das Gateway verwendet ein zweistufiges Warteschlangendesign:

  • Einzel-Slot ausstehend (_messages): Jede Sitzung hat nur einen "next"-Slot; wiederholte Sendevorgänge überschreiben ihn.
  • Überlaufwarteschlange (_queued_events): Wenn der Slot belegt ist, werden nachfolgende Nachrichten an das Ende der Überlaufwarteschlange angehängt.

/queue-Befehl

Der /queue-Befehl ermöglicht es dir, Aufgaben in Stapeln einzureichen, und jede Aufgabe erzeugt einen vollständigen Agent-Turn.

Beispiel

# In Telegram/Discord senden
/queue überprüfe den Codestil von src/main.py
/queue as src/Schreibe Unit-Tests für utils.py
/queue aktualisiere die Installationsanweisungen in README.md

Jede Aufgabe in der Warteschlange wird in FIFO-Reihenfolge ausgeführt, wobei jede Aufgabe einen vollständigen Agent-Turn erzeugt; sie werden nicht zusammengeführt.

Verwende den /new- oder /reset-Befehl, um die Nachrichtenwarteschlange der aktuellen Sitzung zu leeren.

Wenn du mehrere Nachrichten hintereinander sendest, während der Agent beschäftigt ist, werden die dazwischenliegenden überschrieben (nur die letzte wird beibehalten); Nachrichten im /queue-Befehl werden nicht überschrieben — jede /queue-Aufgabe wird der Reihe nach ausgeführt.


Geplante Aufgaben (Cron)

Hermes bietet erstklassige Unterstützung für geplante Aufgaben, sodass du den Agenten so konfigurieren kannst, dass er bestimmte Aufgaben regelmäßig ausführt.

Geplante Aufgaben können an einen Skill gebunden werden und die Ergebnisse an eine angegebene Plattform liefern.

Geplante Aufgaben konfigurieren

Geplante Aufgaben werden in jobs.json definiert und unterstützen mehrere Zeitplanformate.

{
  "jobs": [
    {
      "id": "daily-news-summary",
      "schedule": "0 8 * * *",
      "description": "每天早上 8 点抓取 AI 行业新闻并生成摘要",
      "skill": "ai-news-summarizer",
      "deliver_to": {
        "platform": "telegram",
        "chat_id": "-1001234567890"
      }
    },
    {
      "id": "weekly-code-review",
      "schedule": "0 10 * * 1",
      "description": "每周一早上 10 点审查项目代码变更",
      "skill": "code-review-assistant",
      "deliver_to": {
        "platform": "discord",
        "chat_id": "123456789"
      }
    },
    {
      "id": "health-check",
      "schedule": "*/30 * * * *",
      "description": "每 30 分钟检查服务器健康状态",
      "skill": "server-health-checker",
      "deliver_to": {
        "platform": "telegram",
        "chat_id": "123456789"
      }
    }
  ]
}

Unterstützte Zeitplanformate

FormatierungBeispielBeschreibung
Cron-Ausdruck0 8 * * *Standard-Cron-Ausdruck mit 5 Feldern
Intervall30mAlle 30 Minuten
Relative Zeit+90sEinmal nach 90 Sekunden ausführen
Wiederholungsanzahlrepeat.times: 5Nach 5 Ausführungen automatisch beenden

Kann in der Desktop-Version konfiguriert werden; klicken Sie unten links auf "Schedule":

Klicken Sie auf "Create Scheduled Task":

Aufgabe erstellen:

Nachdem eine geplante Aufgabe an einen Skill gebunden wurde, wird die Ausgabe automatisch gemäß dem im Skill definierten Ausgabeformat formatiert. Dadurch wird sichergestellt, dass die Darstellung konsistent und lesbar ist, wenn Ergebnisse geplanter Aufgaben an eine Messaging-Plattform übermittelt werden.


Chronos-verwalteter Cron (Erweitert)

Chronos ist Hermes’ verwaltete Lösung für geplante Aufgaben, die speziell für Scale-to-Zero-Bereitstellungsmodelle konzipiert wurde.

Wenn Ihr Gateway im Leerlauf vollständig gestoppt ist, kann Chronos dennoch sicherstellen, dass geplante Aufgaben rechtzeitig ausgelöst werden.

Warum wird Chronos benötigt?

Der integrierte Cron-Ticker erfordert, dass der Gateway-Prozess kontinuierlich läuft – wenn das Gateway auf null herunterskaliert wird, werden geplante Aufgaben nicht ausgelöst.

Chronos delegiert die Verwaltung geplanter Aufgaben an NAS (Nous Account Service), der das Gateway über einen externen Scheduler aufweckt, wenn eine Aufgabe ausgelöst wird.

Chronos-Workflow

Chronos’ Workflow ist in vier Schritte unterteilt:

Schritt 1: Der Agent berechnet die nächste Auslösezeit und registriert einen One-Shot-Timer bei NAS.

Schritt 2: NAS verwendet einen externen Scheduler (z. B. die geplanten Trigger von Fly Machines), um zur angegebenen Zeit einen Callback auszulösen.

Schritt 3: Der externe Scheduler ruft über einen Callback NAS auf, und NAS generiert ein kurzlebiges JWT-Token.

Schritt 4: NAS ruft den /api/cron/fire-Endpunkt des Agenten mithilfe eines JWT-Tokens auf. Der Agent verifiziert es, führt die Aufgabe aus und registriert den nächsten One-Shot-Timer erneut.

At-most-once-Garantie

Chronos verwendet CAS-Operationen (Compare-And-Set) auf Store-Ebene, um sicherzustellen, dass jede geplante Aufgabe nur einmal ausgeführt wird.

Selbst wenn der Scheduler aufgrund von Netzwerk-Wiederholungsversuchen doppelte Auslöseanfragen sendet, kann der Agent über CAS deduplizieren, wodurch sichergestellt wird, dass Aufgaben nicht wiederholt ausgeführt werden.

Chronos konfigurieren

Beispiel

# config.yaml - Von Chronos verwaltete Cron-Konfiguration
cron
:
  provider
: "chronos"                         # Chronos anstelle des eingebauten Tickers verwenden
  chronos
:
    portal_url
: "https://portal.nousresearch.com"
    callback_url
: "https://my-agent.fly.dev"  # Öffentlich erreichbare URL des Agenten
    expected_audience
: "agent:inst_abc123"    # Audience für JWT-Validierung
    nas_jwks_url
: "https://portal.nousresearch.com/.well-known/jwks.json"

Chronos ist die empfohlene Planungslösung für verwaltete Hermes-Bereitstellungen. Wenn Sie eine selbstgehostete Bereitstellung verwenden und Ihr Gateway niemals auf null herunterskaliert, ist der integrierte Cron-Ticker vollkommen ausreichend. Wenn callback_url leer ist oder der Agent keinen Nous-Login hat, fällt das System automatisch auf den integrierten Ticker zurück.

Weitere Erweiterungen