How-To Guides

Delegate to subagents

A subagent is a helper your main agent can hand a smaller job to.

Delegate to subagents

Sometimes one agent should focus on the big picture and let a specialist handle a small part. A subagent is that specialist. Your main agent can hand it a job and use the result.

Make a subagent

A subagent looks just like an agent. It usually does one thing well:

subagents/researcher.nt
subagent researcher
  description: Finds the year an event happened.
  instructions: |
    Given a single event, reply with the year it happened, or a tight range,
    and nothing else.

Let your agent use it

List the subagent under subagents on the main agent:

agent age
  model: anthropic/claude-sonnet-5
  subagents:
    - researcher
  instructions: |
    Guess the person's age. When a clue mentions an event, ask the researcher
    for the year it happened, then use that.

Now the main agent can hand the "what year was this?" question to the researcher whenever it needs to.

How it works

When you give an agent a subagent, NT quietly adds a way for it to call that helper. The main agent decides when to use it, sends over the small job, and gets the answer back to keep working.

Good to know

A subagent uses your project defaults for things like its model, not the main agent's settings. It does share the main agent's sandbox while it helps, so they work in the same space.

Next