IA & automação · Guia
O que é loop engineering e quando deixar um agente de IA em loop
Loop engineering é o desenho dos ciclos em que um agente de IA trabalha sozinho até cumprir uma condição de parada: o que dispara o loop, como o agente verifica o próprio resultado, quando ele para e quanto pode gastar. É um termo informal, que se espalhou em meados de 2026 entre usuários de agentes de código.
Master TimmAtualizado em 6 min de leitura
Nesta página
De onde veio o termo, e por que ele ainda é informal
O nome apareceu em junho de 2026, entre usuários de agentes de código. Em 7 de junho, Addy Osmani publicou um texto que define loop engineering como deixar de ser a pessoa que dá o próximo comando ao agente e passar a desenhar o sistema que faz isso, e credita a mudança a falas de Peter Steinberger e Boris Cherny.
No fim do mesmo mês, o blog do Claude, da Anthropic, abriu um guia de loops dizendo que se fala muito em loop engineering, ou em desenhar loops em vez de escrever prompts, e definiu loops como agentes que repetem ciclos de trabalho até cumprir uma condição de parada.
Não há definição oficial, e o termo se sobrepõe a outros: Osmani coloca o loop um andar acima do harness, e a LangChain trata loop engineering como uma versão simples de um grafo. O que vale levar é a prática por trás do nome.
O loop dentro do agente e os loops em volta dele
Todo agente já roda um loop interno: reúne contexto, age com uma ferramenta, verifica o resultado e repete até não ter mais o que fazer. No Claude Agent SDK, cada volta é um turno, e o loop termina quando o modelo responde sem pedir ferramenta. Loop engineering trata sobretudo dos loops de fora, que decidem quando esse ciclo começa de novo.
| Tipo de loop | O que dispara | Quando para |
|---|---|---|
| Por turnoO ciclo de uma tarefa pedida | Uma pessoa envia o pedido | O agente conclui ou precisa de mais contexto |
| Por objetivoO agente insiste até cumprir uma meta | Uma meta verificável, como o /goal do Claude Code | A meta é cumprida ou acaba o número de tentativas |
| Por tempoA mesma tarefa em intervalos | Um intervalo ou uma agenda, como /loop e /schedule | O trabalho termina ou alguém cancela |
| ProativoO agente reage a eventos, sem ninguém acompanhando | Um evento ou uma agenda, rodando na nuvem | A tarefa termina ou atinge o limite definido |
No /goal, a cada vez que o agente tenta parar, outro modelo confere a condição e o devolve ao trabalho até a meta ser cumprida ou o número de turnos definido acabar.
O que um loop bem desenhado precisa ter
Um loop sem critério de sucesso para cedo demais ou não para. Os textos que espalharam o termo concordam em poucas peças.
- Meta verificável: O que é pronto, dito de forma que um teste ou um avaliador consiga conferir, como uma suíte verde ou uma nota mínima de Lighthouse.
- Verificação automatizada: Testes, linters e os passos de conferência manual escritos como skill, para o agente checar o próprio trabalho de ponta a ponta.
- Condição de parada e teto: Número máximo de turnos e orçamento de custo por execução.
- Isolamento: Cada execução em seu próprio git worktree, para dois agentes não mexerem nos mesmos arquivos.
- Estado fora da conversa: Um arquivo de progresso ou um quadro de tarefas que a próxima execução lê ao começar.
- Saída revisável: O resultado termina em um pull request ou em um relatório, nunca direto em produção.
O Zorbit, produto próprio da Master Timm, segue esse desenho para agentes de código: agenda execuções por cron ou em DAG, roda cada tarefa em um git worktree até o pull request e audita o custo e os tokens de cada execução.
Quando usar loops na empresa, e quando não usar
Loops rendem quando o trabalho se repete e uma máquina consegue conferir o resultado. Sem essas duas condições, um loop só automatiza a incerteza.
- Bons candidatos: Corrigir testes até a suíte passar, atualizar dependências com o CI verde, fazer a triagem diária de issues, perseguir uma meta de desempenho com número definido.
- Maus candidatos: Tarefas sem critério de acerto, decisões de produto, mudanças que dependem de alguém do negócio.
- Tarefas pequenas: Um pedido simples não precisa de loop nem de vários agentes; em alguns casos, um modelo menor e mais barato resolve.
- Ações com efeito fora do repositório: Pagamento, e-mail para cliente ou alteração em produção pedem aprovação humana dentro do loop, não depois.
Fora do código, o mesmo desenho aparece em agentes de IA autônomos com tarefas agendadas, como OpenClaw e Hermes Agent, que configuramos com permissões, canais e memória sob controle.
Riscos de deixar um agente em loop
Osmani resume o problema em uma frase: um loop que roda sem supervisão também erra sem supervisão. Os riscos são conhecidos, e os controles também.
- Custo: Cada volta consome tokens, e um loop longo ou frequente demais multiplica a conta; o intervalo deve seguir a frequência com que o dado muda, e um orçamento por execução encerra o loop no limite.
- Vitória declarada cedo: Com verificação fraca, o agente dá a tarefa por concluída sem que ela esteja; a meta precisa de um teste que possa falhar de verdade.
- Código que ninguém leu: Quanto mais rápido o loop entrega, maior a distância entre o que está no repositório e o que o time entende; a revisão humana do pull request continua obrigatória.
- Permissões amplas sem ninguém olhando: Um loop autônomo roda com o mínimo de acesso, sem segredos de produção e com comandos liberados por lista.
Serviço relacionado
Automação de software com IA
Agentes de código no seu time, com specs e quality gates.
Conversa inicial gratuita · Resposta em até 1 dia útil
Veja também: Engenharia de IA & LLM e Automação de processos com IA.
Perguntas frequentes
Qual a diferença entre um loop de agente e um cron job?
Um cron job roda sempre o mesmo script; um loop de agente roda um modelo que decide os passos a cada volta e confere o resultado antes de parar. O cron pode ser o gatilho de um loop por tempo, mas o que acontece dentro de cada execução muda conforme o que o agente encontra.
Loop engineering substitui harness engineering?
Não: o loop roda dentro de um harness. O harness define o que o agente pode fazer e como um erro é barrado; o loop define quando ele trabalha, por quanto tempo e quando para. Um loop sobre um harness fraco só repete erros mais depressa.
Como impedir que um loop gaste demais?
Com teto explícito em toda execução: número máximo de turnos e orçamento de custo. No Claude Agent SDK, os limites max_turns e max_budget_usd encerram o loop com um resultado de erro identificável, e os traces mostram tokens e custo de cada volta para ajustar o intervalo e o modelo.
Um loop pode rodar sem nenhuma revisão humana?
Pode rodar sem alguém acompanhando, mas o resultado não deve chegar à produção sem revisão. O desenho seguro deixa o agente trabalhar sozinho até o pull request ou o relatório e reserva para uma pessoa a decisão de aceitar, junto com qualquer ação que saia do repositório.
Fontes
Master Timm · Atualizado em