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
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.
update_goal und dem Status complete ab.update_goal mit dem Status needs_user_input eine Rückfrage, weil nur Sie entscheiden können, wie es weitergeht.update_goal mit dem Status blocked eine Blockade.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.
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.
| 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.
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.
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.
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).
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. |