Glossar
Alphabetische Kurzreferenz aller Fachbegriffe.
Kurzdefinitionen in alphabetischer Reihenfolge. Tiefergehende Erklärungen findest du in den jeweiligen Kapiteln.
| Begriff | Bedeutung |
|---|---|
| API | Externe HTTP-Schnittstelle, zentral in apis.php definiert. |
| Args / Arguments | Parameter, die das Modell einem Tool-Aufruf mitgibt. |
| Assistant | Vordefinierter Chat-Kontext mit eigenem Prompt und Tool-Set. Konfig in assistants/<slug>.php, Wrapper-Key assistants.<slug>. |
| Chat | Konversations-Session mit eigener chat_id und Verlauf. |
| chat_id | Eindeutige Kennung einer Chat-Session. Format: task_<slug>_<userId> (Assistant), unified_<userId>, oder freier String (Public). |
| Entry | Einzelner, durchsuchbarer Abschnitt einer Knowledge Base. |
| Greeting | Erste Assistant-Nachricht beim Chat-Start (Feld greeting im Assistant, public.greeting im Public-Chat). Vorher first_message. |
| Handler | PHP-Funktion, die ein Tool ausführt (statt oder zusätzlich zum API-Call). |
| Inputs | Inline-Textfelder über den Pills (z.B. „Bestellnummer"). Wert wird beim Send als Prefix mitgeschickt. Feld inputs im Assistant, public.inputs im Public-Chat. |
| Knowledge Base (KB) | Sammlung durchsuchbarer Wissensquellen für Tools. |
| LLM | Das Sprachmodell (OpenAI, Claude oder Gemini). |
| Mapping | Übersetzung eines API-Responses in das Format, das das Modell sieht. |
| OAuth Connection | Gespeicherte Zugangsdaten zu einem Fremdsystem. |
| Placeholder | Textmarker wie {{foo}} oder <PDF:...>, der zur Laufzeit ersetzt wird. |
| Postprocess | PHP-Funktion, die nach API-Call und Mapping läuft. |
| Preprocess | PHP-Funktion, die vor dem API-Call auf die Args angewendet wird. |
| Prompt | Grundanweisung an das LLM. Pro Assistant ein eigener prompt-Key, für den Public-Chat public.prompt. |
| Public-Chat | Anonymer Standard-Chat ohne Login. Konfig in public.php (Top-Level dot-paths public.tools, public.prompt, public.greeting, public.suggestions, public.toggles, public.inputs, public.llm). |
| RAG | Retrieval-Augmented Generation. Das Modell ruft ein Such-Tool auf, bekommt passende Passagen aus einer Knowledge Base zurück und antwortet darauf basierend. TaskMonkey nutzt MySQL-Volltext-Retrieval, keine Vektor-Embeddings. |
| Reminder | Zusätzlicher Prompt-Text, der periodisch wieder eingeblendet wird. Feld reminder im Assistant. |
| Scheduled Task | Tool-Aufruf, der automatisch per Cron-Intervall läuft. Konfig in scheduled.php, Wrapper-Key scheduled. |
| Source | Eine Ingestion-Quelle für eine Knowledge Base (URL, Datei). |
| SSE | Server-Sent Events, das Transportformat fürs Chat-Streaming. |
| Suggestions | Klick-Pills unter der ersten Assistant-Bubble (Klick = sofort senden). Feld suggestions im Assistant, public.suggestions im Public-Chat. Vorher initial_suggestions. |
| Assistant-Slug | Kurzer URL-tauglicher Identifier eines Assistant. Z.B. gutscheine, inventur. |
| Tenant | Interner Begriff für Workspace — gleiche Sache. |
| Test-Modus | Führt schreibende API-Calls nicht wirklich aus (dry-run). |
| Toggles | Multi-Select-Pills (Checkbox-Optik). Aktive Toggles werden beim Send als Suffix angehängt. Feld toggles im Assistant, public.toggles im Public-Chat. Vorher initial_toggles. |
| Tool | Vom Modell aufrufbare Funktion, deklarativ konfiguriert. |
| Unified Chat | Modus, in dem ein Chat alle Assistants per activateTask-Tool wechseln darf. Konfig unter unified (eigener Block, nicht Teil des assistants-Schemas). |
| Workspace | Isolierter Konfigurations- und Datenbereich eines Kunden. |