Where the roster comes from
An expert can only delegate to experts in its roster. That roster has two sources. Source one: the whitelist (auto-injected) In personalization settings, set the delegation policy to whitelist and pick specific experts. Maximum 10. Source two: @-mentions (effective under every policy) @-mention an expert in the composer and it merges into the head of the roster — even under policynone, even if it is not whitelisted. An explicit mention counts as stronger intent than a toggle.
Either way, an expert only enters the roster if all of these hold:
Failures are filtered silently: put 5 on the whitelist, have 3 resolve, and nothing is reported in the conversation — the other 2 simply are not in the roster. A roster build failure is also non-blocking; that turn just has no delegation capability.
Mentioning two or more makes delegation mandatory
This is a hard behavioral hinge:- One @-mention: advisory. The model may delegate or may do the work itself — a single mention is often just a reference.
- Two or more: a mandatory directive is injected. The model must call the delegate tool once for each mentioned expert, must not do their parts itself, must not skip any, and must synthesize all results at the end.
If you also @-mentioned the current expert, that part is its own to execute directly — it is not in the roster and needs no delegate call.
Background by default
Delegation runs in the background by default: the tool returns a job handle immediately, the main expert keeps working or replies to you, and the specialist’s result is injected back automatically when it finishes. The model only switches to blocking when it genuinely cannot proceed without the result in the same turn. The execution budget is fixed at 900 seconds (15 minutes), matched on both the server and runtime sides, and cannot be extended — passing a longer timeout only changes how long the local call waits, never how long the specialist gets. A timeout gives you an explicit signal:Delegation versus multi-task subagents
Both farm work out, but they are different things:
Both obey the same constraint: whoever is dispatched does not receive the delegate or task tools (they are L1-reserved), so the chain cannot recurse indefinitely. A specialist also cannot modify the main conversation’s plan document.
Costs stack
Two practical ways to keep it down:- Only whitelist experts you actually use. The roster occupies system-prompt space; ten expert briefs sit in context every turn.
- Write complete task descriptions. The specialist cannot see your conversation history, and an underspecified task makes it flail — far more expensive than two extra sentences.
Where the roster briefs come from
The one-line brief shown for each candidate resolves in this order: the creator’s delegation brief → the expert description → an empty string. For creators this is a field worth caring about: it decides whether other experts think of you at the right moment. “Turns messy data into charts with statistical conclusions” is far more useful than “data analysis expert.”Failures and what to do
FAQ
Does delegation pollute the main conversation's context?
Does delegation pollute the main conversation's context?
No. The specialist runs in an independent session and only sees the task description passed to it, never your history. What comes back is a structured summary, not its full transcript.
Can I turn delegation off entirely?
Can I turn delegation off entirely?
Yes. Set the policy to
none and @-mention no one; the main expert gets no roster and therefore cannot delegate.Does the specialist use its own memory?
Does the specialist use its own memory?
Yes — it executes with its own skills and memory, which is the whole point. It does not read your memories from the main conversation.
Does a completed delegation leave a trace?
Does a completed delegation leave a trace?
Yes. A completed delegation (expert, task summary, result, duration) is written into your memory as one entry, best-effort — a failure there never affects the conversation.
Keep reading
Personalization
Delegation policy, whitelist, and the multi-task toggle
Subagents and delegation
Parallel division of labor inside one expert
Configure your expert
Creator side: the delegatable flag and delegation brief
Billing formulas
How token_split is computed

