Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI KI-Handler einrichten


Agent Mode

Technischer Name: agorum_ai_agents_agent_mode

Anzeigename: Agent Mode: Switch preset into agent mode

Was macht der Handler?

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

Technisch stellt der Handler interne Tools bereit und verwaltet den Agent-Mode-Status. Zusätzlich setzt er – abhängig vom Agent-Mode – den Parameter tool_choice.

Funktionsweise

  1. 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).
  2. „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.
  3. „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.
  4. 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).
  5. 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.

Empfohlener Einsatzzweck

Einstellungen

Dieser Handler hat keine eigenen konfigurierbaren Einstellungen.

Verwendung in KI-Voreinstellungen

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.