Skip to content

Toolset Agentization: Wrapping Co-Used Tools as Sub-Agents

Group frequently co-used tools into specialized sub-agents so the top-level planner chooses among fewer, coarser actions at each routing step.

The Action-Space Problem

A flat tool catalog forces the planner to select 1-of-N at every turn. Selection accuracy degrades as N grows: LongFuncEval (2025) reports 7–85% accuracy drops as tool catalogs expand, driven by the lost-in-the-middle effect (Liu et al., 2023) — correct tools become harder to locate among distractors. At hundreds of tools, a single planner cannot reliably reason about which combination achieves the goal.

The Pattern

Identify tools that are frequently co-used in production trajectories. Encapsulate each group behind a single agent tool — a sub-agent exposing one high-level interface to the planner, and orchestrating its owned leaf tools internally.

graph TD
    P[Top-level Planner] --> A1[Travel agent tool]
    P --> A2[Expense agent tool]
    P --> A3[Calendar agent tool]
    A1 --> T1[search_flights]
    A1 --> T2[hold_flight]
    A1 --> T3[book_flight]
    A2 --> T4[submit_expense]
    A2 --> T5[approve_expense]
    A3 --> T6[list_events]
    A3 --> T7[create_event]

The planner's action space shrinks from N leaf tools to K agent tools (K ≪ N). Each sub-agent then faces a small local catalog where selection accuracy is high. This is the core proposal of HTAA (Huang et al., 2026), which pairs the agentization step with Asymmetric Planner Adaptation — a trajectory-based fine-tuning method that aligns the planner's expected invocation signature with the new agent tools via backward reconstruction and forward refinement.

The authors report — against flat baselines — "higher task success rates, shorter tool calling trajectories, and significantly reduced context overhead" on public benchmarks, plus production deployment at a ride-hailing platform that "substantially reduces manual validation effort and operational cost" (source).

Positioning Versus Adjacent Patterns

Three existing patterns address the same scaling problem with different mechanisms:

Pattern Mechanism When it fits
Tool Search Dynamic, stateless lazy discovery — planner queries a search tool on demand Any library size; no pre-grouping; works without fine-tuning
Filesystem-Based Tool Discovery Filesystem-organised lazy loading from a directory tree Large MCP tool collections; directory structure mirrors domains
Consolidate Agent Tools Merge always-co-called leaves into one tool Tools always called together with no independent use
Toolset Agentization Wrap co-used groups behind a sub-agent interface Hundreds of tools clustered into reusable sub-capabilities; you can fine-tune the planner

Agentization is intermediate between consolidation (collapses the leaves) and full multi-agent orchestration (independent agents negotiating): the sub-agent is still called as one tool, but internally it retains a full sub-catalog and its own reasoning step.

Why It Works

Agentization reduces the effective action space visible to the top-level planner at each decision. Anthropic's advanced tool use benchmarks show the same mechanism at work in a different form: deferring tools until search lifts Opus 4.5 from 79.5% to 88.1% selection accuracy — the model chooses among 3–5 surfaced tools rather than the full catalog. Agentization achieves the smaller-surface effect statically, at design time, instead of dynamically per request. The asymmetric adaptation training step closes the gap that static grouping alone leaves open: without it, the planner invokes the agent tool with the signature it learned on flat catalogs (HTAA, 2026).

When This Backfires

Agentization commits to a static partition. Specific conditions invert its benefits:

  • Usage patterns drift — "frequently co-used" today need not hold in six months. A stale partition forces the planner to route around wrappers or invoke multiple agent tools where one flat call would have sufficed.
  • Sub-agent opacity on failure — the planner sees an aggregate error, not which leaf failed. Debugging regresses versus a flat catalog, mirroring the opacity trap flagged in Consolidate Agent Tools.
  • Training dependency — Asymmetric Planner Adaptation requires fine-tuning access. Teams on frontier proprietary models (Claude, GPT-4) inherit only the structural change.
  • Cross-agent coordination — when two agent tools share a leaf (calendar, auth), the hierarchy forces either leaf duplication or inter-agent coupling the planner must resolve. Multi-agent system failures research shows agents frequently disobey role specifications; sub-agent tools inherit this risk.
  • Small-to-moderate libraries — HTAA targets "hundreds of tools." Below ~30–50 tools, sub-agent overhead exceeds the gains Tool Search or Consolidate Agent Tools deliver with less infrastructure.

Example

A customer-service agent starts with 120 leaf tools spanning billing, shipping, returns, and account management. The flat catalog consumes roughly 40K tokens in definitions and produces frequent wrong-tool selections on boundary cases (e.g., update_shipping_address invoked for a billing change).

Before — flat catalog:

tools:
  - get_invoice
  - list_invoices
  - refund_charge
  - dispute_charge
  - track_shipment
  - update_shipping_address
  - initiate_return
  - accept_return
  # ... 112 more

After — agentized:

tools:
  - name: billing_agent
    description: Resolve invoice, refund, and dispute questions. Handles all charge-related workflows end to end.
  - name: shipping_agent
    description: Track shipments, update delivery addresses, handle carrier issues.
  - name: returns_agent
    description: Initiate and process product returns, including RMA generation and refund handoff.
  - name: account_agent
    description: Profile, subscription, and authentication changes.

The planner now chooses among four agent tools per turn. Each sub-agent internally selects from a scoped local catalog (15–40 leaves) where "lost-in-the-middle" pressure is negligible. The top-level definition footprint drops substantially; wrong-domain selections collapse because there is no billing leaf visible when the model is routing a shipping intent.

Key Takeaways

  • Agentization reduces the planner's effective action space at each step by one structural level — from leaf tools to sub-agent capabilities.
  • Pair structural grouping with Asymmetric Planner Adaptation when fine-tuning is available; structure alone leaves invocation drift unresolved.
  • Prefer dynamic discovery (Tool Search) when tool usage patterns shift or when you cannot fine-tune — static partitions calcify.
  • Sub-agent wrappers inherit the opacity-on-failure trap — aggregate errors mask which leaf actually failed.
  • At 20–50 tools, cheaper patterns (Consolidate, Tool Search) deliver the scaling gain without the sub-agent infrastructure.
Feedback