← Back to Concept Contrast

Concept Contrast Fable

Things used to do work and things that do work for me

Conclusion first:When reading docs or forums, you often see "tool" and "agent" used interchangeably. Some say "install a plugin as a tool," others say "set up an agent to run the process." On the surface both are "help me do things," but on closer thought, these two things help me do things in completely different ways. Get it wrong, buy the wrong thing, and the code you write will be full of pitfalls.

When reading docs or forums, you often see "tool" and "agent" used interchangeably. Some say "install a plugin as a tool," others say "set up an agent to run the process." On the surface both are "help me do things," but on closer thought, these two things help me do things in completely different ways. Get it wrong, buy the wrong thing, and the code you write will be full of pitfalls.

Fable

The old carpenter's two kinds of helpers

An old carpenter has two kinds of helpers. The first are planes, saws, and ink lines: put your hand on them, and they amplify your strength. The second are grown apprentices. The carpenter says, "Fix the east bridge railing by tomorrow morning," and the apprentice measures dimensions, selects timber, asks people to lift beams, and comes back to ask for instructions when encountering bad wood.

The village chief initially called both kinds of helpers "labor-saving things." He bought ten new planes and demanded that the carpenter repair three bridges alone the next day. The planes were sharp, but with no one holding them, the boards still lay in the yard.

The village chief again treated the new apprentice like a moving plane, only instructing him to "go shave wood." The apprentice shaved all night, but the bridge was not repaired, because no one told him the goal, scope, priorities, and acceptance criteria.

In the first fix, the village chief labeled each plane with its purpose: rough plane, fine plane, edge trimmer. The carpenters worked faster, but when the bridge foundation was skewed, the planes couldn't judge whether to stop work or revise the blueprint.

For the second fix, he gave his apprentice a long list of actions. The apprentice followed it and discovered rotten wood hidden under the old railing. The list had no item for this, so he had no choice but to stand by the bridge until dark.

The old carpenter finally made it clear: tools need people to choose and drive them, and are suited to completing well-defined actions; an apprentice takes on a stretch of responsibility and must know the goal, the boundaries, the available tools, when to ask back and how to deliver.

From then on, when the village bought tools it looked at whether they could be conveniently invoked by people; when assigning apprentices it first wrote down the task and responsibility. Both can help; the difference lies in who holds the judgment and who bears the process.

Later, when the village chief made purchases again, he would first ask himself which kind of convenience he was buying. If he just wanted the carpenter to cut faster, he bought good tools; if he wanted the East Bridge repaired, he found someone who could take on the job and gave him materials, authority and acceptance criteria. Tools augment a person's actions; someone who takes on a job undertakes a whole process — this difference determines the entire arrangement. The old carpenter also reminded the village chief that if you treat an apprentice as a tool, you won't give him goals or a channel to ask questions; if you treat a tool as an apprentice, you'll expect it to judge for itself. Many failures are not because the helper is bad, but because the type of helper was misjudged from the start. Later, the village contracts were written more clearly too: buying tools specifies the use, entrusting work specifies the results and responsibilities. This saying was later written into the newcomers' handbook, reminding everyone to look at the on-site cost first before talking about saving effort.

Browser tools

A predefined, callable function or functional module in a browser environment. When called, specific parameters are passed in; it performs a specific operation and returns a result. The caller needs to break the task down into the smallest steps, with clear instructions at each step.

Agent

A system that, once given a goal, can autonomously plan steps, call tools, perceive environmental changes, and adjust its behavior. It needs not only a description of "what to do" but also one of "what counts as done."

Story Mapping

  • The old carpenter's shop → a system or project that needs to complete a task
  • Small hammer → browser-tool (tool)
  • Apprentice Xiao Zhou → agent
  • 'Shave this piece of wood into a door frame' → a goal description (goal)
  • "Tap once" → a specific action instruction (action)
  • Nail piercing the electrical conduit → a problem caused by the tool executing an instruction without understanding the context
  • Xiao Zhou also tidies up semi-finished products → unintended behavior arising from agent autonomous decisions
  • "Make ten cabinet doors" machine → a higher-level agent capable of calling multiple sub-tools to complete composite tasks

In practice: how to choose

If your task can be broken into fixed steps and the input and output of each step are clear, using a tool is more reliable—it will not slack off, will not take detours, and will not suddenly "get creative" at some step. If your task is a one-sentence goal, involves multiple possible paths, and requires dynamic adjustment based on intermediate results, using an agent is more convenient—but you must accept that it may not achieve the goal exactly the way you envisioned, and accept that the final check cannot be skipped. In real projects the two often work together: the agent handles planning and overall direction, while the tool handles execution of standardized operations that have already been validated.

京ICP备2026014272号