Kernkonzepte

Die wichtigsten Begriffe, die sich durch das ganze Handbuch ziehen.

Dieses Kapitel bringt dir die Vokabeln bei, mit denen du danach überall arbeitest.

#Workspace

Ein Workspace ist deine isolierte Konfiguration. Alles was du als Entwickler baust — Tools, Prompts, Tasks, Integrationen — lebt in genau einem Workspace. Andere Workspaces sehen davon nichts.

Im Code-Kontext (und in Logs) begegnet dir der Begriff Tenant. Das ist dasselbe.

#Chat

Eine Session, in der ein Benutzer mit dem LLM spricht. Chats haben eine chat_id, die den Verlauf zusammenhält. Benutzer-Nachrichten, Assistant-Antworten und Tool-Aufrufe landen alle in derselben chat_messages-Historie.

#Tool

Eine Funktion, die das Modell aufrufen kann. Tools sind deklarativ — Name, Parameter-Schema, optional HTTP-Endpunkt, optional PHP-Logik. Das Modell entscheidet zur Laufzeit, ob und mit welchen Argumenten ein Tool aufgerufen wird.

Siehe Tools — Überblick.

#Assistant

Ein vordefinierter Chat-Kontext: System-Prompt, Tool-Allowlist, erste Nachricht, Vorschläge. Benutzer starten einen Task aus der Oberfläche, bekommen eine fokussierte Arbeitsumgebung und können dort nur die Tools nutzen, die der Task freigegeben hat.

Assistants können zusätzlich scheduled laufen — vollautomatisch per Cron, ohne dass ein Mensch den Chat öffnet.

#Unified Chat

Ein Spezialmodus, in dem ein Benutzer alle verfügbaren Assistants in einer einzigen Chat-Session nutzen kann. Das Modell wechselt dynamisch die Rolle, indem es ein internes activateTask-Tool aufruft.

#Prompt

Der Text, den das Modell als „Grundanweisung" bekommt. Jeder Task hat einen eigenen System-Prompt, plus optional eine greeting (erste Nachricht des Assistenten) und einen reminder (Text, der wiederholt eingeblendet wird).

#API

Eine externe HTTP-Schnittstelle, gegen die Tools requesten. APIs werden einmal zentral in apis.php deines Workspace definiert (Basis-URL, Auth-Header, Timeouts). Tools referenzieren sie dann per Key.

#Knowledge Base (KB) / RAG

Durchsuchbare Wissensdatenbank. Besteht aus Sources (Quellen, typischerweise URLs oder hochgeladene Dateien), die beim Import in Entries zerschnitten werden. Tools können per Volltextsuche auf KBs zugreifen.

Das Modell liest nie die ganze KB — es ruft ein Such-Tool auf und antwortet auf die zurückgelieferten Treffer. Dieses Muster heißt RAG (Retrieval-Augmented Generation). TaskMonkey nutzt MySQL-Volltext-Retrieval statt Vektor-Embeddings.

#Scheduled Task

Ein Tool-Aufruf, der automatisch in einem festen Intervall ausgeführt wird (z. B. alle 5 Minuten oder täglich um 10:00). Definiert in scheduled.php.

#Handler / Preprocess / Postprocess

Drei optionale PHP-Funktionen pro Tool:

• preprocess: Läuft auf den Eingabe-Args, bevor der API-Call passiert
• postprocess: Läuft auf dem Response, nachdem das Mapping angewendet wurde
• handler: Ersetzt oder ergänzt den API-Call; darf andere Tools aufrufen

Im Detail: siehe Ablauf eines Tool-Aufrufs.

#Placeholder

Ein Platzhalter im Text, der zur Laufzeit durch einen echten Wert ersetzt wird. Beispiele: {{user_message_count}} in Prompts, <PDF:...> in Tool-Args. Siehe Platzhalter-Referenz.

#OAuth Connection

Eine gespeicherte Verbindung zu einem externen Dienst (Google, Dropbox, ...). Benutzer autorisieren einmal, danach nutzt jeder Tool-Aufruf den Access-Token automatisch. Tokens werden refresht, bevor sie ablaufen.