Subagentes

​

Como os subagentes funcionam

​

Custo dos subagentes

​

Qual modelo um subagente usa?

​

Influenciando o modelo

1. Peça um perfil em linguagem natural. Solicitar um subagente de exploração (“pesquise como a autenticação funciona em um subagente de exploração”) mantém o trabalho no modelo padrão do subagente, em vez do modelo selecionado. Pedir alterações no código direciona você para subagent_general, que é executado no modelo selecionado.
2. Fixe um modelo em um perfil de subagente personalizado. model: no arquivo de definição é a única forma de executar um subagente com capacidade de escrita em um modelo diferente do agente principal. Uma skill executada em um subagente também pode definir model: no frontmatter para aplicar override ao modelo do perfil.
3. Defina seu próprio modelo padrão de subagente. agent.subagent_model no seu arquivo de configuração substitui o modelo padrão de subagente nas suas sessões. Essa configuração tem precedência tanto sobre o roteador de subagentes quanto sobre um modelo que um administrador tenha fixado como padrão da equipe, mas não reativa os subagentes quando a configuração do administrador está definida como Nenhum:
   // ~/.config/devin/config.json
   {
     "agent": {
       "subagent_model": "swe-1-6-fast"
     }
   }
   
   Ela se aplica ao subagent_explore e aos subagentes personalizados que não fixam um model:; o subagent_general continua seguindo o modelo do agente principal. O modelo precisa ser permitido pela sua organização; caso contrário, a configuração é ignorada e o padrão da equipe é usado. A alteração vale para novas sessões.

​

Controles do Enterprise

​

Ativar e desativar subagentes

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

​

Perfis de subagente

​

Permissões de ferramentas

• Subagentes em primeiro plano se comportam como o agente principal — você recebe solicitações para aprovar ou negar chamadas de ferramentas, como de costume. A solicitação identifica o subagente que requisitou a ação, para que você saiba quem está solicitando.
• Subagentes em segundo plano herdam todas as permissões de ferramentas que você já concedeu durante a sessão atual. Qualquer ferramenta que não tenha sido pré-aprovada é negada automaticamente. Subagentes em segundo plano não podem solicitar novas permissões.

​

Monitoramento de subagentes

​

Indicador de subagente

​

Painel de subagentes

​

Alternar entre primeiro plano e segundo plano

• Mover um subagente em primeiro plano para segundo plano: Pressione Ctrl+B enquanto um subagente em primeiro plano estiver em execução. O subagente continua trabalhando em segundo plano, e o agente pai é retomado.
• Trazer um subagente em segundo plano para primeiro plano: Abra o painel de subagentes e pressione f em um subagente em segundo plano que esteja em execução. A saída do subagente será exibida inline.

​

Interrompendo um turno

​

Cancelando subagentes

1. No painel de subagentes: Abra o painel e pressione x no subagente em execução.
2. Subagente em primeiro plano: Pressione Ctrl+C com o campo de entrada vazio, ou Esc duas vezes, para cancelar o subagente em primeiro plano que está em execução. Se houver um rascunho em andamento, Ctrl+C primeiro limpa o rascunho.

​

Retomando subagentes

• Um subagente em segundo plano falhou porque o uso de uma ferramenta obrigatória foi negado — retome-o em primeiro plano para conceder as permissões necessárias.
• Um subagente foi concluído, mas você quer que ele faça um trabalho complementar com base em seus resultados.
• Um subagente foi cancelado prematuramente e você quer que ele continue.

​

Profundidade de aninhamento

Root agent (depth 0)
└── Custom subagent (depth 1) — pode criar filhos
    └── Child subagent (depth 2) — pode criar filhos
        └── Grandchild subagent (depth 3) — não pode criar filhos (limite de profundidade atingido)

​

Subagentes personalizados

​

Criando um subagente personalizado

• Arquivo simples — agents/<name>.md (a mesma convenção usada por Claude Code, Cursor e outras ferramentas). O nome do arquivo (sem .md) se torna o identificador do perfil.
• Diretório — agents/<name>/AGENT.md. O nome do diretório se torna o identificador do perfil. AGENTS.md, agent.md e agents.md também são aceitos como nome de arquivo (se houver vários, AGENT.md tem precedência, seguido por AGENTS.md, agent.md e 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 do Arquivo de Definição

---
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.

​

Campos do frontmatter

​

Como os subagentes personalizados são usados

​

Exemplos

​

Agente de Pesquisa em Modo Somente Leitura

---
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 de execução de testes

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

Você é um subagente executor de testes. Execute os conjuntos de testes relevantes e reporte:
- Quais testes passaram e falharam
- Mensagens de falha e rastreamentos de pilha
- Sugestões para corrigir as falhas