Cerrar el ciclo de revisión del agente
Sigue lo que cambió un agente, verifícalo como humano y reabre solo cuando haga falta otra corrección.
6 minEn esta guía
Retorno del agente
Un agente puede informar cada pin como changed, blocked, not applicable o not located, con un resumen, un motivo, archivos cambiados, commit y pull request. Una entrega repetida con la misma clave de idempotencia es segura; el contenido conflictivo bajo esa clave se rechaza.
Verificación humana
Un resultado changed pasa un pin open o reopened a listo para corrección. Solo un humano puede aceptar una corrección o reabrir un pin aceptado. Los agentes no pueden aceptar su propio trabajo, y las transiciones de estado no válidas se rechazan.
- Flujo normal: abierto → listo para corrección → aceptado.
- Si la verificación falla: aceptado → reabierto → listo para corrección.
Registrar una ejecución y aceptarla como humano
Un agente informa el trabajo contra el captureId de la captura y cada pinId. Repite una entrega con la misma clave solo cuando el resultado no ha cambiado; un resumen, archivos o estado distintos necesitan una clave nueva. Los pins o capturas desconocidos se rechazan sin devolver comentarios privados.
Una persona acepta una corrección o reabre un pin aceptado desde la interfaz de revisión. Los agentes no pueden aceptar su propio trabajo. Tras una reapertura humana, el reintento previsto es un segundo resultado changed. Deja las métricas anónimas de ciclo desactivadas salvo que te unas.
- Publica un resultado changed para el mismo
captureIdypinId, y confirma que el visor muestra el pin como listo para aceptar. - Reutiliza una clave de entrega solo cuando el resultado es idéntico; genera una clave nueva cuando los archivos, el resumen o el estado hayan cambiado de verdad.
- Si la verificación falla, reabre como humano, publica un segundo resultado, acepta de nuevo y conserva los capture ids anterior y posterior.