đ€ Raising the Resolution of AI Agent Design
Decision Making / AI Agents / AI / Design
â The Sticking Points of Agent Design, Thought Through with the Decision Map â
This post is a sequel to the previous post, âMaybe Whatâs Missing When You âCanât Decideâ Is Just One of Five Elements.â It reads better if youâve taken in that postâs content â the five elements of the decision map, the fractal structure, the boundary between subjective and objective, the skill needed in the AI era.
Introduction
In Part 4 of the previous post, I made this point:
An AI agent assembles the five elements of each individual task itself, given a goal. But what makes the agent possible in the first place is âthe five elements of the agent,â designed by a human. Someone who holds a decision map can stand on the side that designs the agent.
That was as far as the direction goes. This time I want to push one step further and organize how to actually use the decision map as a tool on the ground, in agent design.
This isnât a story of âfill in the five elements and the agent runs.â In practice, whatâs actually asked on the ground is:
- Which element, designed wrong, causes what kind of failure
- How much design cost should be spent on which element
- Which of the five elements to suspect when the agent fails
- How to use the hierarchical structure to run an agent safely
Iâll cover this in four parts this time.
- Part 1: The agent is âthe entity that assembles the five elementsâ
- Part 2: The sticking points of design, element by element
- Part 3: Using the hierarchy â sub-agents and the point of human intervention
- Part 4: Failure diagnosis â which of the five elements went wrong
Part 1: The Agent Is âthe Entity That Assembles the Five Elementsâ
The difference between using AI for an individual task and an agent
In the context of the decision map, the difference between the two, drawn out sharply, looks like this.
| Using AI for an individual task | Agent | |
|---|---|---|
| Who assembles the five elements | The human assembles them every time and hands them to AI | The agent assembles the five elements of each individual task itself |
| The humanâs role | Designing the five elements per task | Designing the agentâs own five elements |
| Responsibility on failure | Five-element design and output evaluation | The whole agent design + monitoring |
What matters here is that the layer the human steps down to moves up one level. The agent takes over the design of each individual task, but in exchange, the human must design âthe agent as a meta decision-making subject.â
The total amount of responsibility, if anything, increases. Itâs because the scope of impact is broader for the one layer you stepped down.
Example: the five elements of an email-processing agent
Staying abstract decides nothing. Letâs write out the five elements with a concrete example.
| Element | Content |
|---|---|
| Goal | Reduce the time the user spends processing email |
| Setting | Access to the Gmail API, signature template, human approval required for outbound mail, zero misdelivery is an absolute condition |
| Evaluation Criteria | Reply-quality score Ă low frequency of user intervention â misdelivery penalty (extremely large) |
| Input | Incoming email body, past sending history, calendar, contacts, user settings |
| Output Set | {draft creation, labeling, archiving, notify the user, ignore, escalate to a human} |
Once you write it out, you can see all at once whatâs fixed and what isnât.
For instance, if you put âlow frequency of user interventionâ into the evaluation criteria, the agent will choose actions that need no intervention. This is convenient, but as a side effect it creates the risk of âno longer notifying the user of important emails they should have noticed.â
Whether you put âzero misdelivery is an absolute conditionâ in the setting or in the evaluation criteria also changes how the agent behaves. As a setting, it becomes âa wall that must never be crossed.â As a penalty in the evaluation criteria, it becomes âsomething judged as a trade-off against other gains and the penalty.â
What you put where among the five elements is itself what determines the agentâs character. This is the entry point of agent design.
Part 2: The Sticking Points of Design, Element by Element
Each element has its own particular pitfall. Letâs go through them in order.
Goal: watch out for reward hacking
The agent moves to maximize the goal (the reward function / instructions). So if the goal is specified loosely, it gets optimized in an unintended direction.
A classic example: if you make the goal âmaximize user satisfaction,â it can turn out that the agentâs optimum is âdo nothing, within the range that doesnât make the user unhappy.â If you make the goal âmaximize the number of email replies,â it may churn out meaningless replies.
Put in terms of the decision map, this is the phenomenon where if the goal is reduced too crudely to a single scalar, an unexpected action that satisfies the goal gets picked out of the output set.
Directions for countermeasures:
- Decompose the goal into multiple evaluation-criteria terms (more on this below)
- Donât maximize the goal directly; put it in the form of âconstraint + a loose goalâ (using the duality relationship)
- Make runaway patterns explicit as constraints in the setting
Setting: the guardrails are the main body
For agent design, itâs fair to say this is where you should put the most design effort.
The setting is the totality of the premises, assumptions, and constraints under which the agent operates. Concretely:
- What tools can it call (APIs, execution environment)
- What actions are forbidden (delete-type commands, money transfers, sending)
- What environment it runs in (sandbox, production, read-only)
- Fallback on failure (timeouts, retry limits, human escalation)
- The boundary of observable state (context window, scope of memory)
If the design here is loose, no matter how carefully you write the goal or evaluation criteria, the agent will affect the world through an unintended route.
The setting = the work of deciding the agentâs âedge of the world.â Build it so the agent canât go past the edge. This is the security guarantee of agent design.
Evaluation criteria: what you can measure decides the behavior
Three things matter in designing evaluation criteria.
1. Make multiple terms explicit Maximizing a single scalar is dangerous. Make multiple weighted terms explicit, like âquality Ă speed â malfunction penalty + low human intervention.â How you weight the multiple terms is itself what determines the agentâs character.
2. Separate short-term from long-term Immediate success and long-term success need to be measured on different metrics. If you close things off to immediate optimization, actions get chosen that damage long-term trust. If you look only at the long term, it wonât move in the short term. Observe both, and weight both.
3. Decide the threshold at which a human intervenes Add an intervention trigger tied to the evaluation criteria, such as âhand off to a human if confidence is below a thresholdâ or âalways confirm before an irreversible action.â This is the implementation of a reversibility-based judgment â move fast in reversible territory, hand off to a human in irreversible territory.
Input: designing the context
Input = the information the agent can observe. In the context of LLM agents, this connects directly to the problem of context management.
The design questions are:
- What should the agent âneed to knowâ
- What should it âforgetâ (stale information, irrelevant information)
- How to use external knowledge (vector DBs, RAG)
- Where to pull user-specific context from (settings, past history, preferences)
If the design here is loose, the agent may have the right goal and evaluation criteria and still choose an off-target output because the input is impoverished. This is a common failure mode.
Output set: the space of actions it can take
Explicitly enumerate the space of actions the agent can choose. Leaving ânatural language generated by the LLMâ as the output set means anything can happen.
In implementation:
- Constrain the output space to a finite set via function calling (tool use)
- Limit free generation to âdraftsâ only; approve confirmed actions in a separate layer
- Always include âstopâ and âhand off to a humanâ as explicit outputs
An agent whose output set doesnât include âstopâ or âhand off to a humanâ will inevitably run out of control when it gets stuck. This is a life-or-death design issue.
Part 3: Using the Hierarchy â Sub-Agents and the Point of Human Intervention
The hierarchy is the source of freedom in agent design
I talked last time about how the decision map has a fractal structure. In agent design, you can use this as freedom in implementation.
Human
â designs
Orchestrator (upper-level agent)
â assembles the five elements of each individual task and assigns them out
Sub-agents A, B, C, âŠ
â decompose further into finer tasks
Tool calls / LLM inference
Each layer is its own decision map. The upper layer hands some of the lower layerâs five elements down as its âsetting.â
For instance, if the orchestrator hands a sub-agent âGoal: review the code, Setting: this repository, Output set: comments only,â the sub-agent assembles the remaining âevaluation criteriaâ and âinputâ from context and runs.
Cut the hierarchy well, and:
- Each layerâs responsibilities become clear
- Itâs easier to isolate which layer a failure happened in
- You can place points of human intervention only in the layers that need them
Put the point of intervention in âthe layer that has irreversibilityâ
Reversible actions can be left to the agent (if it fails, you can redo it). Irreversible actions need a human to intervene (if it fails, it canât be undone).
Rephrased in terms of the decision mapâs hierarchy:
In a layer that includes irreversible actions, donât move to execution until a human has approved that layerâs output.
Concretely:
- Sending email, deleting files, transferring money, deploying to production â the agent produces up to a draft; a human clicks to confirm
- Search, summarization, computation, drafting â leave to the agent
- Intermediate judgments (which tool to call) â basically leave to the agent, but confirm one level up on routes heading toward irreversibility
Some people worry that the human becomes a bottleneck, but thatâs really a question of whether the bottleneck is placed where it should be placed â pulling the bottleneck out of irreversible territory just causes accidents.
Separating intervention by reversibility â this becomes the implementation principle for using an agent with peace of mind.
Part 4: Failure Diagnosis â Which of the Five Elements Went Wrong
Replacing âAI is badâ with a structural diagnosis
The agent produced a disappointing output. Whether you write this off as âAI is badâ or isolate it as âwhich element, what design mistakeâ completely changes the path to improvement.
The five elements of the decision map can be used directly as a diagnostic checklist.
| Symptom | Element to suspect | Typical cause |
|---|---|---|
| Moved in an unexpected direction | Goal | Reward hacking, ambiguous instructions |
| Did something it shouldnât have | Setting | Gaps in the guardrails |
| Evaluation is bad even though it should be âcorrectâ | Evaluation Criteria | Short-term vs. long-term, biased items, wrong weights |
| Off-target output | Input | Insufficient context, misread context |
| The action options themselves are impoverished | Output Set | Coarse tool design, no stop/escalation |
| â Applies to all of the above | Hierarchical structure | Failed division of responsibility to sub-agents |
Just running through this checklist turns âAI is badâ into a concrete fix target, like âthe granularity of the goal design is coarseâ or âa tool restriction was missing from the setting.â
Fix from upstream
When multiple elements are off, where do you fix first? The rule of thumb is from upstream (goal â setting â evaluation criteria â input â output set).
The reason follows naturally from the fractal structure. An upstream element gives the interpretive frame for the downstream elements. Polishing only the evaluation criteria while the goal stays ambiguous leaves the evaluation criteria not knowing what to measure. Narrowing the output set while the setting stays loose just lets things leak through the gap.
âFix from upstreamâ is also the order with the lowest fix cost.
Before fixing, suspect one more level up
Even so, sometimes it wonât get fixed. Usually thatâs a meta-decision problem one level up: whether the agent itself should have been built at all.
- Should this task really be turned into an agent?
- Wouldnât a one-off use of AI be enough?
- Isnât this fundamentally something a human should be doing?
Whether you can ask this question is what makes all the difference in engineering quality. You need to keep doubting your own decision map, asking whether building the agent has become an end in itself.
Conclusion â The Person Who Designs the Five Elements Is the Person Who Takes on Responsibility
In a world where agents take over the decision-making of individual tasks, âwho decidedâ becomes hard to see.
A situation where you can say âAI made the judgmentâ or âthe algorithm chose itâ blurs where the responsibility lies. Thatâs exactly why the person who stands on the side of designing the agent must be able to put into words which part of the five elements they designed â which part is their own subjectivity, and which part is AIâs processing result.
This is the agent-era version of what I wrote in the previous post: âmaking the boundary between subjective and objective explicit.â
The point in one line:
Designing the agentâs five elements = putting into words, for yourself, the scope of subjectivity youâre taking on.
Whatever the agent does, it was a human who assembled its five elements. Only someone who doesnât forget this can stand as a responsible designer in the AI era.
The decision map is a map for not losing sight of that position.
References
- Toshiyasu Matsushima, âHow Should We Grasp and Teach Data Science? â Drawing on Waseda Universityâs Efforts,â Operations Research, Vol. 65, No. 10, 2020, pp. 544â550. https://orsj.org/wp-content/corsj/or65-10/or65_10_544.pdf
- Waseda University Data Science Education Team (author), supervised by Toshiyasu Matsushima, Introduction to Data Science I â Foundations of Data-Based Decision Making (Data Science Library 1), Science-sha, 2022.
