Agentes de IA com Human-in-the-Loop: o que o handoff para o navegador acerta

Agentes de IA com humano no loop precisam de dois tipos de ponto de verificação: etapas que só uma pessoa pode executar e etapas que uma pessoa deve avaliar. O que o handoff do Browse acerta e como mapeá-lo para um quadro de tarefas.

Sophia Carter

Sophia Carter

19 novembro 2026

Agentes de IA com Human-in-the-Loop: o que o handoff para o navegador acerta

Human in the loop para agentes de IA significa que o agente para em pontos definidos e espera por uma pessoa. Existem dois tipos de parada: etapas que só uma pessoa consegue executar (um login, um código 2FA, um pagamento) e etapas que uma pessoa precisa avaliar (fazer merge, publicar, enviar). Um bom handoff nomeia a etapa, mantém o agente esperando em vez de deixá-lo adivinhar e só retoma o trabalho diante de uma ação humana real.

Agentes de IA com human in the loop são fáceis de descrever e difíceis de construir bem. A maioria das equipes começa com uma única regra (“uma pessoa revisa antes do merge”) e só depois descobre as lacunas: o agente que trava em um prompt de 2FA às 2 da manhã, ou aquele que clica em uma página de pagamento porque nada disse a ele para parar.

O Browse, do OpenCode, uma ferramenta de navegador para agentes de programação, traz um design enxuto de handoff que acerta o primeiro tipo de parada. Este guia mostra o que ele faz, onde ele termina e como levar o mesmo padrão para um quadro de tarefas compartilhado no Sharkly, onde vive o segundo tipo de parada.

O que human in the loop significa para agentes de IA

Human in the loop (HITL) para agentes de IA é um design em que o agente pausa em checkpoints nomeados, entrega o controle ou uma decisão a uma pessoa e só continua depois que essa pessoa age. O checkpoint faz parte do fluxo de trabalho, não é uma exceção. O agente sabe que ele existe, a pessoa sabe que é responsável por ele e o sistema registra quem agiu.

A comunidade de segurança trata isso como um controle, não como cortesia. A entrada da OWASP sobre agência excessiva recomenda o controle human-in-the-loop “para exigir que uma pessoa aprove ações de alto impacto antes que elas sejam executadas”.

Dois tipos de checkpoint humano

Nem toda pausa é uma revisão. Misturar os dois tipos faz as configurações de HITL parecerem lentas e, ainda assim, deixarem coisas passarem.

Etapa só para uma pessoa Etapa de julgamento
Exemplos Login, prompt de 2FA, captcha, pagamento, tela de consentimento Fazer merge de um PR, publicar um post, enviar um e-mail, fechar um ticket
Por que uma pessoa O agente não tem a credencial, ou nunca deveria tê-la O agente consegue agir, mas o resultado precisa da decisão de uma pessoa
Quando acontece No meio da execução, muitas vezes de forma imprevisível No fim de uma execução, ou antes de uma ação irreversível
Quanto tempo leva Segundos De minutos a um dia
O que retoma o trabalho A pessoa conclui a etapa e então sinaliza para continuar A pessoa aprova, rejeita ou pede alterações
Linha do tempo de uma execução de tarefa: um agente pausa no meio da execução para que uma pessoa conclua uma etapa de login ou pagamento bloqueada e clique em continuar, e então pausa novamente no final para uma revisão humana antes de a tarefa ser concluída

O primeiro tipo exige velocidade e um sinal preciso. O segundo exige contexto e um registro.

O que o handoff do Browse acerta

O Browse é “um servidor MCP e uma extensão do Chromium” que permite a agentes de programação usar o seu navegador real, com as suas abas e logins. Seu repositório de código tem licença MIT. Quando o agente encontra um login, um prompt de 2FA ou um pagamento, ele devolve a aba para você e continua quando você clica em Continue.

Seis escolhas de design desse handoff valem ser copiadas:

  1. A etapa é limitada a uma aba e a um site. O cartão de handoff na página mostra a origem do site, então você sabe exatamente onde está agindo.
  2. O agente pergunta em vez de adivinhar. Após uma navegação, o Browse reporta barreiras de captcha e páginas de “acesso negado” e instrui o agente a passar as interativas para você. Segundo o README, “Ele nunca as resolve.”
  3. Só uma ação humana real retoma a execução. “Apenas um clique real no cartão ou no botão da barra de ferramentas conclui um handoff, então uma página não consegue falsificá-lo.” Uma página maliciosa não pode clicar em Continue no seu lugar.
  4. O estado é visível de relance. O selo da barra de ferramentas mostra RUN enquanto um agente trabalha e WAIT quando ele precisa de você.
  5. A pessoa pode retomar o controle a qualquer momento. Clicar no botão da barra de ferramentas enquanto um agente roda devolve a aba para você.
  6. Os limites são rotulados com honestidade. O README chama allowedOrigins e readOnly de “trilhos de proteção, não uma fronteira de dados” e diz abertamente o que eles não filtram.

