O que é human-in-the-loop?
Human-in-the-loop significa que um sistema de IA automatizado pausa nas etapas críticas e espera uma pessoa aprovar, corrigir ou decidir. Em agentes de código, isso geralmente aparece como pedidos de permissão antes de editar arquivos, rodar comandos ou publicar qualquer coisa.
Como isso aparece em agentes de código
A maioria dos agentes pergunta antes de ações arriscadas, como editar um arquivo, rodar um comando de shell ou buscar algo na rede. No Claude Code, regras de permissão (allow, ask, deny) e modos de permissão controlam isso; no plan mode, por exemplo, o agente só planeja e não altera arquivos. O Codex tem suas próprias configurações de aprovação e sandbox.
Onde a aprovação é obrigatória
Em vez de pedir aprovação para tudo, coloque as aprovações onde os erros saem caros.
- Ações irreversíveis: git push, publicação, exclusão de dados, migrations.
- Ações que alcançam o mundo externo: e-mail, pagamentos, servidores de produção.
- Acesso a segredos: arquivos .env, chaves, dados de clientes.
- O plano: aprová-lo antes de uma grande mudança poupa horas indo na direção errada.
Fadiga de aprovação
Quando cada leitura de arquivo exige um clique, as pessoas começam a dizer sim sem olhar, e a aprovação deixa de significar alguma coisa. A solução é aprovar automaticamente o trabalho seguro, como leituras e testes, e sempre perguntar sobre as ações realmente arriscadas. Opções que pulam todas as permissões, como a flag --dangerously-skip-permissions do Claude Code, só cabem em ambientes isolados.
Aprovando a distância
Em trabalhos longos, os agentes podem pedir aprovação enquanto você está longe. Notificações e aprovar pelo celular evitam que um agente fique parado por horas, e ver todos os agentes em espera em uma só fila acelera as coisas quando você roda muitos ao mesmo tempo.
Aprovação humana no AgentVera
O AgentVera reúne as aprovações em um só lugar e garante que só cheguem até você as que importam.
- Fila de aprovação: a barra de status conta os agentes esperando aprovação e ⇧⌘A pula para o que está esperando há mais tempo; também há notificações na área de trabalho e um selo no Dock.
- Telegram: aprove ou rejeite etapas de flows pelo celular.
- A aprovação automática responde sem perguntar aos pedidos de leitura, teste, lint e git somente leitura do Claude Code, enquanto comandos como git push, rm e git reset --hard sempre chegam até você (Pro e Team).
- O nó Human approval nos flows e a aprovação do plano de uma equipe paralela iniciada pelo Telegram seguram o trabalho até você aprovar.
- Notificações e aprovaçõesAgentes esperando aprovação em uma só fila; notificações no desktop, badge no Dock e Telegram.
- Aprovação automáticaAprove os pedidos seguros do Claude Code sem perguntar; os arriscados continuam chegando até você.
- FluxosConecte agentes em um canvas; quando um termina, a resposta dele vai para o próximo.
Perguntas frequentes
Devo deixar um agente fazer tudo sem aprovação?
Geralmente não. Aprovar automaticamente o trabalho seguro e reversível faz sentido; pushes, exclusões e tudo o que mexe com produção devem passar por você.
O que é fadiga de aprovação?
É quando os pedidos chegam com tanta frequência que as pessoas aprovam sem ler. Automatizar os seguros faz com que as aprovações restantes recebam atenção de verdade.
Qual a diferença entre human-in-the-loop e human-on-the-loop?
No primeiro, o sistema para nas etapas críticas e espera aprovação. No segundo, o sistema roda sozinho enquanto uma pessoa acompanha e intervém se for preciso.