Your AI agent is drowning in its own context. Give it a team.

Posted on Nov 3 • Originally published at blog.bytechef.io

You ask an agent to research three options and recommend one.

It gathers facts. Compares notes. Second-guesses itself. All of that lands in its context window.

Then it has to write the answer, with its attention split across everything it tried along the way.

The agent isn't too dumb. It's too cluttered.

If you've built anything agentic, you've hit this ceiling. Here's how subagents fix it, and how we run them in ByteChef, an open-source workflow automation and AI agent platform built on Java and Spring.

The Spring AI team names both problems in their subagent post:

The fix is delegation. The main agent becomes an orchestrator. It hands focused jobs to subagents and keeps only what they report back.

Each subagent works in its own context, with its own instructions, model and tools. Its mess stays with it.

The Research and write with subagents template has three steps, with a small team inside the agent:

The orchestrator's system prompt tells it not to do the work itself:

You are an orchestrator. Do not answer research questions yourself. Delegate fact gathering to the researcher subagent, then pass its findings to the writer subagent, and return the writer's answer. Enter fullscreen mode Exit fullscreen mode The two subagents split the work by cost and quality:

# researcher You are a fast, precise researcher. Collect the key facts needed to answer the task. Return 5 to 10 short bullets with no introduction and no conclusion. If you are unsure of a fact, say so. # writer You turn research findings into a clear answer for Java developers. Short sentences, concrete, no marketing language. End with a one-line recommendation. Enter fullscreen mode Exit fullscreen mode Research is many small, factual steps, so it runs on a fast, cheap model. The answer is what the user reads, so it gets the stronger one. The orchestrator only coordinates.

The Task tool comes from the spring-ai-agent-utils library, which ByteChef ships. When a message arrives:

orchestrator -> Task(researcher, research prompt) returns short bullets -> Task(writer, prompt with those bullets) returns the final answer Enter fullscreen mode Exit fullscreen mode The orchestrator's context holds two short tool results, not the work behind them.

Here's the first Task call from a real test run, in the AI Agent's Logs tab. The orchestrator wrote a research-only prompt, and the researcher's findings came back as the tool's output.

There's a second tool too, TaskOutput. The library lets the orchestrator start a subagent in the background and collect its result later, so independent jobs can run at the same time.

ByteChef runs Spring AI's TaskTool and TaskOutputTool, so the delegation model is the same. What changes is where you define the team:

On the canvas, you add the Task Tool to the AI Agent's Tools slot from the AI Agent Utils component, then add one Subagent per team member. Each subagent has three fields:

We've built orchestrator-workers before as a workflow pattern. There you lay out each step and wire the flow yourself. The Task Tool is the in-agent version: you define the team, and the agent decides at run time who does what, and in what order.

Use a workflow when the steps are fixed. Use subagents when the agent should plan the split itself.

Should our Spring Boot service move from Java 21 to Java 25 this year? Enter fullscreen mode Exit fullscreen mode The orchestrator should call researcher first and writer second. Ask a follow-up and Chat Memory keeps the conversation going, while each subagent call still starts from a clean context.

To watch the delegation, test the agent in the editor and open the tool-call cards. Each Task call shows which subagent ran, the prompt it got and what it returned.

If the orchestrator skips a subagent or calls the wrong one, its description is usually too vague.

An agent gets better by doing less itself.

Delegation isn't mainly about speed. It keeps each context clean and each prompt focused. The messy middle of every job happens somewhere else, and only the answer comes back.

Got an agent struggling with a job that's really three jobs? Import the template, ask it a question that needs research, and watch it hand the work out.

This is Part 4 of our AI Agentic Patterns series. Part 1 covered Agent Skills, Part 2 covered asking the user, and Part 3 covered todo lists. If you like where ByteChef is going, a star on GitHub helps a lot.

Originally published on the ByteChef blog.