O ponto 3 é o mais importante. Um handoff que uma página consegue concluir não é um checkpoint humano; é um alvo de injeção de prompt. Se você construir sua própria etapa de HITL, o sinal de retomada precisa vir de um canal que o agente e o conteúdo que ele lê não consigam alcançar. O post sobre injeção de prompt e guardrails de agentes explica por que essa fronteira se sustenta melhor do que qualquer correção do lado do modelo.

Onde um handoff dentro do navegador termina

O handoff do Browse resolve a etapa que só uma pessoa pode fazer, para uma pessoa em uma mesa. Ele não decide se o trabalho concluído deve ser entregue, e não avisa a um colega de equipe que o seu agente está bloqueado enquanto você está fora. Isso é um limite, não um defeito: a etapa de julgamento precisa de um registro compartilhado fora do navegador.

Leve o handoff para um quadro de tarefas

Um quadro de tarefas dá ao padrão de handoff um lugar para viver quando a pessoa não está na tela. No Sharkly, uma Task é o registro compartilhado para Pessoas e Agentes, e cada conversa de tarefa carrega um estado: Working, Queued, Needs your reply, Needs your review, Exception, Completed ou Aborted. Segundo a documentação de Chat with an Agent, um handoff aparece como “Needs your…” apenas para a pessoa que ele aguarda, e todo mundo vê o neutro “Needs reply” ou “Needs review”.

Os dois estados do Sharkly correspondem aos dois tipos de checkpoint:

  • Needs your reply é o handoff no meio da execução. O agente está bloqueado esperando uma entrada que só uma pessoa tem: uma decisão, uma credencial, um arquivo que falta.
  • Needs your review é a etapa de julgamento. O trabalho está pronto e aguarda aceite.

Ambos aparecem no módulo Task Chats da barra lateral, e o responsável pela conversa ainda recebe um banner na área de trabalho e uma notificação no Slack. Essa é a versão em escala de equipe do selo WAIT do Browse.

O status de workflow da tarefa é uma camada separada. De acordo com a documentação de execução de tarefas do Agent, o workflow do tipo de tarefa restringe quais status um Agente pode selecionar, e estados de execução como queued ou running não implicam um status de tarefa.

Seletor de status de tarefa do Sharkly listando o workflow Triage, Backlog, Todo, In Progress, Ready for Release, Done, Canceled e Duplicate, os status entre os quais um Agente pode mover uma tarefa

Isso te dá um terceiro checkpoint de graça. Adicione um status como Ready for Release para o qual um agente possa mover o trabalho, mas do qual não possa tirá-lo, e a última etapa passa a ser, por design, de uma pessoa.

Um agente rodando em um Computer conectado pode definir o estado de handoff por conta própria usando a CLI sharkly:

# Blocked on something only a person can do: ask, and wait
sharkly task edit COIN-142 --session-status waiting_human_reply

# Work finished: hand it back for acceptance, never mark it done
sharkly task edit COIN-142 --session-status waiting_human_review

Use um estado de resposta no meio da execução quando o agente não consegue continuar sem uma pessoa. Use o estado de revisão quando o agente poderia continuar, mas o resultado precisa do julgamento de alguém.

Como projetar os seus próprios checkpoints humanos

Cinco passos cobrem a maioria das equipes que rodam mais de um agente de programação:

  1. Liste toda etapa que só uma pessoa consegue fazer. Logins, 2FA, pagamentos, credenciais de produção, consentimento legal. O agente deve passar essas etapas para uma pessoa, nunca retê-las.
  2. Liste toda ação irreversível. Merge, deploy, publicar, enviar, excluir. Cada uma recebe um checkpoint de julgamento antes, sob a responsabilidade de uma pessoa nomeada.
  3. Escolha um único sinal de retomada por checkpoint. Um clique em um botão, uma mudança de status, uma resposta na conversa da tarefa. Ele precisa vir de uma pessoa, não de conteúdo que o agente lê.
  4. Torne a espera visível. Um selo WAIT para uma pessoa, uma linha “Needs your reply” para uma equipe. Um agente bloqueado que ninguém vê é uma indisponibilidade silenciosa.
  5. Escreva a fronteira nas instruções do agente. “Pare e pergunte em páginas de login” pertence às instruções do agente, não à memória de alguém.

