Einführung ins Prompt Engineering (3/4)

Snake Lab war zu einem richtigen Server geworden, mit ZeroMQ-API, Konfigurationsvalidierung, Datenbank und Experimenten unabhängig vom Client. Die nächste Frage lag auf der Hand:

Fr3d

Was geschieht, wenn ich eine LLM diesen Server steuern lasse?

So entstand Fr3d.

Fr3d war mein erster Versuch, einen autonomen Agenten auf Snake Lab aufzubauen. Die Grundidee: Das Modell bekommt genügend Informationen über das Experiment, die aktuelle Konfiguration und die Ergebnisse früherer Läufe. Dann soll es eine neue Konfiguration vorschlagen, die vielleicht besser funktioniert.

Snake Lab führt das Experiment aus.

Fr3d betrachtet das Ergebnis.

Dann versucht es etwas Neues.

Zum ersten Mal hatte ich das kleine LLM-Experiment aus dem vorherigen Beitrag mit einer Aufgabe verbunden, die tatsächlich Arbeit verrichtete.


Der KI ein Experiment geben

Ich begann, Prompts zu erstellen, die dem Modell das Snake-Experiment erklärten.

Der Prompt beschrieb das neuronale Netz, verfügbare Parameter, gültige Wertebereiche, aktuelle Einstellungen und passende frühere Ergebnisse. Fr3d wählte einen Parameterwert und übermittelte eine neue Konfiguration über die Snake-Lab-API.

So entstand eine Schleife:

Prompt → LLM → Konfiguration → Snake Lab → Ergebnis → Prompt

Und erstaunlich schnell funktionierte sie.

Nicht besonders schön.

Aber sie funktionierte.

Ich kannte bereits eine Snake-Konfiguration mit ungefähr 38 Punkten als Rekord und wusste aus monatelangen RNN-Experimenten, dass bessere möglich waren. Fr3d hatte also ein echtes Problem zu lösen.

Es ging nicht darum, bloß plausibel aussehendes JSON zu erzeugen.

Die Entscheidungen mussten sich an echten Messwerten bewähren.


Ein kurzer Ausflug in die Bildverarbeitung

Damals experimentierte ich auch kurz mit Qwen 2.5 VL, der Vision-Language-Variante.

Die Idee war reizvoll.

Vielleicht könnte ich dem Modell statt Zahlen Diagramme oder Bilder aus den Snake-Experimenten zeigen und es daraus Schlussfolgerungen ziehen lassen. Technisch funktionierte das, doch ein anderes Problem war wichtiger.

Das multimodale Modell konnte nicht so gut schlussfolgern wie Qwen 3.5. Für diesen Einsatz war das deutlich wichtiger als seine Bildfähigkeiten.

Qwen 3.5 zeigte außerdem seinen Denkprozess, was mir beim Entwickeln der Prompts enorm half. Ich sah, wie das Modell meine Aufgaben verstand. Manchmal sagte es mir indirekt sehr deutlich:

„Dieser Prompt ist Unsinn.“

Nicht wortwörtlich, aber sinngemäß.

Ich bat etwa darum, einen unbenutzten Parameterwert auszuwählen, und sah dann, dass alle gültigen Werte schon getestet waren. Oder ich ließ Informationen aus der Experimenthistorie weg, die das Modell offensichtlich brauchte. Oder ich strukturierte Daten so, dass sie für mich logisch wirkten, das Modell aber kaum erkennen konnte, welche Werte vergleichbar waren.

Der Denkprozess machte diese Fehler sichtbar.

Das war wahrscheinlich meine erste echte Lektion im Prompt Engineering: Eine schlechte Antwort ist nicht zwangsläufig ein Modellproblem. Manchmal hat man einfach eine schlechte Frage gestellt.


Prompt Engineering ist Software Engineering

Vor Fr3d betrachtete ich Prompts vor allem als Anweisungen. Am Ende dachte ich eher an Schnittstellen.

Das Modell kann nur die Informationen analysieren, die es bekommt. Ihre Struktur ist wichtig, ebenso Terminologie, Einschränkungen und die enthaltene Historie.

Soll das Modell einen Wert aus einem Suchraum auswählen, muss es diesen Suchraum kennen. Soll es bereits getestete Werte vermeiden, braucht es eine zuverlässige Liste. Sind Ergebnisse unterschiedlicher Seeds nicht direkt vergleichbar, muss der Prompt das deutlich machen. Und widersprüchliche Anforderungen verursachen für eine LLM dieselben Schwierigkeiten wie für einen Programmierer mit widersprüchlicher Spezifikation.

Die Prompts wurden Teil der Systemarchitektur.


Das Problem des Prototyps

