Pular para o conteúdo

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

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.

Tipos de loop de um agente de código: o que dispara e quando para
Tipo de loopO que disparaQuando para
Por turnoO ciclo de uma tarefa pedidaUma pessoa envia o pedidoO agente conclui ou precisa de mais contexto
Por objetivoO agente insiste até cumprir uma metaUma meta verificável, como o /goal do Claude CodeA meta é cumprida ou acaba o número de tentativas
Por tempoA mesma tarefa em intervalosUm intervalo ou uma agenda, como /loop e /scheduleO trabalho termina ou alguém cancela
ProativoO agente reage a eventos, sem ninguém acompanhandoUm evento ou uma agenda, rodando na nuvemA 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

Conte o seu desafio

Conte o contexto: o problema, o prazo e o que já existe. Você fala direto com quem vai fazer o trabalho.

Pedir conversa inicial

Conversa inicial gratuita · Resposta em até 1 dia útil