Wie ein KI-Agent funktioniert, einfach erklärt: Harness, Kontext und Gedächtnis

Was ist ein KI-Agent, einfach erklärt

Stell dir vor, du hast einen genialen Koch eingestellt. Tausende Rezepte im Kopf, kocht alles, schuftet rund um die Uhr. Ein Haken: er steht mit verbundenen Augen mitten in einem leeren Raum. Kein Herd, kein Messer, kein Kühlschrank. Und sobald du zur Tür rausgehst, vergisst er einfach alles.

Dieser Koch ist das Modell (Claude, GPT und Co). Und die Küche drumherum: Herd, Messer, Rezepte an der Wand, die Regel „fass nicht ins Feuer“ - das ist der Harness Harness (von engl. harness - „Geschirr, Gurtzeug“) ist die gesamte Umhüllung rund um das Modell: die Tools, die man ihm gibt, das Format, in dem es Ergebnisse sieht, die Regeln und das Gedächtnis. Das Modell ist dasselbe, aber der Harness ist bei jedem anders. . KI-Agent = Koch plus Küche. Nicht das eine oder das andere, sondern beides zusammen.

Warum ein Vibecoder verstehen sollte, wie der Agent denkt

Du bist Vibecoder. Code mit den eigenen Händen schreiben musst du nicht. Aber sobald du kapierst, wie ein KI-Agent denkt, ändert sich Folgendes:

• du regst dich weniger auf und behebst die Ursache statt das Symptom;
• du sparst Geld - fürs „Denken“ zahlst du mit Tokens, gleich erkläre ich das;
• du kriegst dein Ergebnis beim ersten oder zweiten Anlauf, nicht beim zehnten;
• du formulierst die Aufgabe so, dass der Agent nicht auf halber Strecke „abdriftet“.

„Die KI hat mir eine krumme Website gebaut“ versus „die KI hat mir eine funktionierende Website gebaut“ - meistens ist das der Unterschied im Verständnis von drei Dingen: Kontext, Tokens, Gedächtnis. Damit fangen wir an.

Drei Säulen: Kontext, Tokens und Gedächtnis

Kontext - der Schreibtisch des KI-Agenten

Ein Gedächtnis wie ein Mensch hat der Agent nicht. Es gibt das Kontextfenster Kontext (Kontextfenster) ist der gesamte Text, den das Modell gerade jetzt „sieht“: deine Nachrichten, Dateien, Befehlsausgaben, Anweisungen. Alles, was nicht reinpasst oder rausgeflogen ist, existiert fürs Modell nicht. - quasi ein Schreibtisch. Auf den Tisch passt nur eine begrenzte Zahl an „Zetteln“: die Aufgabe, Code-Stücke, Befehlsausgaben, Anweisungen.

Liegt das Richtige auf dem Tisch, ist der Agent ein Schlaukopf. Vermüllst du den Tisch mit Schrott (alte Nachrichten, ellenlange Logs, fünf Versionen derselben Datei) - dann hat der Koch buchstäblich keinen Platz mehr, das Messer abzulegen. Genau hier verliert er den Faden, verwechselt Details und fängt an zu halluzinieren.

Tokens - die Währung, mit der du für den Tisch zahlst

Jeder „Zettel“ auf dem Tisch kostet Geld. Text wird fürs Modell in Tokens Token - ein Stück Text, ungefähr 3-4 Zeichen oder ¾ Wort. Das Modell liest und schreibt in Tokens. Du zahlst sowohl für die Eingabe-Tokens (was du gegeben hast) als auch für die Ausgabe-Tokens (was es generiert hat). zerlegt. Mehr Text reinschieben, längere Antworten verlangen - mehr Tokens. Und damit teurer und langsamer.

Deshalb schieben erfahrene Vibecoder nicht das ganze Projekt in den Chat. Sie geben einen Link zur Datei, das nötige Fragment - oder bitten den Agenten, selbst zu finden, was er braucht. Und zahlen dafür ein paar Cent statt einen Euro.

Gedächtnis: kurz und lang

Genau hier tappt der Anfänger in die Falle. Der Agent hat zwei Arten von Gedächtnis, und die verwechselt man leicht:

• Kurzzeit (Arbeitsgedächtnis) - das ist genau der Kontext, eben dieser Tisch. Es lebt exakt eine Session lang. Chat geschlossen oder ein „Compact“ dazwischengekommen - alles weg.
• Langzeit - das sind Dateien auf der Festplatte. Notizen, MEMORY.md, Projektregeln. Im Kopf behält das Modell zwischen den Durchläufen nichts: es liest jedes Mal die Dateien neu ein.