Nach ungefähr einer Woche funktionierte Fr3d.

  • Es konnte mit Snake Lab kommunizieren.
  • Experimente übermitteln.
  • Ergebnisse empfangen.
  • Die Ergebnisse analysieren und neue Konfigurationen auswählen.
  • Es war eine autonome Experimentierschleife von Anfang bis Ende.

Und der Code war schrecklich.

Nicht weil einzelne Teile besonders schwierig waren, sondern weil das Programm organisch gewachsen war, während ich noch herausfand, was es werden sollte und wie ich die Low-Level-Funktionen benutzen musste.

  • Prompts waren direkt in den Anwendungscode eingebettet.
  • Experimentspezifische Logik war mit allgemeiner LLM-Server-Logik vermischt.
  • Es gab doppelte Implementierungen.
  • Der Zustand war verstreut.
  • Um ein Experiment nachzuvollziehen, musste ich Logs lesen und spontane SQL-Abfragen ausführen.
  • Jede Änderung verlangte, Abhängigkeiten durch ein ziemlich monolithisches Programm zu verfolgen.

Das war die typische Prototypphase: Die Software funktionierte zwar, aber zu verstehen, warum sie funktionierte, wurde immer schwieriger. Dabei bemerkte ich einen weiteren Fehler.


Reporting hätte von Anfang an dazugehören müssen

Ich hatte Logging und Berichterstattung als etwas behandelt, das man nachträglich um Experimente herum baut. Genau das war falsch. Für eine autonome Experimentieranlage ist Beobachtbarkeit Teil des Experiments. Ich wollte grundlegende Fragen einfach beantworten:

  • Was sah das Modell?
  • Welcher Prompt führte zu seiner Entscheidung?
  • Wie argumentierte es?
  • Welche Konfiguration reichte es ein?
  • Was war das Ergebnis?
  • Was änderte sich gegenüber dem vorherigen Experiment?
  • Welche Konfiguration gilt aktuell als beste?

Mit genügend Logdateien könnte man das technisch beantworten. Aber eine Antwort irgendwo ausfindig machen zu können und ein verständliches System zu haben, sind zwei verschiedene Dinge. Die nächste Version musste von Anfang an auf Reporting ausgelegt sein.


Die Grenzen erkennen

Fr3d half mir auch, die natürlichen Modulgrenzen zu sehen.

Einige Funktionen waren allgemein:

  • Mit dem lokalen LLM-Server kommunizieren
  • Gespräche verwalten
  • Anfragen versenden
  • Zustand speichern
  • Antworten verarbeiten
  • Ereignisse protokollieren

Andere waren spezifisch für dieses Experiment:

  • Konfigurationsparameter von Snake Lab
  • Gültige Wertebereiche
  • Experimenthistorie
  • Prompts
  • Vergleichslogik
  • Regeln für die nächste Auswahl

In Fr3d war das alles miteinander verknüpft. Als ich diese Unterscheidung verstand, wurde die Architektur der nächsten Version deutlich klarer.

  • Prompts sollten datengesteuert werden.
  • Ihre Konstruktion brauchte eine eigene Abstraktion.
  • Reporting gehörte in die Architektur.
  • Experimentspezifische Logik musste von der allgemeinen LLM-Kommunikation getrennt werden.

Neu anfangen

Bei einem funktionierenden Prototyp möchte man immer weiter daran herumschrauben: eine Funktion verschieben, eine Klasse extrahieren, den Prompt säubern, Duplikate entfernen.

Ich entschied mich dagegen.

Fr3d hatte seinen Zweck erfüllt. Es hatte bewiesen, dass die Idee funktioniert. Vor allem hatte es mir gezeigt, wo die eigentlichen Schwierigkeiten lagen. Das ist enorm wertvolles Wissen, das man durch perfektes Vorausplanen kaum bekommt. Ich behielt die Erkenntnisse und warf die Architektur weg.

Die Lehre war nicht „Entwirf alles gleich richtig“. Fast das Gegenteil:

  • Baut einen groben Prototyp.
  • Bringt das ganze System zum Laufen.
  • Beobachtet, wo es wehtut.
  • Erkennt die natürlichen Verantwortungsgrenzen.
  • Fragt euch, welche Daten ihr von Anfang an hättet speichern sollen.
  • Fangt dann neu an.

Fr3d war chaotisch. Aber es funktionierte. Und deswegen wusste ich endlich, was ich als Nächstes bauen musste.


2026

German Translation

AI translation is pretty amazing these days. AI tooling is pretty great too. I host my websites on GitHub Pages and I have a ChatGPT subscription. ChatGPT co...

Git Automation

Some of you may have read my Git Battles post, where I talked about how I developed and a documented a Git workflow.

My blog in Simplified Chinese

I recently built MyCount to track website visitors to my projects. I found that that over 40% of my visitors were from China, and that 35% of those used a Ch...

MyCount: Website Analytics & Marketing

