![\"Diagrama:](\"https:\/\/pletzenauer.com\/wp-content\/uploads\/2026\/06\/infographic-sub-agents.png\")
O que \u00e9 um sub-agent<\/h2>\n\n\n\n
A sess\u00e3o principal \u00e9 o orquestrador. \u00c9 a inst\u00e2ncia com quem fala. \u00c9 ela que arranca sub-agents aut\u00f3nomos e lhes atribui tarefas.<\/p>\n\n\n\n
Cada sub-agent trabalha num contexto pr\u00f3prio e novo. Devolve apenas um resultado compacto. Os sub-agents falam com a sess\u00e3o principal, nunca entre si.<\/p>\n\n\n\n
Porque compensam<\/h2>\n\n\n\n
H\u00e1 quatro raz\u00f5es que tornam os sub-agents \u00fateis.<\/p>\n\n\n\n
- Contexto limpo.<\/strong> A pesquisa, os registos longos e os relat\u00f3rios extensos ficam fora do chat principal.<\/li>
- Trabalho em paralelo.<\/strong> Muitas tarefas independentes correm ao mesmo tempo em vez de umas atr\u00e1s das outras.<\/li>
- Modelos baratos.<\/strong> O trabalho de rotina fica a cargo de um modelo pequeno, a dire\u00e7\u00e3o a cargo de um modelo forte.<\/li>
- Revis\u00f5es honestas.<\/strong> Um agente novo n\u00e3o est\u00e1 condicionado a concordar consigo.<\/li><\/ul>\n\n\n\n
Integrados ou constru\u00eddos por si<\/h2>\n\n\n\n
O Claude Code traz sub-agents gen\u00e9ricos. Al\u00e9m disso, pode construir agentes pr\u00f3prios e especializados. Um sub-agent n\u00e3o \u00e9 mais do que um ficheiro Markdown.<\/p>\n\n\n\n
No topo est\u00e1 o frontmatter YAML: nome, descri\u00e7\u00e3o, modelo e ferramentas permitidas. A descri\u00e7\u00e3o \u00e9 a alavanca mais importante. \u00c9 ela que decide se o agente serve para a tarefa.<\/p>\n\n\n\n
Um erro frequente na pr\u00e1tica \u00e9 uma aspa esquecida. A estrutura parte-se e o agente nunca chega a arrancar.<\/p>\n\n\n\n
Ao n\u00edvel do projeto ou global<\/h2>\n\n\n\n
Os agentes ligados ao projeto ficam no reposit\u00f3rio e viajam com ele. Os agentes globais ficam na sua pasta de utilizador e pertencem apenas a si.<\/p>\n\n\n\n
Regra pr\u00e1tica: se a equipa o vai usar, pertence ao projeto. Mov\u00ea-lo \u00e9 trivial, afinal \u00e9 apenas um ficheiro.<\/p>\n\n\n\n
Quando usar um sub-agent \u2014 e quando n\u00e3o<\/h2>\n\n\n\n
Nem todas as tarefas precisam de um sub-agent. Demasiados conduzem muitas vezes a piores resultados. Uma pergunta simples ajuda.<\/p>\n\n\n\n
Isto vai despejar j\u00e1 uma montanha de informa\u00e7\u00e3o no meu chat que nunca mais volto a ler? Se sim, delegue. Se n\u00e3o, fica na sess\u00e3o principal.<\/p><\/blockquote>\n\n\n\n
Use sub-agents quando forem lidos muitos ficheiros, quando houver tarefas a correr em paralelo ou quando quiser uma revis\u00e3o imparcial.<\/p>\n\n\n\n
Prescinda deles em altera\u00e7\u00f5es pequenas, em passos que dependem uns dos outros ou quando o agente teria de fazer uma pergunta de esclarecimento.<\/p>\n\n\n\n
Fluxos de trabalho din\u00e2micos e \u00abultra code\u00bb<\/h2>\n\n\n\n
Desde o Opus 4.8 existem fluxos de trabalho din\u00e2micos. A sess\u00e3o principal arranca ent\u00e3o automaticamente muitos sub-agents em paralelo. \u00c9 poderoso, mas consome depressa o seu limite de sess\u00e3o.<\/p>\n\n\n\n
Foi por isso que a palavra-gatilho mudou de \u00abworkflow\u00bb para \u00abultra code\u00bb. Assim, nenhum fluxo de trabalho grande arranca por engano. Use a ferramenta de forma consciente.<\/p>\n\n\n\n
Levar as permiss\u00f5es a s\u00e9rio<\/h2>\n\n\n\n
Se um agente pode ler ou alterar dados, tem de partir do princ\u00edpio de que um dia o far\u00e1. Por isso, liberte apenas as ferramentas de que ele realmente precisa.<\/p>\n\n\n\n
Para agentes de pesquisa e de verifica\u00e7\u00e3o isso significa, na maior parte dos casos: s\u00f3 leitura. Em ficheiros de agentes de origem externa, verifique previamente poss\u00edveis prompt injections.<\/p>\n\n\n\n
A minha promessa<\/h2>\n\n\n\n
Os sub-agents n\u00e3o s\u00e3o um fim em si mesmos. S\u00e3o uma ferramenta de divis\u00e3o do trabalho. O ganho \u00e9 menos ru\u00eddo no chat, custos mais baixos e um olhar imparcial sobre o seu trabalho.<\/p>\n\n\n\n
A minha promessa: s\u00f3 recomendo sub-agents onde ajudem de forma mensur\u00e1vel. A automatiza\u00e7\u00e3o \u00e9 mais do que hype de IA.<\/p>\n\n\n\n
- Trabalho em paralelo.<\/strong> Muitas tarefas independentes correm ao mesmo tempo em vez de umas atr\u00e1s das outras.<\/li>