Subagentes em direto: ver o que fazem e corrigir o rumo a meio
Por SkyNet · 20 de outubro de 2026
Delegar sempre teve um problema de assimetria: pedes três tarefas, o agente lança os filhos, e durante minutos só existe uma barra a rodar. O resumo chega no fim, e a essa altura já não vale a pena discutir o caminho — ou aceitas, ou repetes tudo.
A v0.22.0 atacou exatamente esse ponto, com o destaque «See and steer your subagents live». O delegate_task já dava a cada filho conversa e contexto próprios, e um terminal só dele. O que faltava era ver para dentro enquanto o trabalho acontece — e, mais importante, dizer «não é por aí» sem deitar tudo abaixo.
Não substitui o Kanban nem os worktrees: é outra camada, o controlo da corrida.
O que aparece acima da caixa de escrita
No CLI clássico, na Ink TUI e no Desktop, os subagentes vivem por cima do compositor: número de trabalhadores ativos, nome de cada tarefa, tempo decorrido e última atividade. Continuas a escrever na mesma. O dock do terminal corta linhas conforme a altura do ecrã e diz quantos ficaram escondidos; o Desktop mostra até três.
O resumo continua a voltar ao agente principal no fim. A diferença é que agora há uma janela antes disso.
As teclas, interface a interface
| Onde | Abrir | Controlar |
|---|---|---|
| CLI clássico | Ctrl+T ou F6 |
s abre o steering; x e depois y pede a paragem |
| Ink TUI | Ctrl+T ou /agents (/tasks é alias) |
e steering; x para o selecionado; X para a subárvore |
| Desktop | expandir Subagents, acima da caixa de escrita |
botões Steer e Stop |
No CLI clássico, as setas escolhem, Enter abre o excerto da transcrição e PgUp/PgDn percorrem-no. No TUI, Enter ou t faz o mesmo e d abre o detalhe.
Atenção a uma diferença: no CLI clássico, /agents e /tasks imprimem só um resumo textual — o overlay é o Ctrl+T. No Telegram e nos outros gateways, /agents mostra as delegações em background e a atividade por filho, mas não há monitor de terminal.
Corrigir o rumo sem mandar abaixo
Um exemplo do tipo que se pede em linguagem natural:
Divide esta pesquisa em duas tarefas independentes: uma compara a instalação do Hermes em Linux e a outra em Windows. Usa apenas fontes oficiais, não alteres ficheiros e devolve os links. Depois junta as diferenças.
Os dois arrancam. Abres o monitor e vês o de Windows a perder tempo com WSL, quando te interessa o pacote nativo. Selecionas esse trabalhador e mandas:
Concentra-te no pacote MSIX e nos requisitos do Windows; deixa WSL de fora.
É isto o steering: uma orientação nova entrou num filho que já está a correr, sem o reiniciar e sem perder o que ele já fez. Por baixo, o agente pai usa a mesma ferramenta com que o lançou:
{"action": "list"}
{"action": "steer", "subagent_id": "sa-0-1a2b3c4d", "message": "focus on pricing instead"}
{"action": "stop", "subagent_id": "sa-0-1a2b3c4d"}
São payloads da ferramenta delegate_task, não comandos de shell. O sa-0-1a2b3c4d é ilustrativo: usa o ID do dispatch ou do list, que também devolve o objetivo, o estado, os segundos em execução e se o filho ainda aceita steering.
Parar um filho não é parar todos
x pede a paragem do selecionado; no TUI, X leva a subárvore inteira atrás. Parar um trabalhador não mexe nos irmãos que não dependem dele — se a outra investigação deixou de ser necessária, é este o caminho.
/stop é outra coisa: a paragem abrangente da sessão, que fecha as delegações em background e todos os descendentes. Cada uma volta como conclusão interrompida, com o resultado parcial que tinha. Bom para travar um fan-out que descarrilou, caro para resolver um filho perdido.
Onde isto morde
O queued do steering não significa entregue. A orientação foi aceite na fila, mas só é consumida no limite de iteração seguinte, e o que está a correr nesse momento não é cortado a meio. Se o filho terminar antes, o resultado traz pending_steer ou missed_steer, com a nota de que a orientação não chegou. Serve para repetires o pedido como follow-up, em vez de assumires que pegou.
Parar também não é desfazer. O que o filho já escreveu, apagou ou enviou para fora fica como está. Isto é um travão, não um rollback — para isso há os checkpoints.
O excerto da transcrição é um trecho recente limitado, e a atividade mostrada é observação, não percentagem de conclusão. Um filho calado há dois minutos pode estar a pensar, não morto. Abrir e fechar o monitor preserva o rascunho e o cursor.
Contexto isolado não é sistema de ficheiros isolado. Por omissão os filhos partilham o diretório de trabalho do pai — bom em pesquisa, péssimo com dois a editar o mesmo ficheiro. Para esse caso existe delegation.worktree_isolation: true, que dá a cada filho o seu worktree e o seu branch.
Delegação também não é fila durável: fechar ou reiniciar a sessão interrompe a árvore, e um restart não retoma o filho. Para o que tem de sobreviver a isso há cronjob ou processos em background.
E paralelismo não é poupança: a docs aponta dez concorrentes por omissão, cada um a gastar o seu.
Fecho
Gosto desta mudança porque não acrescenta poder ao agente: devolve-o a quem está a olhar. A única correção possível era esperar pelo resumo e recomeçar, e o custo era aceitar trabalho que não era o que tinhas pedido. Um volante a meio da viagem vale mais do que um relatório no fim.
A docs atual já vai além do primeiro pacote da v0.22.0 — o dock e o steering têm refinamentos posteriores, e é essa a versão a ler. A v0.22.2, de 15 de outubro, é a estável de agora, mas os destaques dela são outros: arranque do gateway e estabilidade de turnos locais.
Docs: Subagent Delegation · Steering a running subagent · Lifetime and durability · Release v0.22.0 · Release v0.22.2
Tags: #hermes #subagentes #delegacao #controlo