O que é aprovação humana
Aprovação humana é a etapa que interrompe a execução de um agente de IA até você autorizar ou recusar a ação. O agente prepara a chamada, apresenta o que pretende fazer e espera a resposta antes de continuar.
A pausa desloca o controle para você, que responde pelo efeito. O agente pode consultar, calcular e redigir, mas a ação com consequência externa depende de confirmação.
Onde a pausa faz diferença
A aprovação importa quando a ação altera algo fora do ambiente de teste. Enviar uma mensagem ao cliente e emitir uma cobrança são exemplos de ações que merecem confirmação. Apagar um registro ou conceder acesso também exige confirmação.
Em um workflow, a etapa pode aparecer como uma condição que suspende o fluxo. No n8n, a documentação de ferramentas com aprovação humana mostra como uma ação configurada para revisão fica disponível para aprovação ou recusa.
O que a tela precisa mostrar
A tela de aprovação precisa exibir a ação, os parâmetros e o efeito previsto. Um texto genérico como “continuar” não permite avaliar o que será feito. O nome do cliente e o valor aparecem junto do destinatário e do registro afetado. Esses campos ajudam a conferir a execução.
O uso de tool calling torna essa apresentação possível, porque a chamada tem nome e parâmetros definidos. Você lê o que o agente escolheu executar, e não só a intenção descrita em linguagem natural.
O que a aprovação não garante
A pausa não comprova que a escolha está certa. A aprovação pode acontecer sem leitura, com informação desatualizada ou com pressa. O controle depende da clareza da tela e do tempo disponível para conferir.
Também não basta registrar que houve aprovação. Guarde o identificador do aprovador, o conteúdo exibido e o horário. Sem esse registro, a revisão posterior não consegue reconstruir o que foi apresentado.
Como testar o fluxo
Prepare uma ação que exija aprovação e execute o caminho completo. Verifique onde o agente para, a exibição dos parâmetros e o efeito da recusa. Repita com uma aprovação para confirmar a retomada.
A autonomia de agente descreve o grau de liberdade de cada etapa. Para revisar um fluxo com agentes e definir onde a confirmação deve entrar, o Desenvolvimento Colaborativo da Dev Side Studio permite examinar a configuração durante a sessão.
Dúvidas frequentes
Perguntas frequentes sobre Aprovação humana
- Aprovação humana é o mesmo que revisar o resultado depois?
- Não. A revisão posterior examina o que já aconteceu. A aprovação acontece antes da ação, quando ainda é possível recusar a execução.
- Toda ação do agente precisa de aprovação?
- Não. Reserve a pausa para ações com efeito externo, como envio de mensagem e cobrança. Excluir registro ou alterar permissão também exige confirmação. Consultas de leitura podem seguir sem interrupção.
- Aprovar sem ler resolve?
- Não. A pausa só tem efeito quando a tela mostra o que será executado. A exibição precisa trazer a ação, os parâmetros e o efeito previsto.
- Como testar se a pausa funciona?
- Configure uma ação que exija aprovação e acompanhe o fluxo completo. Observe o momento da parada e a exibição dos parâmetros. Depois, confirme a retomada com uma aprovação e o encerramento com uma recusa.
Para continuar
Recursos relacionados
Documentação
n8n: ferramentas com aprovação humana
Descreve a pausa de uma ação para aprovação ou recusa durante a execução.
Abrir recursoDocumentação
LangGraph: human-in-the-loop
Apresenta a interrupção do grafo para revisão e retomada com a resposta da pessoa.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A aprovação humana define quando o agente pode executar uma ação durante o desenvolvimento assistido.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.