Основи промпт-інжинірингу (3/4)

Snake Lab став повноцінним сервером із API на ZeroMQ, перевіркою конфігурацій, базою даних і можливістю проводити експерименти незалежно від клієнта. Тому очевидним стало наступне запитання:

Fr3d

Що буде, якщо дозволити LLM керувати ним?

Так з’явився Fr3d.

Fr3d був моєю першою спробою створити автономного агента на основі Snake Lab. Основна ідея досить проста: дати моделі достатньо інформації про експеримент, показати поточну конфігурацію та результати попередніх запусків, а тоді попросити вибрати нову конфігурацію, яка може показати кращий результат.

Snake Lab проводить експеримент.

Fr3d дивиться на результат.

Потім пробує знову.

Інакше кажучи, я нарешті поєднав свій маленький експеримент із локальною LLM з попереднього допису з тим, що могло виконувати справжню роботу.


Дати ШІ експеримент

Я почав складати промпти, які пояснювали моделі експеримент зі «Змійкою».

У промпті описувалися нейронна мережа, доступні параметри, допустимі діапазони, поточна конфігурація та релевантна історія експериментів. Потім Fr3d вибирав значення параметра й надсилав новий експеримент через API Snake Lab.

Усе це утворювало цикл:

промпт → LLM → конфігурація → Snake Lab → результат → промпт

І напрочуд швидко все запрацювало.

Не ідеально.

Але працювало.

У мене вже була відома робоча конфігурація «Змійки», яка набирала приблизно 38 очок, і я знав із місяців ручних експериментів з RNN, що існують кращі варіанти. Тож Fr3d мав реальне завдання.

Це вже було не просто прохання до LLM створити правдоподібний JSON.

Вона мала ухвалювати рішення на основі справжніх експериментальних результатів.


Короткий експеримент із комп’ютерним зором

Приблизно тоді я ненадовго відволікся на Qwen 2.5 VL, мультимодальну версію моделі з підтримкою зображень.

Ідея здавалася привабливою.

Замість описувати все числами, можна було показувати моделі графіки або навіть зображення зі «Змійки» й дозволити їй візуально міркувати про те, що відбувається. Технічно це працювало, але швидко виявилася важливіша проблема.

Модель із підтримкою зображень просто міркувала гірше за Qwen 3.5. Для цього застосування здатність до аналізу була набагато важливішою за зір.

Qwen 3.5 також показувала процес своїх міркувань, що виявилося надзвичайно корисним під час розробки промптів. Я бачив, як модель розуміє мої завдання. Іноді вона фактично говорила мені:

«Цей промпт — нісенітниця».

Можливо, не буквально, але зміст був саме такий.

Наприклад, я просив її вибрати ще не використане значення параметра й через її міркування з’ясовував, що всі допустимі значення вже випробувані. Або не надавав частину історії експериментів, яка моделі явно була потрібна. Або подавав інформацію в структурі, цілком зрозумілій для мене, але такій, що змушувала модель ламати голову над тим, які значення взагалі можна порівнювати.

Спостерігаючи за міркуваннями, я міг побачити ці помилки.

Це був, мабуть, мій перший справжній урок промпт-інжинірингу. Погана відповідь не обов’язково означає погану модель. Іноді ви просто поставили погане запитання.


Промпт-інжиніринг — це програмна інженерія

До Fr3d я здебільшого сприймав промпти як інструкції. Наприкінці проєкту почав ставитися до них радше як до інтерфейсів.

Модель може аналізувати тільки ту інформацію, яку ви їй надаєте. Важливі її структура, термінологія, обмеження та включена історія.

Якщо просите модель вибрати значення з простору пошуку, вона повинна знати цей простір. Якщо не можна повторно використовувати вже перевірені значення, потрібен достовірний перелік цих значень. Якщо результати з різними початковими значеннями генератора випадкових чисел (seed) не можна прямо порівнювати, це потрібно чітко сказати в промпті. А якщо він містить суперечливі вимоги, у LLM виникне така сама проблема, як у програміста, який працює за суперечливою специфікацією.

