Agents & Frameworks
What is an AI harness, and why does it matter more than your model choice
For a while, I thought picking an AI product came down to one question: which model is underneath? GPT, Claude, Gemini. Smarter model, better product. It seemed too obvious to question.
It was wrong.
The thing that actually changed how I read AI products was learning to separate the model from the system wrapped around it. Once you see that line, you stop being impressed by demos and start asking better questions.
A model on its own does very little
Drop a frontier model into an empty room and it can write, summarize, reason, and code. Genuinely useful things.
Now ask it to do the work people actually want done at a company: pull up a customer's last three tickets, check whether their plan covers a feature, file a bug, email the result. It can't. Not because it isn't smart enough, but because it has no hands. No access to your data, your tools, or your rules. It only knows what's in the prompt in front of it.
Everything that gives a model hands lives outside the model. That layer has a name: the harness.
What an AI harness actually is
An AI harness is the engineering layer around a model that connects it to everything it can't reach on its own: your data, your tools, memory, and your rules. The model produces text. The harness controls what goes into the model, what it's allowed to act on, and what happens to its output.
Most of that work is unglamorous and invisible: find the right information, hand it to the model, take what comes back, check it, and act on it safely.
Strip away the jargon and a production harness is doing a handful of jobs at once:
Retrieval — finding the right context before the model writes a word. Vector search, a knowledge base, document indexing, some way to rank what matters. In most systems I've looked at, this is the part that decides whether the answer is any good. The model can only reason over what you put in front of it. Bad retrieval, confident wrong answer.
Memory — holding onto conversation history, user preferences, and state so the person isn't re-explaining themselves every turn.
Tools and actions — letting the model trigger something real. Query a database, send the email, open the ticket. The model decides what should happen; the harness is what actually does it, and what stops it from doing something it shouldn't.
Guardrails and evaluation — checking outputs before they reach a user or fire an action. Validation, policy checks, a human in the loop where the stakes are high.
Monitoring — logging, tracking failures, collecting feedback. The boring infrastructure that tells you where the system breaks, which is the only way it ever gets better.
The loop is where agents come from
Most people picture AI as a single exchange: ask, get an answer, done.
The systems that feel capable don't stop at one step. They run a loop: gather context, call a tool, look at what came back, update, decide the next move, repeat. That cycle is most of the difference between a chatbot and something you'd call an agent. One does a single turn. The other works a problem until it's solved.
A better mental model
I used to think of it like this:
User → Model → Answer
Now it's closer to:
User → System → Model → System → Answer
Before the model sees anything, the system is already working: searching, retrieving, pulling records, checking permissions. The model reasons over what it's given. Then the system takes over again, to show the answer, or call a tool, or fetch more, or reject the whole thing because it broke a rule.
The model is one step in the middle. People stare at it because it's the visible part. Most of the work sits on either side of it.
Why two products on the same model feel nothing alike
This is the part that used to confuse me, and it's the reason the distinction is worth caring about.
Two teams can ship on the exact same foundation model and end up with completely different products. One feels sharp and dependable. The other gets things wrong often enough that you stop trusting it.
The model isn't the variable. The system is. What data can it reach, and is that data current? Does retrieval surface the right document at the right moment, or something close-but-wrong? Can it actually take action, or only talk about it? What catches the mistakes before the user does?
I work on support AI. Two assistants can sit on the same model and one closes the ticket while the other walks the customer in a circle. When I've traced that gap, it's almost always in the system, and usually in retrieval, not in the model.
Quick Infographic Summary
Infographic Created by Vinay C (imvinayc)
What this changed in practice
Now when an AI system underperforms, the model is the last place I look. I start with what it was handed. Was the right context retrieved? Did it have the tool it needed? Were the rules clear, and did anything check the output before it went out? Most of the time the fix lives somewhere in there, not in swapping one model for another.
It also changed how I read a demo. A clean demo tells you the model can talk. It says almost nothing about whether the system around it holds up on the messy, real inputs that never make it on stage.l;'
So the question I lead with isn't "which model is best?" It's "how well is the whole thing built?" That one has been far more useful.
Originally published on LinkedIn.