Agentes de código são bons em trabalho longo, bem definido e tedioso: adicionar testes a cinquenta módulos, migrar todas as chamadas para uma nova API, corrigir mil avisos de lint. Esse tipo de trabalho não precisa de você assistindo. Precisa de um lugar seguro para rodar, de uma tarefa clara, de proteções contra travamentos e de um jeito de revisar o resultado tomando um café.
Este é um checklist para montar isso.
1. Como colocar em sandbox um agente sem supervisão?
Um agente sem supervisão roda comandos de shell que ninguém aprova. Parta do princípio de que, em algum momento, ele vai rodar algo que você não rodaria: apagar o diretório errado, instalar um pacote, fazer push para um remoto. Contenha o agente.
- Um contêiner ou VM, não a conta de usuário principal do seu notebook. A documentação de segurança do Docker cobre os controles; no mínimo, rode como usuário não root e remova as capabilities de que não precisa.
- Monte só o repositório. Nada de diretório home, chaves SSH, credenciais de nuvem ou um
~/.configcheio de tokens. - Nenhum segredo de produção. Use bancos de teste e chaves de API fictícias. Se o agente precisar de um serviço real, dê a ele uma chave com escopo limitado e revogável.
- Limite a rede. O agente precisa da API do modelo e talvez de um registro de pacotes. Raramente precisa de mais alguma coisa.
- Sem permissão de push. Deixe-o fazer commits localmente. Você faz o push depois de revisar.
A chave de API do modelo é a única credencial que o agente precisa ter. Use uma chave criada para esse fim e, se o provedor permitir, restrinja-a ao IP de saída da sandbox. As chaves da BroadNet aceitam allow-lists de IP com até 32 entradas, então uma chave vazada não serve para nada fora dali.
2. Por que dar a cada agente o próprio branch?
Trabalhe em um branch dedicado, nunca no main. Se você roda mais de um agente, dê a cada um seu próprio diretório de trabalho com git worktree:
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
Cada worktree é um checkout separado do mesmo repositório, então os agentes não sobrescrevem os arquivos uns dos outros, e cada branch mostra exatamente o que um agente fez.
Depois, faça um commit a cada passo concluído. O Aider faz isso por padrão. Para outros agentes, coloque isso nas instruções ou envolva o loop para que um commit aconteça sempre que os testes passarem. Um histórico de commits pequenos transforma “o agente quebrou alguma coisa às 3 da manhã” em “o commit 14 quebrou; fique com do 1 ao 13”.
3. O que vai no arquivo de tarefa?
Um prompt de uma linha que funciona de forma interativa falha de madrugada, porque não há ninguém para responder à primeira pergunta do agente. Escreva um arquivo de tarefa:
# Task: add unit tests to src/billing/
## Goal
Every public function in src/billing/ has at least one unit test.
## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit
## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.
## Notes
Append decisions and skipped items to NOTES.md as you go.
A seção “done when” é a parte importante. Ela dá ao agente um jeito de saber que terminou e dá a você um jeito de conferir. O arquivo de notas também serve de memória se a execução reiniciar ou se o contexto for compactado; veja gestão de contexto para agentes de longa duração.
4. Que proteções param um agente travado?
Sem supervisão significa que ninguém percebe um agente travado até de manhã. Quatro proteções:
- Limite de passos. Um número máximo fixo de chamadas ao modelo por tarefa.
- Horário de parada. Pare em um horário definido, por exemplo 07:00, qualquer que seja o estado.
- Detecção de repetição. Pare quando a mesma chamada de ferramenta devolver o mesmo resultado três vezes, ou quando nenhum arquivo mudar por um número definido de passos.
- Timeouts por ferramenta. Uma suíte de testes travada não deve travar a noite.
Quando uma proteção dispara, o agente deve escrever o motivo no arquivo de notas e sair de forma limpa. Por que limites de passos e de novas tentativas importam para o custo é explicado em limite os passos por tarefa, no guia de custos de agentes de código.
O Aider é fácil de rodar assim: a documentação de scripting mostra a opção --message para executar uma instrução e sair, e --yes-always para aceitar as confirmações automaticamente. Coloque isso em um loop de shell sobre uma lista de tarefas, com timeout em volta de cada execução, e você tem uma fila noturna simples.
5. De madrugada, sai mais barato uma sessão de plano ou cobrança por token?
Execuções noturnas mudam a pergunta sobre custo. Ninguém está olhando o medidor, e um agente travado pode ficar em loop por horas.
Em uma chave cobrada por token, o custo depende de quanto o agente envia. Agentes reenviam o contexto a cada passo, então uma execução de oito horas pesa. O cache de prompt ajuda muito (a entrada em cache no DeepSeek V4.1 Flash custa $0.0055 por 1M de tokens, contra $0.175 para entrada nova), mas tokens de saída e de raciocínio são cobrados integralmente. Você precisa de um orçamento de tokens por execução e de um limite de gasto na conta.
Em uma sessão de plano, não há medidor de tokens. Uma sessão Full Moon custa $60 por mês para DeepSeek V4.1 Flash ilimitado, e esse é o teto, por mais que o agente rode ou fique em loop. Para trabalho noturno, essa é a principal vantagem: a conta no pior caso é conhecida antes de você ir dormir.
| Chave por token | Sessão de plano | |
|---|---|---|
| Custo no pior caso de uma noite travada | Cresce com os tokens | Fixo no preço do plano |
| Agentes em paralelo | Até 4 requisições simultâneas por chave de pagamento por uso | Uma requisição por vez por sessão |
| Modelos | Todos os modelos de chat | Só DeepSeek V4.1 Flash |
| Proteções ainda necessárias | Sim, para custo e tempo | Sim, para tempo |
Duas observações práticas sobre sessões. Uma sessão roda uma requisição por vez, então dois agentes dividindo uma sessão se revezam; tarefas em uma sessão rodam em sequência, o que de madrugada muitas vezes não é problema. Se você quer agentes rodando lado a lado, compre uma sessão por agente. Agentes em paralelo em uma API de preço fixo faz as contas.
Na velocidade típica de cerca de 100 tokens por segundo, uma sessão pode produzir cerca de 259 milhões de tokens de saída em um mês de uso contínuo. Se isso sai melhor que o preço por token para você depende do volume; o exemplo da BroadNet de um agente de código em tempo integral dá cerca de $65.40 por mês no pagamento por uso. Faça suas contas na calculadora de preço fixo vs. por token. Execuções longas sem supervisão também exigem disciplina de contexto e novas tentativas que sobrevivam a uma queda: veja timeouts, novas tentativas e checkpoints.
6. Como revisar a execução de manhã?
O valor de uma execução noturna só aparece na hora da revisão. Faça-a ser rápida:
- Leia primeiro o NOTES.md. O que o agente terminou, pulou e onde travou?
- Confira o motivo da parada. Concluído, limite de passos, horário de parada ou repetição?
- Rode os testes você mesmo. Não confie no relato do agente de que os testes passaram.
- Leia o diff por commit. Commits pequenos facilitam achar e descartar mudanças ruins.
- Faça squash ou rebase do que você mantiver e abra um pull request normal.
Na maioria das manhãs você vai manter quase todo o trabalho e corrigir alguns commits à mão. Nas manhãs ruins, você apaga um branch. De qualquer forma, nada tocou o main sem você.
Como testar com segurança na primeira noite?
Comece com uma tarefa bem especificada, um agente e uma sessão. Uma hora do Meteor ($1) basta para conferir se a sandbox, o branch e as proteções funcionam antes de deixar algo rodando a noite toda. Para o agente em si, o guia do Aider traz as configurações exatas de conexão, o melhor modelo aberto para agentes de código ajuda a escolher o modelo e como funcionam as sessões de plano explica chaves e sessões.
