Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT | AI Suite > ALBERT | AI KI-Handler einrichten


KI-Handler Goal

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.

Der KI-Handler Goal hält das Sprachmodell bei der Arbeit, bis eine Aufgabe abgeschlossen ist. Ohne den Handler endet eine Antwort, sobald das Modell keinen Tool-Aufruf mehr schreibt, auch wenn die Aufgabe noch nicht erledigt ist. Mit dem Handler stellt ALBERT | AI dem Modell weitere Runden zur Verfügung, bis es die Aufgabe ausdrücklich abschließt oder eine Grenze erreicht ist.

Der Handler ist Teil des Plugins ALBERT | AI Agents und wird, wie alle KI-Handler, in KI-Voreinstellungen eingebunden. Eine allgemeine Beschreibung von KI-Handlern finden Sie unter ALBERT | AI KI-Handler einrichten.

Funktionsweise

  1. Jede Benutzernachricht öffnet ein Ziel. Schreiben Sie, während ein Ziel offen ist oder auf Ihre Eingabe wartet, eine weitere Nachricht, gilt sie als Ergänzung zum bestehenden Ziel.
  2. Antwortet das Modell ohne Tool-Aufruf, ist das Ziel noch offen. Der Handler sendet eine interne Rundennachricht und startet damit eine weitere Runde.
  3. Das Ziel endet erst, wenn eine dieser Bedingungen eintritt:
    • Das Modell schließt das Ziel mit dem Tool update_goal und dem Status complete ab.
    • Das Modell stellt über update_goal mit dem Status needs_user_input eine Rückfrage, weil nur Sie entscheiden können, wie es weitergeht.
    • Das Modell meldet über update_goal mit dem Status blocked eine Blockade.
    • Eine der beiden Rundengrenzen ist erreicht, siehe Rundengrenzen.

Das Tool update_goal und die Anweisungen dazu ergänzt der Handler selbst. Sie müssen den Handler nur einer KI-Voreinstellung zuweisen. Das Modell soll update_goal allein aufrufen, nicht zusammen mit anderen Tools. Ruft es das Tool zusammen mit anderen Tools auf, wird der Aufruf zurückgestellt: Das Modell wartet zuerst die Ergebnisse der anderen Tools ab und ruft update_goal danach noch einmal auf.

Handler einer KI-Voreinstellung zuweisen

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
  3. Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
  4. Wählen Sie den KI-Handler Goal in der Liste aus.
  5. Speichern Sie die KI-Voreinstellung.

    Ergebnis: Jede Benutzernachricht in einem Chat mit dieser KI-Voreinstellung wird zu einem Ziel.

Die Einstellungen des Handlers ändern Sie unter ☰ > Administration > Konfiguration > KI-Handler, siehe ALBERT | AI KI-Handler einrichten.

Einstellungen

Einstellung Standard Beschreibung
Maximale Runden ohne Fortschritt 5 Wie viele Runden in Folge ohne Fortschritt der Handler anstößt, bevor er das Ziel aufgibt. Eine Runde ohne Fortschritt ist eine Antwort ohne Tool-Aufruf oder ein abgelehnter Aufruf von update_goal. Jeder Aufruf eines anderen Tools setzt die Zählung zurück.
Maximale Runden insgesamt 50 Obergrenze für alle Runden zu einer Benutzernachricht, auch wenn dazwischen gearbeitet wurde. Die Einstellung begrenzt die Kosten.
Blockade angenommen ab Meldung 3 Die wievielte Meldung, dass das Ziel blockiert ist, angenommen wird. Die Meldungen davor lehnt der Handler ab, und das Modell soll einen anderen Weg versuchen. Tool-Aufrufe dazwischen setzen diese Zählung nicht zurück. Die Blockade wird deshalb bei der dritten Meldung angenommen, auch wenn das Modell zwischenzeitlich andere Wege versucht hat.
Tool-Aufruf in Runden erzwingen aus Sendet in jeder vom Handler ausgelösten Runde tool_choice mit dem Wert "required", sodass das Modell ein Tool aufrufen muss. Siehe Tool-Aufruf erzwingen.

Lassen Sie ein Zahlenfeld leer, gilt der Standardwert.

Rundengrenzen im Detail

Was das Modell sieht

Verlauf

Antworten ohne Tool-Aufruf und ältere Rundennachrichten werden dem Modell nicht mehr übergeben. Sonst hält es angekündigte Schritte („Ich schreibe jetzt den Test“) für erledigt und beendet die Arbeit zu früh. Stattdessen stützt sich das Modell auf die Ergebnisse der Tools und prüft den tatsächlichen Stand.

Im Chat bleiben alle Einträge sichtbar. Endet das Ziel, sieht das Modell seine letzte Antwort wieder, denn sie kann das Ergebnis selbst enthalten, zum Beispiel eine Tabelle oder eine Erklärung.

Rundennachricht und Abschluss

Die Rundennachricht nennt dem Modell das Ziel und die aktuelle Runde. Sie verlangt, update_goal mit dem Status complete aufzurufen, sobald das Ziel erreicht und wie in den Anweisungen der KI-Voreinstellung verlangt geprüft ist. Optionale Verbesserungen schließt sie aus. In den letzten fünf Runden vor Erreichen der Gesamtgrenze nennt sie die verbleibenden Runden und fordert das Modell auf, abzuschließen oder den Stand über needs_user_input zu melden.

Tool-Aufruf erzwingen

Standardmäßig setzt der Handler den Parameter tool_choice nicht. Er arbeitet so auch mit Modellen, die den Parameter ablehnen, etwa Qwen im Thinking-Modus.

Antwortet ein Modell in den Runden statt mit update_goal wieder nur mit Text, schalten Sie Tool-Aufruf in Runden erzwingen ein. Der Handler sendet dann in jeder von ihm ausgelösten Runde tool_choice: "required".

Hinweis: Schalten Sie die Einstellung nur ein, wenn der KI-Anbieter den Wert versteht. Gemessen wurde: Bei Mistral funktioniert es, bei Qwen über OpenRouter nicht (Fehler 400).

Abgrenzung zu anderen KI-Handlern

Verwenden Sie den Handler Goal nicht zusammen mit dem Handler Agent Mode oder dem Handler Finish Check in derselben KI-Voreinstellung. Alle drei steuern die Wiederholung von Runden und würden sich gegenseitig stören.

Handler Zweck
Goal Mehrere Runden bis zu einem festgelegten Abschluss. Das Modell beendet die Arbeit selbst mit update_goal, oder eine Rundengrenze greift.
Agent Mode Schaltet eine KI-Voreinstellung zwischen normalem Chat und werkzeuggetriebenem Arbeitsmodus um. Siehe Agent Mode.
Finish Check Antwortet das Modell ohne Tool-Aufruf, sendet der Handler bis zu zehnmal (Einstellung Maximale Anzahl an Wiederholungen) eine Aufforderung zum Weiterarbeiten. Die Konfiguration ist standardmäßig nicht aktiv. Siehe undefined>Finish Check.