Field notes
Field Notes
Agents vs. wrappers: a field guide
“We added AI” can mean a thin wrapper around a chat box, or a system that does real work end to end. The difference matters more than the label.
TAGS
AGENTS
ARCHITECTURE
tooling

Inês Carvalho
ML ENGINEER
5 Mar 2026
6 minutes
ON THIS PAGE
01 A wrapper answers; an agent acts
02 Tools are what make it real
03 When a wrapper is the right call
04 The test
The word “agent” has been stretched to cover everything from a genuinely autonomous system to a text box with a clever prompt. The distinction isn’t pedantic — it determines what the thing can actually do for you.
A wrapper answers; an agent acts
A wrapper takes a question and returns text. Useful, sometimes, but it ends where the conversation ends. An agent takes a goal, breaks it into steps, calls tools, reads and writes to your systems, checks its own work, and produces an outcome — not just a reply.
If the “AI feature” can’t do anything beyond talk, it’s a wrapper. That’s fine, as long as you’re not paying for an agent and getting a chat box.
Tools are what make it real
An agent is only as capable as the things it’s allowed to touch. Wiring it into your stack — your data, your APIs, your internal tools — is most of the actual work, and it’s the part demos skip. The model is rarely the hard part. The integration is.
When a wrapper is the right call
Not everything needs an agent. If the job is genuinely “summarize this” or “draft that,” a wrapper is simpler, cheaper, and easier to reason about. Reaching for an autonomous system when a single prompt would do is its own kind of over-engineering.
The test
Ask one question: at the end, did something change in the world — a ticket closed, a record updated, an order routed — or did you just get words back? Words are a wrapper. Change is an agent. Decide which one you actually need before anyone starts building.
archivio { 1 }
OTHER POSTS
Read related content
Read our posts on strategy, engineering, process, opinion and field notes.
RELATED INSIGHTS
All
Strategy
Engineering
Process
Opinion
Field notes

Context windows aren’t memory
Stuffing everything into the prompt feels like memory, but it isn’t. Real systems decide what to retrieve, when, and what to forget — here’s how we think about it.
Inês Carvalho
6 minutes
Read post

Most "AI problems" aren’t AI problems
Before you build an agent, it’s worth asking whether the bottleneck is the model — or the broken process around it. Usually it’s the process.
Sofia Almada
5 minutes
Read post

What "production-grade" actually means for an AI agent
A demo proves an agent can work once. Production means it works on the thousandth strange input, at 3am, when nobody’s watching. Here’s the gap between the two.
Inês Carvalho
7 minutes
Read post

The handoff is the product
A system you can’t run without us isn’t an asset — it’s a dependency. We’d rather build something you own outright.
Marco Vieira
4 minutes
Read post

Why we ship in weeks, not quarters
Long timelines hide risk. Short ones surface it. Here’s how a six-week engagement stays honest from kickoff to launch.
Marco Vieira
5 minutes
Read post