Compact: wann man den Kontext aufräumt

Wenn der Tisch überquillt, passiert ein Compact Compact ist das Komprimieren des Gesprächsverlaufs: der Agent fasst Altes zu einer kurzen Zusammenfassung zusammen, um Platz zu schaffen. Nützlich, aber dabei gehen Details verloren. : der Agent fasst den alten Verlauf zu einer kurzen Zusammenfassung zusammen. Platz ist frei - aber die Details sind weg. Als hättest du alles vom Tisch in einen Ordner „Diverses“ gewischt: Platz ist da, aber das Richtige zu finden ist jetzt eine Plage.

Der ganze Trick liegt darin, wann man das macht:

Guter und schlechter Harness

Der Harness ist die Küche. So unterscheidest du auf einen Blick eine bequeme von einer albtraumhaften. Nützlich, sobald du anfängst, Tools einzubinden - MCP, Skills und so weiter (das kommt in den nächsten Kapiteln).

KI-Gedächtnis: was hilft und was stört

Beispiel aus dem Leben: warum der Agent eine funktionierende Landingpage zerlegt hat

Du bittest: „bau mir eine Landingpage für ein Café“. Der Agent startet munter, generiert 12 Dateien. Du schickst nebenbei 40 Korrekturen hinterher: „Button weiter nach links“, „andere Schrift“, „nein, mach es zurück wie es war“. Und nach einer Stunde zerlegt er plötzlich das, was am Anfang super lief. Und behauptet auch noch steif und fest, das sei „schon immer so gewesen“.

Was wirklich passiert ist:

1. Der Tisch wurde mit vierzig Korrekturen und einem Dutzend Dateiversionen vollgemüllt.
2. Ein Compact ist dazwischengekommen - und der Agent hat vergessen, wie die funktionierende Variante aussah.
3. Die Regel „Schrift: Fraunces“ lebte nur im Chat und wurde mit dem Verlauf gelöscht.

Und so hätte jemand, der die Küche versteht, dieselbe Anfrage gestellt:

Bau eine Landingpage für ein Café. Bevor du Code schreibst:

Schreib die wichtigsten Anforderungen in die Datei DECISIONS.md (Schrift Fraunces,
Palette teal, eine Seite, Bestell-Button oben). Stimm sie danach mit mir ab.
Arbeite Block für Block: Hero, Menü, Kontakt.
Nach jedem Block zeig mir das Ergebnis und warte auf mein „ok“.
Schreib bereits freigegebene Blöcke nicht ohne meine Erlaubnis um.
Wenn der Verlauf überquillt - mach den Compact NUR nach einem
fertigen Block, nicht mittendrin.

Agent hat einen Hänger? Mini-Diagnose

Bevor du durchdrehst, geh die Checkliste durch (das ist im Grunde der Skill agent-introspection-debugging):

1. Tisch nicht vollgemüllt? Das Gespräch ist lang, der Agent verheddert sich - aufräumen oder neu starten.
2. Kontext nicht verloren? Vielleicht hat ein Compact etwas Wichtiges gelöscht - wiederhole die zentralen Anforderungen.
3. Regel auch wirklich in einer Datei? Einmal im Chat gesagt - zählt nicht.
4. Tool nicht stumm? Der Agent dreht sich im Kreis - vielleicht schlägt ein Befehl fehl, und er sieht die Fehler nicht.
5. Aufgabe nicht zu groß? Schneide sie in Stücke von je etwa fünfzehn Minuten Arbeit.

Häufige Anfängerfehler beim Vibecoding

• Das ganze Projekt in den Chat kippen. Teuer und müllt den Tisch zu. Gib das nötige Stück.
• Regeln nur im Chatverlauf halten. Nach dem Neustart sind sie weg. Lager sie in Dateien aus.
• Eine einzige Riesenaufgabe durchdrücken. Der Agent verschluckt sich. Schneide sie in Stücke.
• Den Kontext mitten im Debugging aufräumen. Du verlierst genau das, was du gesucht hast.
• Nicht auf die Tokens schauen. Der „unendliche“ Chat kommt eines Tages mit einer Rechnung, bei der dir flau wird.
• Mit dem Agenten streiten statt neu zu starten. Manchmal ist es billiger, eine Session mit sauberem Tisch zu beginnen.