1. Home
  2. /Manual
  3. /What an AI agent actually is

The Manual · Ch 01

What an AI agent actually is

The architectural difference between chatbots and agents, and why it matters for what you build.

The shortest framing: An AI agent is an AI that can actually do things. Instead of just telling you how to do things, it can actually do the things it can tell you. A chatbot answers. An agent acts. That is the whole difference. When you ask a chatbot to "follow up with leads who have gone quiet," it gives you a paragraph about how to do that. When you ask an agent the same thing, it opens your email, scans the recent threads, cross-references your calendar, finds the people who haven't replied in two weeks, drafts a personalized message to each one, drops the drafts in your outbox, and tells you to click send. The agent does not do this by magic. It does it because someone — most likely you, eventually — wired it up to your inbox, gave it permission to read and write drafts, and taught it what "going quiet" means in your business.

A useful but imperfect metaphor: the new employee

Treat the agent the way you would treat a competent but literal new hire on day one. Default to over-specifying. The agent is competent but literal. "Save this so you always have it" beats "look at this." If you find yourself thinking "obviously it should know to keep this," that is a sign you need to say it explicitly. Brilliant in flashes and helpless in others. Tell it the obvious thing once, then never tell it again — that's what rules and skills are for.

What your agent actually knows

Your agent has two kinds of knowledge: Always-loaded context — general behavior rules and facts about you that load at the start of every session. Things like how to talk to you, your business basics, your preferences. You never edit this yourself. You just tell the agent what you want and it puts it in the right place. Skills — specific recipes for recurring tasks. The agent loads a skill only when it needs it. You build these by doing a task once with the agent, then telling it to save the approach as a skill. Always-loaded context = general behavior. Skills = specific task behavior. Keep that line clean and the agent stays sharp.

How the agent talks to the world

You message the agent in whatever channel you prefer — Telegram, WhatsApp, Slack, Discord, a web interface. The agent reads your message, decides whether to answer or to use a tool, then acts. Tools are its hands — they let it open your inbox, query your CRM, browse the web, run scripts. You do not need to understand any of the wiring. The agent's behavior is the sum of the model it runs, what it remembers about you, and what tools it has been given.

Why it doesn't always feel like magic the first day

The single most common newbie reaction: "I told it to do X and it didn't, or it half-did it, or it asked me a weird clarifying question." That is normal. The agent isn't all-knowing. People think the agent is an all-knowing being, but you have a lot of context in your head that you can't get out by typing a short prompt. That's why you have to plan — so the context comes out. Have the agent help you plan by asking questions. The first job, before you tell it to do anything, is getting your own context into its head. That is what most of this manual is about. What makes an agent different from a chatbot — and why that's the whole point.

Newsletter

Get the next one in your inbox.

One short email a week. Operator takes on AI agents, no hype.