I have a future project in mind which will require a Dynamic DNS service. I created BMDynIP for that purpose. After building the service, I wanted a simple a...

Animating Ax3l Playing Snake

I’ve been tinkering with various incarnations of Patrick Loeber’s Train an AI to Play Snake tutorial for a while now. It’s my relaxing goto project that’s fu...

Dynamic DNS Service

This project started as a cron job and a flatfile and -honestly- that would work perfectly well for a small home setup. Say, two or three machines. I’m curre...

Local GeoIP Database

The Bear & Moose GeoIP Project provides an easy-to-use GeoIP service for your applications and for interactive lookups.

An LLM to organize my Movies

Our first TV was a small black-and-white thing where, on rare occasions, we’d watch Animal Kingdom. Then Beta and VHS came along, and you could watch them at...

From Prototype to Product (4/4)

Fr3d worked: It could talk to the Snake Lab, propose changes to the RNN configuration, run experiments, look at the results, and try again. It proved the ide...

Prompt Engineering 101 (3/4)

The Snake Lab had become a proper server, with a ZeroMQ API, configuration validation, a database, and a way to run experiments independently of the client. ...

The Evolution of Snake Lab (2/4)

In my last post, I setup a locally hosted LLM running on an old HP Z440 and wrote a crude little conversation loop. I generated random numbers, fed them to t...

Local LLM Writes Haikus (1/4)

This is part one of a four part blog series. In this post, I download, install and setup some software to prompt a local LLM to write haikus…

From Seed to Signal: AI FX

In the first post, AI FX was still mostly a seed: a repo, a PyPI package, and an idea about using automated FOREX tooling as a learning lab. Since then, the ...

Simulating the Power Grid

A potential client pointed me to Empowering the Energy Transition Through Fast and Flexible Network Simulation. The article describes an Open Source project,...

Delphi in a Day

I have a prospective client who runs a small group of technology businesses, at least one of which integrates with clients using the Delphi programming lan...

A Small Experiment: AI FX

I’ve spent some time around trading systemsL At Merrill Lynch, I supported the Order Audit Trail System (OATS), a compliance system required by NASDAQ. Its p...

Back to top ↑

2025

My Art on Etsy

I setup an Etsy Storefront to sell high quality, museum grade prints of some of my artwork.

Python systemctl Wrapper

I’ve been working on Db4E, my Monero deployment, operations and analytics platform. It uses Linux systemd to spin up manage Monero, P2Pool and XMRig instance...

AI Snake Lab

AI Snake Lab is an interactive reinforcement learning sandbox for experimenting with AI agents in a classic Snake Game environment — featuring a live Textual...

The Power of Pictures

You know that saying, “A picture is worth a thousand words.”? In programming, I’d argue it can be worth a thousand lines of code…

Caring About Constants

This post is about using constants in your code. Why it matters, what the benefits are and how you can do it well. I’m sad to say, I learned this the hard wa...

Why I Built Db4E

When I first started experimenting with Monero mining and self-hosted infrastructure, I did what everyone else does: I downloaded the Monero software, the P2...

Releasing with Git

Let me be honest: Git has punched me in the face more times than I can count. Every time I think I’ve got a smooth release flow down, Git yells, “Not so fast...

Documentation Matters

I was burned by opaque documentation: I’ve been building a modern terminal UI in Python using the excellent Textual framework. It’s sharp, fast, and honestly...

Textual Replaces ApexCharts

The original reporting system was a set of static dashboards built using GitHub Pages, JavaScript, and ApexCharts. It pulled data from my mining setup — via ...

Pivot to Textual

I’ve been deep in the trenches with my Db4E project — pulling together Monero mining infrastructure, MongoDB integration, and a bunch of orchestration magic....

Released Db4E SystemD

I recently published a small Python module to PyPI and GitHub: db4e-systemd, a lightweight wrapper around systemctl that lets you control services (start, st...

NIKU Farms

I received my order from NIKU Farms, YAY! It’s a meat delivery that my sister, Corinna Ghaznavi, gifted me this Christmas. Every two months I receive this am...

The Main Website

As part of my goal to be more visible in the world, I setup this domain i.e. https://osoyalce.com. I use it to publish information about the projects I’m wor...

Reviving the Blog

It’s been a while since I started and then abandoned this blog. My last post was in June of 2024!!

Changing the Blog Site’s Layout

I decided that I didn’t like the way that the main blog page looks. I am using GitHub to host the website and am using a fork of the jekyll/minima theme. My ...

Back to top ↑

2024

Aquaponics Update #1

It’s in the construction phase. I need to complete the water circulation process. I bought a fiber glass kit for this (and also to fix my kitchen sink!).

What I’m working on

The XMR Mining Farm complete with this eye-popping chart The Bear and Moose Knowledge Base My resume MyZODB - A Place to Store Everything

Back to top ↑