KI-Handler Agent Mode

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Suite. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Hinweis: Der Handler ist nur verfügbar, wenn ALBERT | AI Agents verwendet wird.

Der Handler erweitert eine KI-Voreinstellung (Preset) um einen Agent Mode. Damit kann die KI kontrolliert zwischen „normalem Chat“ und einem „werkzeuggetriebenen Arbeitsmodus“ umschalten.

Eine allgemeine Beschreibung von KI-Handlern finden Sie unter ALBERT | AI KI-Handler einrichten.

Eigenschaft	Wert
Anzeigename in der Oberfläche	Agent Mode: Switch preset into agent mode
Technischer Handler-Name	`agorum.ai.agents.agent.mode` (Name der Konfiguration: `agorum_ai_agents_agent_mode`)
Standardmäßig aktiv	ja (nur verfügbar, wenn ALBERT \| AI Agents verwendet wird)
Eingriffspunkte (Hooks)	`before`, `after`

Wann verwenden

Für Presets, die mehrschrittige Aufgaben zuverlässig und reproduzierbar mit Tools abarbeiten sollen (z. B. Recherche + Auswertung + Schreiben + Ablage).
Wenn sichergestellt werden soll, dass die KI in einer bestimmten Phase nicht nur textuell antwortet, sondern aktiv Tools nutzt.
Als Standardbaustein für „Agenten“-Presets, bei denen der Benutzer Agent-Mode bewusst starten/stoppen können soll.

Funktionsweise

Der Handler agorum_ai_agents_agent_mode stellt technisch interne Tools bereit und verwaltet den Agent-Mode-Status. Zusätzlich setzt er, abhängig vom Agent-Mode, den Parameter tool_choice.

Der Handler bringt drei Schalter mit: Er macht für die KI drei Befehle verfügbar: start_agent_mode (einschalten), stop_agent_mode (ausschalten) und get_agent_mode (Status abfragen).
„Agent-Mode an“ bedeutet: die KI arbeitet tool-basiert: Sobald Agent-Mode aktiv ist, wird die KI so gesteuert, dass sie nicht nur antwortet, sondern in jeder Antwort mindestens ein Tool verwendet, um aktiv Aufgaben abzuarbeiten.
„Agent-Mode aus“ bedeutet: normaler Chat: Ist Agent-Mode deaktiviert, verhält sich die KI wieder wie gewohnt und kann auch ohne Tool-Aufruf antworten.
Der Status bleibt erhalten: Ob Agent-Mode gerade an oder aus ist, merkt sich das System während des Chats (damit die KI nicht bei jeder Nachricht „vergisst“, in welchem Modus sie ist).
Die Umschaltung passiert automatisch im Hintergrund: Wenn die KI einen dieser drei Befehle nutzt, erzeugt der Handler die passende Rückmeldung selbst (es muss dafür kein externes Tool „wirklich etwas ausführen“).

Hintergrund: Tool-Choice-Unterstützung (tool_choice)

tool_choice ist ein Parameter, der steuert, wie die KI mit verfügbaren Tools umgeht. Über diesen Handler wird tool_choice dynamisch gesetzt.

Wert	Bedeutung
`auto`	Die KI entscheidet selbst, ob sie Tools aufruft (Standard-Verhalten).
`required`	Die KI muss mindestens ein Tool aufrufen (wird bei aktivem Agent-Mode gesetzt).
`none`	Die KI darf keine Tools aufrufen.

Verhalten bei ausbleibendem Werkzeugaufruf

Ist der Agent-Mode aktiv und antwortet die KI dennoch mit reinem Text statt mit einem Werkzeugaufruf, wird sie vom Handler daran erinnert, dass sie im Agent-Mode entweder das nächste Werkzeug aufrufen oder den Modus ausdrücklich über stop_agent_mode beenden muss. Diese Erinnerung erfolgt intern über den bestehenden handlerLoop-Mechanismus (kein sichtbarer Chat-Eintrag) und höchstens zweimal. Reagiert die KI danach weiterhin nicht mit einem Werkzeugaufruf, wird der Agent-Mode automatisch beendet und dies im Chat-Verlauf vermerkt.

Einstellungen

Dieser Handler hat keine eigenen konfigurierbaren Einstellungen.

In einer KI-Voreinstellung verwenden

Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
Wählen Sie den KI-Handler Agent Mode: Switch preset into agent mode in der Liste aus.
Speichern Sie die KI-Voreinstellung.
Ergebnis: Die KI kann in Chats mit dieser KI-Voreinstellung kontrolliert zwischen normalem Chat und werkzeuggetriebenem Arbeitsmodus umschalten.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Keine Besonderheiten bekannt.
Geeignete Kombinationen	Der Handler kann mit anderen Handlern kombiniert werden, da er primär Schalter für die KI bereitstellt, Kontext ergänzt und `tool_choice` steuert.
Nicht kombinieren mit	Goal und Finish Check in derselben KI-Voreinstellung: Alle drei steuern die Wiederholung von Runden.