Documentação

Agentes e permissões

O botão Agentes, no canto superior direito, abre a seção Agentes das Configurações, onde você define quanto os próximos agentes podem fazer sozinhos e se eles podem dividir o trabalho com ajudantes.

Onde fica e quando vale#

Clique em Agentes, no topo (ou abra as Configurações com ⚙ ou Ctrl+, (⌘, no Mac) e clique em Agentes). A página tem duas escolhas, Permissões e Delegação, e o teto para novos ajudantes. A tabela de quem faz cada tarefa está na seção vizinha, Quem faz cada tarefa, explicada em O líder escolhe a IA. Tudo é salvo na hora.

A escolha vale para os próximos agentes que você abrir, do Claude ou de outra IA. Os painéis que já estão abertos mantêm as permissões e as ferramentas com que começaram até serem reiniciados.

A exceção é a confirmação do app antes de abrir um ajudante: ela segue sempre o modo de delegação atual. Se você muda para Perguntar antes, o app passa a pedir o seu ok também para os ajudantes que agentes já abertos quiserem criar.

Permissões#

Perguntar tudo

O agente pede a sua aprovação para editar arquivos e para rodar comandos.

Aceitar edições

Edita arquivos sozinho e pergunta antes de rodar comandos. É o padrão e o recomendado.

Automático

O Claude decide o que precisa da sua aprovação.

Liberado (sem perguntas)

Faz tudo sem perguntar, inclusive apagar arquivos. Use só em pastas de teste.

Quando um agente pede permissão, o painel mostra precisa de você. Clique no painel e responda ali mesmo.

As outras IAs recebem a escolha traduzida para as opções que cada uma oferece.

Delegação#

Delegar é o agente abrir ajudantes para fazer partes do trabalho em paralelo.

Automática

O agente abre ajudantes quando o trabalho se divide bem em partes independentes, como páginas diferentes de um site. Tarefas pequenas ele faz sozinho. É o padrão.

Só quando eu pedir

Só abre ajudantes se você mandar.

Perguntar antes

O agente diz o que vai dividir e o app pede o seu ok antes de cada ajudante.

Desligada

Nunca abre ajudantes.

Fora do modo Automática, o Claude e o Codex também deixam de usar os subagentes internos deles, que trabalham escondidos: todo ajudante aparece num painel que você vê.

Perguntar antes#

Quando um agente quer abrir um ajudante, aparece a janela Abrir um ajudante? com quem está pedindo, o nome do ajudante, a IA escolhida e a tarefa.

• Permitir abre o ajudante.
• Recusar (ele faz sozinho) faz o agente seguir sem ele.

Se ninguém responder em 10 minutos, o pedido conta como recusado. Pedidos que chegam juntos entram numa fila e aparecem um de cada vez.

Quando o app pergunta mesmo na delegação automática#

• A IA escolhida para o ajudante já usou 70% ou mais do limite de 5 horas.
• Já há 3 ou mais ajudantes abertos na missão.

E o app não deixa abrir quando a IA está sem uso, quando o uso passou do teto que você escolheu ou quando a missão já tem 8 painéis. Veja Limite de uso e fila.

O que são ajudantes#

Um ajudante é um agente aberto por outro agente, o líder, para fazer uma parte do trabalho. Ele não vê a conversa do líder: recebe uma tarefa completa, com o contexto, os arquivos e o que conta como pronto.

1. O líder abre o ajudante. O painel dele aparece com aberto por e o nome do líder.
2. O ajudante trabalha no próprio painel. Você acompanha ao vivo e pode escrever nele como em qualquer outro.
3. Ao terminar, ele confere o resultado e devolve um resumo ao líder. O painel ganha a etiqueta entregou.
4. O líder confere, junta o trabalho ao projeto e fecha o painel do ajudante.

Cópias isoladas (worktrees)#

Em projetos com git, cada ajudante trabalha numa cópia isolada do projeto (um worktree do git), com um ramo próprio chamado towerctl/ seguido de um código. Com a cópia isolada, o ajudante edita a própria cópia e não esbarra nos arquivos que o líder ou outro ajudante estão mexendo.

O isolamento é o padrão, mas não é obrigatório. Sem ele, o ajudante trabalha na mesma pasta do líder, e o líder precisa evitar que dois agentes editem os mesmos arquivos ao mesmo tempo. É o caso de tarefas só de leitura e dos revisores: quem revisa um ajudante lê a pasta dele, e o revisor antes de publicar lê a pasta do projeto.

• A cópia nasce do estado atual do líder. O que ainda não estava salvo no git é gravado antes, como um ponto de restauração.
• As cópias ficam em .towerctl/worktrees, dentro do projeto. O app deixa a pasta .towerctl fora do git.
• As mudanças do ajudante só chegam ao projeto quando são juntadas.

Sem git, o ajudante trabalha na mesma pasta do líder, que é orientado a não dar os mesmos arquivos para dois agentes. Num repositório ainda sem nenhum commit, o app primeiro grava um ponto de restauração com os arquivos que existem; só se o repositório continuar sem commits (por exemplo, numa pasta vazia) o ajudante divide a pasta com o líder.

Juntar o trabalho#

Normalmente o líder junta sozinho o trabalho de cada ajudante. Antes, o app grava o que estiver pendente dos dois lados. Se houver conflito, nada é alterado e o líder recebe a lista dos arquivos em conflito.

Você também pode juntar ou descartar à mão, pelo botão Revisar do ajudante. Veja Revisar e desfazer.

No perfil Máxima qualidade, o líder é orientado a pedir a revisão de cada ajudante a outra IA (ou outro modelo) e a corrigir o que ela achar antes de juntar. Quando é o agente que junta, o app só aceita depois que uma revisão foi registrada. Você continua podendo juntar à mão, pelo Revisar.