Pinar
InícioPlanosNovidadesAjuda
Entrar
⌘ K

Comece aquiCapturas e pinsAgentes de IAProjetos e coleçõesNuvem e planosPrivacidade e dados
Comece aqui
Capturas e pins
Agentes de IA
Enviar contexto visual a um agenteFormatos e destinos da entregaFechar o ciclo de revisão do agenteReabrir e realocar pinsResolver avisos de cópia e entrega
Projetos e coleções
Nuvem e planos
Privacidade e dados
Ajuda/Agentes de IA

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 min
Exemplo visual: A visão em tabela combina busca com filtros de status de Revisão para varrer pins abertos, aceitos e reabertos entre sessões.

Neste guia

  1. 1Retorno do agente
  2. 2Verificação humana
  3. 3Registrar uma execução e aceitá-la como humano
1

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.

2

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.
3

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 captureId e pinId e 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.
Ainda precisa de contexto?Ver todos da categoria

Neste artigo

Retorno do agenteVerificação humanaRegistrar uma execução e aceitá-la como humano
Apoie o desenvolvimento Fair Source

Prefere apoiar diretamente o desenvolvimento com código público? Patrocine no GitHub ou pague um café.

Pague um caféApoiar no GitHub
Pinar·© 2026·Pinar v0.3.6
Termos de ServiçoPolítica de Privacidade