Fechar o ciclo de revisão do agente
Acompanhe o que o agente mudou, verifique como humano e reabra somente quando outra correção for necessária.
6 minNeste guia
Retorno do agente
Um agente pode reportar cada pin como alterado, bloqueado, não aplicável ou não localizado, com resumo, motivo, arquivos alterados, commit e pull request. Repetir a mesma entrega com a mesma chave de idempotência é seguro; conteúdo divergente nessa chave é rejeitado.
Verificação humana
Um resultado alterado move um pin aberto ou reaberto para pronto para aceitar. Somente uma pessoa pode aceitar a correção ou reabrir um pin aceito. Agentes não aceitam o próprio trabalho e transições inválidas são rejeitadas.
- Fluxo normal: aberto → pronto para aceitar → aceito.
- Se a verificação falhar: aceito → reaberto → pronto para aceitar.
Registrar uma execução e aceitá-la como humano
Um agente relata o trabalho contra o captureId da captura e cada pinId. Repita uma entrega com a mesma chave só quando o resultado não mudou; um resumo, arquivos ou status diferentes precisam de uma chave nova. Pins ou capturas desconhecidos são rejeitados sem ecoar comentários privados.
Uma pessoa aceita uma correção ou reabre um pin aceito pela interface de revisão. Agentes não aceitam o próprio trabalho. Depois de uma reabertura humana, a nova tentativa prevista é um segundo resultado alterado. Deixe as métricas anônimas do ciclo desligadas até optar por elas.
- Publique um resultado alterado para o mesmo
captureIdepinIde confirme no visualizador que o pin está pronto para aceitar. - Reutilize uma chave de entrega só quando o resultado for idêntico; gere uma chave nova quando os arquivos, o resumo ou o status realmente mudarem.
- Se a verificação falhar, reabra como humano, publique um segundo resultado, aceite de novo e guarde os ids de captura anterior e posterior.