Промпти стали частиною архітектури системи.


Проблема прототипу

Приблизно за тиждень Fr3d запрацював.

  • Він міг спілкуватися зі Snake Lab.
  • Міг надсилати експерименти.
  • Міг отримувати результати.
  • Міг аналізувати їх і вибирати наступну конфігурацію.
  • Це був справжній автономний цикл експериментів від початку до кінця.

А код був жахливий.

Не тому, що якась окрема частина була надто складною. Просто проєкт органічно виростав, поки я з’ясовував, чим має бути система та як працювати з низькорівневим кодом.

  • Промпти були вбудовані безпосередньо в код застосунку.
  • Специфічна для експерименту логіка переплелася із загальною логікою сервера LLM.
  • Було дублювання.
  • Стан був розкиданий по різних місцях.
  • Щоб зрозуміти, що сталося під час експерименту, доводилося читати купу журналів і виконувати ситуативні SQL-запити.
  • Змінюючи одну частину процесу, потрібно було обережно простежувати залежності через доволі монолітну програму.

Ми дійшли до знайомої стадії прототипу: технічно програма працювала, але розуміти, чому вона працює, ставало дедалі складніше. І тоді я усвідомив ще одну помилку.


Звітність від початку мала бути повноцінною складовою

Я ставився до журналювання та звітності як до речей, які можна додати навколо експерименту. Насправді все навпаки. Для автономної експериментальної системи спостережуваність є частиною самого експерименту. Мені потрібно було легко відповідати на прості запитання:

  • Що бачила модель?
  • Який промпт призвів до цього рішення?
  • Якими були її міркування?
  • Яку конфігурацію вона надіслала?
  • Який результат отримала?
  • Що змінилося порівняно з попереднім експериментом?
  • Яка конфігурація зараз вважається найкращою?

Теоретично стос журналів міг дати відповіді. Але технічна можливість отримати відповідь і зрозумілість системи — зовсім різні речі. Наступну версію потрібно було від самого початку будувати навколо звітності.


Знайти межі відповідальності

Fr3d також навчив мене бачити природні межі між модулями.

Деякі частини системи були загальними:

  • Спілкування з локальним сервером LLM
  • Керування розмовами
  • Надсилання запитів
  • Зберігання стану
  • Опрацювання відповідей
  • Запис подій

Інші стосувалися саме цього експерименту:

  • Параметри конфігурації Snake Lab
  • Діапазони параметрів
  • Історія експериментів
  • Промпти
  • Логіка порівняння
  • Правила вибору наступного значення

У Fr3d ці дві категорії переплелися. Коли я чітко побачив різницю, архітектура наступної версії стала очевиднішою.

  • Промпти потрібно було зробити керованими даними.
  • Побудову промптів потрібно було винести в окрему абстракцію.
  • Звітність треба закласти в архітектуру.
  • Специфічну для експерименту логіку слід відокремити від загального механізму взаємодії з LLM.

Почати спочатку

Коли прототип уже працює, завжди виникає спокуса безкінечно його латати. Переробити цей шматок. Перенести ту функцію. Виділити клас. Почистити промпт. Прибрати дублювання.

Я вирішив цього не робити.

Fr3d уже виконав свою роботу: довів, що ідея здійсненна. Що важливіше, він показав, де насправді розташовані складні місця. Це надзвичайно цінна інформація, яку дуже важко отримати, намагаючись одразу спроєктувати все ідеально. Тож я зберіг уроки, але відкинув архітектуру.

Головний висновок із Fr3d був зовсім не «спочатку спроєктуйте все правильно». Майже навпаки.

  • Побудуйте грубий прототип.
  • Змусьте всю систему працювати від початку до кінця.
  • Подивіться, де виникають труднощі.
  • Знайдіть природні межі відповідальності.
  • З’ясуйте, які дані ви весь цей час хотіли б записувати.
  • І тоді почніть спочатку.

Fr3d був неохайним. Але працював. І саме завдяки цьому я нарешті знав, що потрібно будувати далі.


Посилання

2026

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 ↑