Un subagent è la delega applicata agli agenti: affidi un lavoro a un nuovo esecutore e ricevi indietro solo la risposta.
Come funziona
L’agente principale decide che un compito è autonomo, per esempio «trova tutti i chiamanti di questa funzione» o «esegui la suite di test e riporta i fallimenti». Avvia un subagent con una descrizione del compito. Il subagent esegue il proprio ciclo agentico e restituisce un risultato.
La documentazione di Claude Code lo spiega così: “Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.” (traduzione: ogni subagent gira nella propria finestra di contesto, con un system prompt personalizzato, accesso a strumenti specifici e permessi indipendenti.) Un subagent si definisce come file Markdown con frontmatter YAML, a livello di progetto in .claude/agents/:
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---
You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
Tra i vantaggi elencati: tenere l’esplorazione fuori dalla conversazione principale, limitare gli strumenti che un subagent può usare e indirizzare i compiti verso modelli più economici.
Altri framework hanno idee simili. L’OpenAI Agents SDK dice che “Handoffs allow an agent to delegate tasks to another agent” (traduzione: gli handoff permettono a un agente di delegare compiti a un altro agente), e presenta ogni handoff al modello come uno strumento.
L’articolo di Anthropic sul context engineering descrive lo schema dal lato del contesto: ogni sub-agente lavora in una finestra di contesto pulita e “returns only a condensed, distilled summary of its work” (traduzione: restituisce solo un riepilogo condensato e distillato del proprio lavoro), spesso da 1.000 a 2.000 token.
Perché è importante
- Contesto. Un’esecuzione dei test può stampare decine di migliaia di token. In un subagent, quell’output resta fuori dalla finestra di contesto principale; torna indietro solo il riepilogo. È uno strumento centrale del context engineering.
- Costo. I token totali di solito aumentano, perché ogni subagent carica il proprio prompt e i propri strumenti. L’articolo sul costo dei sistemi multi-agente stima il moltiplicatore.
- Parallelismo. I subagent che girano contemporaneamente sono richieste parallele. Il limite di concorrenza del tuo provider decide quanti ne girano insieme.
Su BroadNet Inference
BroadNet serve i modelli; la logica dei subagent sta nel tuo strumento agentico. Qualsiasi strumento che accetta un base URL compatibile con OpenAI può puntare su BroadNet sia l’agente principale sia i subagent, e può usare modelli diversi per ciascuno.
Con il pagamento a consumo, una chiave consente 4 richieste in corso. Sui piani flat per DeepSeek V4.1 Flash, ogni sessione esegue una richiesta alla volta, quindi conta le richieste al modello che possono essere in corso nello stesso momento: tre subagent attivi insieme richiedono tre sessioni, e quattro se anche l’orchestratore chiama il modello mentre lavorano. Eseguire agenti di programmazione in parallelo su un’API flat spiega in dettaglio il conteggio delle sessioni.