Subagent

​

Come funzionano i subagent

​

Costo dei subagenti

​

Quale modello usa un subagent?

​

Come influenzare il modello

1. Chiedere un profilo in linguaggio naturale. Richiedere un subagent explore (“research how auth works in an explore subagent”) mantiene il lavoro sul modello predefinito del subagent anziché sul modello che hai selezionato. Se chiedi modifiche al codice, viene usato subagent_general, che gira sul modello che hai selezionato.
2. Bloccare un modello in un profilo subagent personalizzato. model: nel file di definizione è l’unico modo per eseguire un subagent con capacità di scrittura su un modello diverso da quello dell’agente principale. Anche una skill eseguita in un subagent può impostare model: nel suo frontmatter per fare override del modello del profilo.
3. Impostare il tuo modello predefinito del subagent. agent.subagent_model nel tuo file di configurazione sostituisce il modello predefinito del subagent per le tue sessioni. Ha la precedenza sia sul router dei subagent sia sull’eventuale modello che un amministratore ha bloccato come predefinito del team; tuttavia non riabilita i subagent se l’impostazione dell’amministratore è None:
   // ~/.config/devin/config.json
   {
     "agent": {
       "subagent_model": "swe-1-6-fast"
     }
   }
   
   Si applica a subagent_explore e ai subagent personalizzati che non bloccano un model:; subagent_general continua invece a seguire il modello dell’agente principale. Il modello deve essere tra quelli consentiti dalla tua organizzazione, altrimenti l’impostazione viene ignorata e si usa il predefinito del team. L’impostazione vale per le nuove sessioni.

​

Controlli Enterprise

​

Abilitare e disabilitare i subagent

// ~/.config/devin/config.json
{
  "subagents_enabled": false
}

​

Profili dei subagent

​

Autorizzazioni degli strumenti

• I subagent in foreground si comportano come l’agente principale: ti viene chiesto di approvare o negare le chiamate agli strumenti, come di consueto. Il prompt indica il subagent che ha richiesto l’azione, così sai chi sta chiedendo.
• I subagent in background ereditano tutte le autorizzazioni degli strumenti che hai già concesso nella sessione corrente. Qualsiasi strumento che non sia stato pre-approvato viene negato automaticamente. I subagent in background non possono chiederti nuove autorizzazioni.

​

Monitoraggio dei subagenti

​

Indicatore del subagente

​

Pannello dei subagent

​

Passaggio tra foreground e background

• Spostare in background un subagente in foreground: Premi Ctrl+B mentre è in esecuzione un subagente in foreground. Il subagente continua a lavorare in background e l’agente principale riprende.
• Portare in foreground un subagente in background: Apri il pannello dei subagenti e premi f su un subagente in background in esecuzione. L’output del subagente verrà visualizzato inline.

​

Interrompere un turno

​

Annullare i subagent

1. Dal pannello dei subagent: Apri il pannello e premi x per un subagent in esecuzione.
2. Subagent in foreground: Premi Ctrl+C con l’input vuoto, oppure Esc due volte, per annullare il subagent in foreground attualmente in esecuzione. Se la bozza non è vuota, Ctrl+C cancella prima la bozza.

​

Ripresa dei subagenti

• Un subagente in background è terminato con errore perché è stato negato uno strumento richiesto: riprendilo in primo piano per concedere le autorizzazioni necessarie.
• Un subagente è stato completato, ma vuoi che esegua ulteriore lavoro di follow-up in base ai risultati ottenuti.
• Un subagente è stato annullato prematuramente e vuoi che continui.

​

Profondità di annidamento

Root agent (depth 0)
└── Custom subagent (depth 1) — può generare figli
    └── Child subagent (depth 2) — può generare figli
        └── Grandchild subagent (depth 3) — non può generare (limite di profondità raggiunto)

​

Subagenti personalizzati

​

Creazione di un subagent personalizzato

• File singolo — agents/<name>.md (la stessa convenzione usata da Claude Code, Cursor e altri strumenti). Il nome del file (senza .md) diventa l’identificatore del profilo.
• Directory — agents/<name>/AGENT.md. Il nome della directory diventa l’identificatore del profilo. Sono accettati come nome file anche AGENTS.md, agent.md e agents.md (se ne sono presenti più di uno, AGENT.md ha la precedenza, poi AGENTS.md, agent.md, agents.md).

.devin/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

.agents/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

# Linux/macOS
~/.config/devin/agents/
├── reviewer.md
└── researcher/
    └── AGENT.md

# Windows
%APPDATA%\devin\agents\
├── reviewer.md
└── researcher\
    └── AGENT.md

​

Formato del file di definizione

---
name: reviewer
description: Reviews code changes for correctness and style
model: sonnet
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

You are a code review subagent. Your job is to review code changes
thoroughly and report findings back to the parent agent.

Focus on:
1. Correctness — logic errors, edge cases, off-by-one mistakes
2. Security — potential vulnerabilities
3. Style — consistency with the rest of the codebase
4. Performance — obvious inefficiencies

Always cite specific file paths and line numbers in your findings.

​

Campi del frontmatter

​

Come vengono usati i subagenti personalizzati

​

Esempi

​

Agent di ricerca in sola lettura

---
name: researcher
description: Deep codebase research and architecture analysis
model: sonnet
allowed-tools:
  - read
  - grep
  - glob
---

You are a research subagent specializing in codebase exploration.

Your job is to thoroughly investigate a topic and report back with:
- Relevant files and their purposes
- Architecture patterns and dependencies
- Code flow traces with specific line references

Be exhaustive — search broadly and follow references.

​

Agente per l’esecuzione dei test

---
name: test-runner
description: Runs tests and reports results
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

You are a test runner subagent. Run the relevant test suites and report:
- Which tests passed and failed
- Failure messages and stack traces
- Suggestions for fixing failures