01. Why Split The Work
A single agent with too many tools often produces lower quality outcomes. The agent can lose track of which directory it is in. A tool that asks for a relative location reference leads to frequent errors. To fix this, the designers changed the tool to always require a full absolute location reference. That simple change made the agent use the tool perfectly. This shows that careful tool design prevents many mistakes. Another approach splits the work across focused specialists. One agent evaluates safety risk. Another agent provides a second assessment. A judge agent then reads both arguments and selects the best expert. That expert handles the chosen risk level. This way each specialist has a narrow job. The result is higher quality decisions. The price is the need for coordination between agents. The judge agent must weigh the evidence from both sides. This added step ensures the correct specialist is chosen. So broader single tools lead to errors, while focused specialists with clear roles improve reliability. The coordination overhead is a worthwhile trade-off.
Debate Agent Router uses two specialist agents and a judge.
# Judge Agent gamma reads the debate state and outputs a sufficiency label,
# an adjudicated risk level, and the selected expert.
# The selected expert follows the adjudicated Low/Medium/High routing signal.
# Low, Medium, and High correspond to Qwen3-VL-2B, Qwen3-VL-4B, and Qwen3-VL-8B.
Imagine a kitchen where a single chef is responsible for every dish: chopping, grilling, plating, even managing the pantry. When the menu is simple, that works fine. But as orders pile up and dishes become complex, the chef gets overloaded, forgets which ingredient is where, and starts making mistakes—burning steaks or using the wrong sauce. That’s exactly the problem this subsystem solves. It’s for splitting a big, confusing job among a team of dedicated specialists so each can focus on what they do best.
In practice, instead of giving one agent a huge set of tools (like a chef with too many knives and pans), the system assigns separate agents to handle specific roles. One agent might evaluate safety risk, another provides a second opinion, and a third judge reads both arguments to make a final decision. The source describes concrete patterns: a Subagent pattern where a main agent delegates tasks to helper agents as tools; a Handoff pattern where the conversation gets transferred directly to a specialist; and a Router that instantly classifies incoming work and sends it to the right expert. Each pattern uses a different number of calls—for example, Subagents take four calls per task because results must flow back through the main agent, while Handoffs use just two.
The trickiest part is that splitting work adds overhead, and choosing the wrong pattern makes things worse. For instance, Subagents are “stateless by design”—each new request starts the same flow from scratch, so if the same customer orders twice, the agent doesn’t remember the previous order and redoes all four calls each time. A Handoff pattern, on the other hand, keeps conversation context, so the second order only needs two calls. Without this careful splitting, a single overburdened agent with too many tools would lose track of which directory it is in, pick the wrong tool, and deliver a useless or even dangerous result—exactly like a burnt steak or a wrong sauce.
The subsystem’s ordered mechanism begins with a design principle from the Building effective agents article: the agent-computer interface (ACI) is first crafted to require a full absolute location reference, eliminating the prior relative-location tool that caused the agent to lose track of its directory. After this ACI refinement, the system splits the work across focused specialists using a Debate Agent Router from the autonomous driving paper. The Base VLM/Question Generator first produces perception, planning, and prediction questions; the router then dispatches each question to the appropriate expert agent. On failure—for instance if the router cannot match a question to a domain expert—a traceable routing log is produced, allowing operators to inspect the decision.
The invariant the design preserves is traceable expert-routing, explicitly named as such in the source. This guarantee means every routing decision is inspectable, addressing the opaqueness of traditional latent-feature gates. The ACI change independently upholds the simpler invariant of maintain simplicity and prioritize transparency from the Anthropic article—by requiring absolute references, the tool’s behavior is fully predictable and the agent’s state is never ambiguous, enforcing a clear “write boundary” on the agent’s location awareness.
The key trade-off is rejecting the obvious alternative of a single monolithic agent with many tools. That alternative would rely on complex frameworks or opaque Mixture of Experts routers that hide reasoning failures behind latent gates. The Building effective agents article explicitly warns that “agentic systems often trade latency and cost for better task performance,” and the monolithic agent would compound errors from relative-path confusion. By splitting work via the Debate Agent Router and enforcing absolute references through the ACI, the design accepts the cost of additional infrastructure (a separate router and specialist agents) but avoids the far higher cost of non‑inspectable, error‑prone tool usage that would undermine reliability and require extensive debugging.
A concrete failure mode arises when a relative-location tool is accidentally reintroduced or bypassed. An operator would see repeated errors in the agent’s logs such as “directory not found” or “invalid relative path” entries, indicating the agent has lost track of its current directory. In the router’s domain, if the Base VLM/Question Generator produces a question that falls outside the defined expert domains (e.g., a safety question routed to a planning expert), the operator would observe a traceable routing assignment with low confidence or an explicit misrouting flag in the router logs, signaling a question‑generation failure that needs to be addressed through further ACI iteration.
Failure 1: Directory Tracking Loss Due to Relative Location Reference
- Trigger: The agent is handed a tool that asks for a relative location reference instead of an absolute one.
- Guard: The designers changed the tool to always require a full absolute location reference — this is a design-time guard, not an exception handler.
- Posture: fail‑soft — the agent continues to operate but produces frequent errors (the source says “leads to frequent errors”).
- Operator signal: Frequent errors in any operation that depends on directory awareness; the agent’s output shows incorrect file paths or stale directory context.
- Recovery: No automatic retry or fallback in the source. The manual step is to redesign the offending tool to enforce an absolute reference, as the designers did.
Failure 2: Lower Quality Outcomes from Tool Overload
- Trigger: A single agent is given “too many tools” to manage.
- Guard: No guard is shown in the source for this failure mode. The text only states that “a single agent with too many tools often produces lower quality outcomes” without describing any runtime protection.
- Posture: fail‑soft — the agent continues to operate but delivers degraded quality.
- Operator signal: The operator observes “lower quality outcomes” — for example, inconsistent or suboptimal decisions across tasks.
- Recovery: The source suggests a design‑level remedy: “splits the work across focused specialists.” This is a manual re‑architecture, not an automatic recovery.
Failure 3: Relative Reference Tool Error (Distinct Trigger from Failure 1)
- Trigger: A tool that specifically “asks for a relative location reference” is invoked.
- Guard: The same design change — requiring a full absolute location reference — prevents this failure.
- Posture: fail‑soft — the agent can still make calls, but each call using that tool “leads to frequent errors.”
- Operator signal: Repeated error messages or incorrect paths when the tool is used; the error is tied to the relative reference pattern.
- Recovery: The tool must be redesigned to require an absolute reference; no automatic retry is documented.
Failure 4: Safety Risk Evaluator Agent Makes an Erroneous Assessment
- Trigger: The safety risk evaluator agent (one of the focused specialists) is given a scenario with ambiguous or misleading data.
- Guard: No guard is mentioned in the source for this agent’s individual error. The framework relies on a second assessment and a judge agent, but no validation or exception handler for the evaluator itself is specified.
- Posture: fail‑soft — the evaluator’s incorrect assessment is passed forward; the system may still continue because the judge agent will read both arguments.
- Operator signal: The operator would see a discrepancy between the safety risk evaluation and the second assessment, or the judge’s final decision might be inconsistent.
- Recovery: No automatic recovery is shown. The operator may need to manually inspect the arguments or re‑run the evaluator with corrected input.
Failure 5: Judge Agent Fails to Reconcile Conflicting Arguments
- Trigger: The judge agent receives two contradictory arguments from the safety evaluator and the second assessment agent.
- Guard: No guard is presented in the source for the judge’s reconciliation failure. The system has no retry, fallback, or validation on the judge’s output.
- Posture: fail‑soft — the judge produces a possibly flawed final decision, and the pipeline continues; the output is unreliable but does not abort.
- Operator signal: The final decision may be logically inconsistent or not match either assessment; the operator notices a mismatch in the chain of reasoning.
- Recovery: No recovery is defined in the source. A manual review of both arguments by a human is required to correct the judge’s output.