O guia de portões de aprovação para agentes de programação aprofunda o passo 2, e A revisão humana é o gargalo aborda o que acontece quando as revisões se acumulam.

Erros comuns com agentes human-in-the-loop

  • Revisar tudo. Se toda ação precisa de aprovação, as pessoas aprovam sem ler. Reserve os checkpoints para etapas irreversíveis ou que exigem uma credencial.
  • Deixar o agente resolver o portão. Um agente que preenche um captcha ou repete um prompt de 2FA transformou um checkpoint em uma pista de obstáculos.
  • Sinais de retomada dentro do conteúdo. Se uma página web, um e-mail ou um arquivo pode dizer “aprovado”, uma injeção de prompt também pode.
  • Sem responsável. “Alguém vai revisar” significa ninguém. Cada checkpoint precisa de uma pessoa nomeada.

Conclusão

Human in the loop funciona quando o loop tem duas portas claramente diferentes: uma para etapas que só uma pessoa consegue fazer, outra para decisões que uma pessoa deve tomar. O handoff do Browse mostra a primeira porta bem feita: escopo definido, visível e retomável apenas por um clique real. Um quadro compartilhado carrega a segunda porta e torna as duas visíveis para a equipe.

Se os seus agentes já trabalham entre navegadores e repositórios, coloque os handoffs deles onde a sua equipe possa vê-los. Comece com o Sharkly, atribua uma tarefa a um Agente e observe com que frequência ela cai em Needs your reply antes de adicionar mais portões. Para o lado agente-a-agente do mesmo problema, leia handoffs de agentes de IA.

Perguntas frequentes

O que é human in the loop em agentes de IA?

É um fluxo de trabalho em que um agente pausa em pontos definidos e espera que uma pessoa aja ou decida antes de continuar. Os pontos são planejados com antecedência, têm pessoas nomeadas como responsáveis e só são retomados por um sinal humano.

Quando um agente de IA deve devolver o controle a uma pessoa?

Em qualquer etapa que exija uma credencial que o agente não deveria ter (login, 2FA, pagamento) e antes de qualquer ação irreversível (merge, deploy, publicar, enviar). Todo o resto normalmente pode rodar sem parada.

Um agente de IA pode resolver captchas ou prompts de 2FA sozinho?

Não deveria. O Browse, por exemplo, reporta barreiras de captcha e instrui o agente a passar as interativas para o usuário, e seu README afirma que ele nunca as resolve. Trate essas situações como etapas que só uma pessoa pode fazer.

Qual é a diferença entre um handoff e um portão de aprovação?

Um handoff acontece no meio da execução: o agente não consegue continuar até que uma pessoa faça algo. Um portão de aprovação fica antes de um resultado: o agente poderia continuar, mas uma pessoa decide se ele deve.

Como impedir que uma página web falsifique uma aprovação humana?

Tire o sinal de retomada do alcance do conteúdo. O Browse aceita apenas um clique real no seu cartão ou no botão da barra de ferramentas. Em um quadro, use uma mudança de status ou uma resposta da conta de uma pessoa.

Explore mais

Gemini 4 Neon Orchestrator: combine com subagentes Hydrogen

Gemini 4 Neon Orchestrator: combine com subagentes Hydrogen

Como executar um orquestrador Gemini 4 Neon sobre subagentes Hydrogen: o contrato de subtarefas que ele gera, o dimensionamento do fan-out, o cálculo de custo por execução em comparação com o Carbon e as regras de falha.

19 novembro 2026

SDLC Agêntico: os cinco componentes essenciais (Board, Agents, Review Gate)

SDLC Agêntico: os cinco componentes essenciais (Board, Agents, Review Gate)

O que um SDLC agêntico precisa na prática: um quadro compartilhado, agentes atribuíveis, um agente revisor separado, um caminho de devolução e um humano responsável pelo envio final. O ciclo, passo a passo.

18 novembro 2026

Claude Fable 5.2: Como Avaliar Agentes na Sua Própria Base de Código

Claude Fable 5.2: Como Avaliar Agentes na Sua Própria Base de Código

Avalie o Claude Fable 5.2 na sua base de código com tarefas controladas, testes de aceitação, esforço de revisão, tempo decorrido e custo por alteração aceita.

12 novembro 2026